Skip to content

Latest commit

 

History

History
61 lines (37 loc) · 1.86 KB

README.md

File metadata and controls

61 lines (37 loc) · 1.86 KB
Raw

Docker + NodeJS sample

Build Status

NodeJS development using Docker made simple.

Overview

This is a simple REST API built using Hapi.js. The microservice architecture allows it to be run using either Docker or docker-compose.

The API is exposed to "the internets" via an NGINX reverse proxy and persistence is handled by a Redis server.

Configuration

Settings are handled via environment vars, available config values are:

env desc
PORT backend service port
REDIS_URL uri for the redis server

Running the app

  1. clone the repo
  2. cd into the folder
  3. docker compose up
  4. ?????
  5. Profit!

Now point your browser towards http://localhost:8080 🎉

Building the container

If you're developing locally and just want to test the app in isolation, you can build the container via:

docker build -t <username>/<applicationName> --rm .

NOTE the optional --rm flag, used here to remove the intermediate containers

This tells Docker to dockerize the entire folder application (.) and name the container <userName>/<applicationName>. This is another Docker best practice, you can call your container as you see fit, but a pattern is using your Docker username and your application name joined by a slash (/), ie:

docker build -t cilindrox/docker-sample .

Once the image has been built, you can run the container via the run command:

docker run -d -p 8080:3000 <username>/<applicationName>

This will spin up a new container along with the Node application, mapping the port 3000 of the container to the port 8080 of the host. You can verify this by typing docker ps in your console.