/node-docker

Node.js with Docker (project sample)

Primary LanguageJavaScript

Node.js with Docker project sample

Prerequisites:

  • Node.js
  • Docker
  • Docker-compose

Basic info:

  • Containers are isolated from each other and bundle their own application, tools, libraries and configuration files; they can communicate with each other through well-defined channels.
  • The difference between a container and a virtual machine is that containers are not based on a hardware virtualization, but on OS-level virtualization.
  • The advantage of containers is that they are lightweight and portable.

Commands:

  • Install Docker on Linux:
sudo apt update
sudo apt install docker.io
# restart the machine
sudo apt update
sudo apt install docker-compose
  • Pull an image from dockerHub:
docker pull <IMAGE_NAME>:<TAG>
# example postgres latest version:
docker pull postgres:latest
# example node.js version 14:
docker pull node:14
  • Building a docker image from the Dockerfile:
# by default it will be find the file named "Dockerfile"
docker build . --tag node-server-container
# if there is no Dockerfile in the current directory, you can specify the path to the Dockerfile like this:
docker build ./path/to/Dockerfile --tag node-server-container
  • See docker images:
docker images -a
docker image ls -a
  • Delete images:
docker image rm <IMAGE_ID>
docker rmi <IMAGE_ID>
  • Create/Build an image with specifying the image name (tag):
docker build . -t node-server
  • Run a container with name "node-server-container" by the image name:
docker run -d --name node-server-container node-server-image
# "-d" means that we'll detach after running the command
# by default it will read the "node-server-image" from the local machine
# but if it will not find it, it will try to find it in the dockerHub remote repository
  • See containers:
docker ps -a
docker container ls -a
  • Delete container:
# stop and delete the container
docker stop <CONTAINER_ID>
docker rm <CONTAINER_ID>
# delete force:
docker rm <CONTAINER_ID> -f

  • Create ".dockerignore" for ignoring files and folders when building the docker image

  • Run our container from created image:

# first number is the public port (http://localhost:5001)
# second number is the docker container internal port
docker run -p 5001:5000 -d --name node-server-container node-server-image
  • Login to "node-server-container" container using "bash" editor
# "-it" means the interactive mode
docker exec -it node-server-container bash
# "exit" to exit from the container

# or run a command inside the container
docker exec -it node-server-container <COMMAND>
# example:
docker exec -it node-server-container npm run migrate

  • In this step when we'll change something in our app, (for example in "index.js"), it will not affect on container files which we've already run.

  • Create docker-compose.yml with setting the environment variables and volumes:

# start the compose services
docker-compose up -d --build

# execute a command inside the container
docker exec <CONTAINER_ID> npm run migrate
docker exec <CONTAINER_ID> npm run seed

# test via connecting to the Postgres database
# (if it's publicly available for external connections)
psql -h localhost -p 4321 -U postgres
\c postgres
\dt
SELECT * FROM users;
\q
# or test via server
curl http://localhost:5001/users

# stop the compose services
docker-compose down
  • See volumes:
docker volume ls -a

Resources:

TODOs:

  • Setup Postgres container with another user and password.

Author: