User management system with MongoDB, Express and NodeJS app. Using Swagger for Docs Api.
Firstable you need Docker and docker-compose installed and internal or external MongoDB installed. You can follow this links to install docker on ubuntu 16-04es and install docker-compose on ubuntu 16-04.
We are using docker-compose file version 3.0, so maybe you need to update to at least that version:
curl -L https://github.com/docker/compose/releases/download/1.19.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
A docker-compose.yml
looks like this:
version: "3.5"
services:
server:
build:
context: .
dockerfile: DockerfileServer
volumes:
- ./server:/app
- /app/node_modules
ports:
- "3000:3000"
command: "npm run build-pm2"
Using docker-compose
(Use remote db or a local one in which we can share with other apps):
- To use a
remote_db
If do you want to connect to a existing remote mongo server, you should write down in your dotenv file:
ENVIRONMENT=development
And uncomment the following line:
DB_DEV=mongodb://{USER}:{PASSWORD}@{IP_DATABASE}:27017/database_ums
- To use a
local_db
Or in the contrary you already has a mongo running in your set up, then you should type the info like this:
DB_DEV=mongodb://{YOUR_IP_DATABASE}:{YOUR_PORT_DATABASE}/database_ums
In this case, you need to write down your local ip where your mongo is, if you just type localhost this will not work.
Same steps that we note before in the case of development, for the production you only need to comment the development line and uncomment the production one.
We recommended created a new private and public keys for production environment instead of data/keys/jwt256.key and data/keys/jwt256.key.pub we have in our repo with development and testing purposes. You can create your keys following:
ssh-keygen -t rsa -b 4096 -f jwtRS256.key
#Without passphrase
openssl rsa -in jwtRS256.key -pubout -outform PEM -out jwtRS256.key.pub
cat jwtRS256.key
cat jwtRS256.key.pub
You can put wherever you want and put the path in your .env file to work with them. You never must publish your private key. You just should share your public key instead of private.
JWT_PRIVATE_KEY_PATH=data/keys/jwtRS256.key JWT_PUBLIC_KEY_PATH=data/keys/jwtRS256.key.pub
Load balancing across multiple application instances is a commonly used technique for optimizing resource utilization, maximizing throughput, reducing latency, and ensuring fault-tolerant configurations.
It is possible to use nginx as a very efficient HTTP load balancer to distribute traffic to several application servers and to improve performance, scalability and reliability of web applications with nginx.
We use round-robin method.
If we want to deploy more than one instance and use load balancing we need to execute following command:
docker-compose up --scale server_1=num_of_instances_you_want
instead of docker just
docker-compose up
which just will deploy one instance
In order to do our tests this will be the mongodb route in local:
DB_TEST=mongodb://localhost:27017/ums_test
We are storing the mongo data in when we use utils-docker/docker-shared-mongo(Deprecated) or utils-docker/docker-compose-internal:
- ~/data/mongodb_data/:/data/db
If do you want to change this or the port used in order to connect with mongo, you can do this in the docker-compose.yml
file.
- Copy
.env-getting-started
and rename it to .env - Config your
.env
file
After you have installed both:
- git clone https://github.com/alemarcha/UMS.git
- cd UMS
- docker-compose up
- You should see at localhost:8082 our swagger docs now.
Firstable you need Nodejs and MongoDB installed.
After that you should follow next steps:
- git clone https://github.com/alemarcha/UMS.git
- Install and init server.
- cd UMS/server
- npm install
- npm start
You should see at localhost:8082 our Swagger docs now.
We are using Visual Studio Code to programming, if you are planning to replicate the way we are doing it, we recommend you to install the following extensions:
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
- Docker
ext install PeterJausovec.vscode-docker
- ESLint
ext install dbaeumer.vscode-eslint
- Prettier - Code formatter
ext install esbenp.prettier-vscode
- YAML support for vscode
ext install redhat.vscode-yaml
- Swagger Viewer (in order to preview the doc)
ext install Arjun.swagger-viewer
-
Install pm2 with npm for server monitoring
npm install pm2@latest -g
- cd UMS/server
- npm install
- npm run test
You will see results of testing in command line
cd ~/go/bin/ ./hey -n 5000 -c 500 http://localhost:8082/api/users/search
Moreover you could see our travis CI
Alexis Martínez Chacón (alexis.martinez@juntadeandalucia.es)
Rubén García Serrano (onitaku@gmail.com)