Fully managed Microservices starter pack using NestJS / RabbitMQ. created with SQL, NoSQL databases, Kong API Gateway, Grafana Logging stack and Helm charts.
For Linux, I would recommend this tool for docker container inspection: https://github.com/jesseduffield/lazydocker
- RabbitMQ - https://www.rabbitmq.com
- Redis - https://redis.io
- Grafana - https://grafana.com
- MognoDB - https://www.mongodb.com
- PostgreSQL - https://www.postgresql.org
- Kong - https://konghq.com
- Loki - https://grafana.com/oss/loki
- Prisma - https://www.prisma.io
- Helm - https://helm.sh
- Firebase - https://firebase.google.com
- Fluent-Bit - https://grafana.com/docs/loki/latest/clients/fluentbit
- Use
git submodule update --init --recursivecommand to update/fetch submodules. - Use
.env.localfile while working on local environment and use.envfor production. - Make sure to change service name to localhost in
.env.localwhile running single service only in terminal. kong.ymlfromkong/conf/kong.ymlfile is configured for api gateway.- Kong development server endpoint will start on port
8000. - Health endpoint:
host:port/api/health - Swagger docs endpoint:
host:port/api/docs
start core services first (postgres, rabbitmq, mongodb, redis)
npm run up Now, first place .env file in service folder
then go to service folder cd auth
npm run devto stop core services, run
npm run downstart core services
npm run updocker-compose command - this will take env variables from .env.local
docker-compose up "service name" rebuild
docker-compose up "service name" --builddocker-compose up To see the logs on Grafana dashboard, follow below steps.
- Open the browser and go to http://localhost:3000, use default credentials username "admin" and password "admin" to login.
- Now, go to http://localhost:3000/datasources and select Loki from Logging and document databases section.
- Enter http://loki:3100 in URL under HTTP section. We can do this because we are running Loki and Grafana in the same network.
- loki else you have to enter host IP address and port here, click on Save and Test button from the bottom of the page.
- Now, go to 3rd tab "Explore" from the left sidebar or http://localhost:3000/explore
- select containers and run the query. you will see below view on your screen.
sh deploy.shNotes:
- change "aws_region" and "aws_account_id" as per your AWS account.
sh build.shNOTE: I would recommend tool k9s for better understanding of a cluster. To start with helm deployment in local machine, make sure that you have started Minikube. service images should be available in your local docker env and core service should be up and running in local env.
If you're unable to use local images in minikube cluster then refer this blog
minikube startNow, install helm charts
helm install nestjs-ms helm To get services endpoints
minikube service list# check loki stack installed in current namespace
helm list
# NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
# nestjs-ms default 1 2023-02-27 19:11:14.537649934 +0530 IST deployed nestjs-ms-0.1.0 1.0.0
# now get loki IP from k8s cluster
kubectl get service nestjs-ms-loki
# NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
# nestjs-ms-loki ClusterIP 10.102.161.158 <none> 3100/TCP 28m
# use this ClusterIP to add datasource Loki in grafana dashboard
# at the end minikube service list will look like this
minikube service list
# |-------------|-----------------------------------|--------------------|---------------------------|
# | NAMESPACE | NAME | TARGET PORT | URL |
# |-------------|-----------------------------------|--------------------|---------------------------|
# | default | auth-service | No node port | |
# | default | files-service | No node port | |
# | default | kubernetes | No node port | |
# | default | nestjs-ms-grafana | service/80 | http://192.168.49.2:31679 |
# | default | nestjs-ms-kong-proxy | kong-proxy/80 | http://192.168.49.2:32083 |
# | | | kong-proxy-tls/443 | http://192.168.49.2:31251 |
# | default | nestjs-ms-kong-validation-webhook | No node port | |
# | default | nestjs-ms-loki | No node port | |
# | default | nestjs-ms-loki-headless | No node port | |
# | default | nestjs-ms-loki-memberlist | No node port | |
# | default | notification-service | No node port | |
# | default | post-service | No node port | |
# | kube-system | kube-dns | No node port | |
# |-------------|-----------------------------------|--------------------|---------------------------|
# To access grafana : http://192.168.49.2:30353
# To access kong gateway: http://192.168.49.2:31208Clean up the local env
helm uninstall nestjs-ms
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent