This is a big time early work. We are posting at this early stage as we could not find anything that met our needs. It is here STRICTLY for review and we HIGHLY advise not to use this ANYWHERE NEAR PRODUCTION.
We are very interested in thoughts or comments though.
Intentions are great things. Well, we INTEND to actively add to this as we are building out a large kubernetes stack and this (for now) is our boilerplate for the services. Stay tuned for rapid updates.
The initial requirements were:
- Node.js based
- Initial rest based API for external access (if needed)
- gRPC for inter services communications.
- GraphQL for API enhancements. (Planned)
Git clone this repo onto your local drive. yarn or npm install.
- Node > 7
- NPM or Yarn
- Nodemon if desired (change package.json script if not)
No tests currently. Stay tuned.
There are examples. See the API section and the gRPC section.
This is being designed and meant for kubernetes clusters. We will be adding detailed documentation for running on docker and kubernetes.
The code should be pretty easy to follow. The gRPC is under the grpc folder and the restify api server is under the api server.
We have built a gRPC client example in the /examples/grpc folder. The code is self-explanatory we hope. Works in conjuntions with the grpcServer in the /grpc folder.
node client list
node client add
node client insert 1 Bob [email protected]
node client get 123
node client delete 1
node client watch # Run in seperate terminal will push new users to screen
There are two current API endpoints:
A basic health check
curl http://0.0.0.0:7007/health
Get the base.proto file for client gRPC creating (We are wondering why the proto file is not loadd dynamically from the server, but hey we are new to this also).
curl http://0.0.0.0:7007/proto
- testing
- ops integrations for monitoring
- docker files
- kubernetes files
- the kitchen sink
We are interested in contributors. If you feel some passion for a project like this. Drop us a line.
This project is licensed under the MIT License - see the LICENSE.md file for details
- Thanks to @mxstbr and everyone who worked on react-boilerplate. Great inspiration.
- The node.js community
- And all the new friends in the kubernetes groups.