athena-test/docs/Dipal/Backend/Kaiser/Installation.md

1.4 KiB

Installation

If you install Kaiser project completely on your system, you need also to run third party services. You can use docker-compose files from our DevOps repos.

  • Keycloak. Account management system.
  • Kafka. Message broker with many features.
  • Redis. Data cache system.

Configure enviroment varibles in .env files of your microservices.

Microservice common runbook

To run microservice is simple:

npm install
npm run start

If you have node_modules or dist directories:

rm ./node_modules -R
rm ./dist -R
npm cache clean --force
npm install
npm run start

Get AUTH_KEY for gateways

To get security key get it from Keycloak panel or ask it from your supervisor:

Choose realm (for example dipal_develop or master). Realm Settings -> Keys -> Get Public key provided by rsa-generated. Set it in your .env file as AUTH_KEY.

Get SECURITY_KEY

In some services, we need a security key to enccrypt and decrypt secrets (for example e87fb5065e795ea8eb6c71a5756e31c6). If you connect to a shared MongoDB and Keycloak, ask your supervisor to give you a SECURITY_KEY. If you work with the system on your machine, generate it by yourself. After that set it in your .env file.