How to deploy a Node.js application to AWS with Docker

Using ECS & ECR with EC2

Posted on November 1, 2024

In this tutorial, It shows you how to dockerize a Node.js application and deploy it to Amazon Web Service (AWS) using Amazon ECR (Elastic Container Registry) and ECS (Elastic container service).

Table of Contents

  1. Introduction
  2. Prerequisites
  3. A quick primer on Docker and AWS
  4. What we’ll be deploying
  5. Creating a Dockerfile
  6. Building a docker image
  7. Running a docker container
  8. Creating the Registry (ECR) and uploading the app image to it
  9. Creating a new task definition
  10. Creating a cluster
  11. Creating a service to run it
  12. Conclusion

Introduction

Writing code that does stuff is something most developers are familiar with. Sometimes, we need to take the responsibility of a SysAdmin or DevOps engineer and deploy our codebase to production where it will help a business solve problems for customers.

This tutorial will show you how to dockerize a Node.js application and deploy it to Amazon Web Service (AWS) using Amazon ECR (Elastic Container Registry) and ECS (Elastic container service).

Prerequisites

To follow through this tutorial, you’ll need the following:

  • Node and Npm: Follow this link to install the latest versions.

  • Basic knowledge of Node.js.

  • Docker: The installation provides Docker Engine, Docker CLI client, and other cool stuff. Follow the instructions for your operating system. To check if the installation worked, fire this on the terminal: docker --version. The command above should display the version number. If it doesn’t, the installation didn’t complete properly.

  • AWS account: Sign up for a free tier. There is a waiting period to verify your phone number and bank card. After this, you will have access to the console.

  • AWS CLI: Follow the instructions for your OS. You need Python installed.

A quick primer on Docker and AWS

Docker is an open source software that allows you to pack an application together with the required dependencies and environment in a ‘Container’ that you can ship and run anywhere. It is independent of platforms or hardware, and therefore the containerized application can run in any environment in an isolated fashion.

Docker containers solve many issues, such as when an app works on a co-worker’s computer but doesn’t run on yours, or it works in the local development environment but doesn’t work when you deploy it to a server.

docker overview

Amazon Web Services (AWS) offers a reliable, scalable, and inexpensive cloud computing service for businesses. As I mentioned before, this tutorial will focus on using the ECR and ECS services.

What we’ll be deploying

Let’s quickly build a sample app that we’ll use for the purpose of this tutorial. It going to be very simple Node.js app.

Enter the following in your terminal:

// create a new directory
mkdir sample-nodejs-app

// change to new directory
cd sample-nodejs-app

// Initialize npm
npm init -y

// install express
npm install express

// create an server.js file
touch server.js

Open server.js and paste the code below into it:

// server.js

const express = require('express')
const app = express()

app.get('/', (req, res) => {
    res.send('Hello world from a Node.js app!')
})

app.listen(3000, () => {
    console.log('Server is up on 3000')
})

Start the app with node server.js

Access it on http://localhost:3000. You should get Hello world from a Node.js app! displayed in your browser. The complete code is available on GitHub.

Now let’s take our very important app to production ?.

Creating a Dockerfile

Every Dockerfile starts with a base image as its foundation. There are two ways to approach creating your Dockerfile:

Use a plain OS base image (For example, Ubuntu OS, Debian, CentOS etc.) and install an application environment in it such as Node.js OR Use an environment-ready base image to get an OS image with an application environment already installed. We will proceed with the second approach.

Write this in the Dockerfile:

FROM node:8-alpine
RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app
COPY . .
RUN npm install
EXPOSE 3000
CMD [ "node", "server.js" ]

Here, we are building our Docker image using the official Node.js image from Dockerhub (a repository for base images).

  • Start our Dockerfile with a FROM statement. This is where you specify your base image.

  • The RUN statement will allow us to execute a command for anything you want to do. We created a subdirectory /usr/src/app that will hold our application code within the docker image.

  • WORKDIR instruction establishes the subdirectory we created as the working directory for any RUN, CMD, ENTRYPOINT, COPY and ADD instructions that follow it in the Dockerfile. /usr/src/app is our working directory.

  • COPY lets us copy files from a source to a destination. We copied the contents of our node application code ( server.js and package.json) from our current directory to the working directory in our docker image.

  • The EXPOSE instruction informs Docker that the container listens on the specified network ports at runtime. We specified port 3000.

  • Last but not least, theCMD statement specifies the command to start our application. This tells Docker how to run your application. Here we use node server.js which is typically how files are run in Node.js.

With this completed file, we are now ready to build a new Docker image.

Building a docker image

Make sure you have Docker up and running. Now that we have defined our Dockerfile, let’s build the image with a title using -t:

docker build -t sample-nodejs-app .

This will output hashes, and alphanumeric strings that identify containers and images saying “Successfully built” on the last line:

Sending build context to Docker daemon  1.966MB
Step 1/7 : FROM node:6-alpine
 ---> 998971a692ca
Step 2/7 : RUN mkdir -p /usr/src/app
 ---> Using cache
 ---> f1aa1c112188
Step 3/7 : WORKDIR /usr/src/app
 ---> Using cache
 ---> b4421b83357b
Step 4/7 : COPY . .
 ---> 836112e1d526
Step 5/7 : RUN npm install
 ---> Running in 1c6b36b5381c
npm WARN sample-nodejs-app@1.0.0 No description
npm WARN sample-nodejs-app@1.0.0 No repository field.
Removing intermediate container 1c6b36b5381c
 ---> 93999e6c807f
Step 6/7 : EXPOSE 3000
 ---> Running in 7419020927f1
Removing intermediate container 7419020927f1
 ---> ed4ac8a31f83
Step 7/7 : CMD [ "node", "server.js" ]
 ---> Running in c77d34f4c873
Removing intermediate container c77d34f4c873
 ---> eaf97859f909
Successfully built eaf97859f909

// dont expect the same values from your terminal.

Running a Docker Container

We’ve built the docker image. To see previously created images, run: docker images

Copy the image Id. To run the container, we write on the terminal:

docker run -p 80:3000 {image-id}

// fill with your image-id

By default, Docker containers can make connections to the outside world, but the outside world cannot connect to containers. -p publishes all exposed ports to the host interfaces. Here we publish the app to port 80:3000. Because we are running Docker locally, go to http://localhost to view. docker container ls to check which containers are running.

Finally, you can stop the container from running by: docker stop {image-id}

Create Registry (ECR) and upload the app image to it

Amazon Elastic Container Registry (ECR) is a fully-managed Docker container registry that makes it easy for developers to store, manage, and deploy Docker container images. Amazon ECR is integrated with Amazon Elastic Container Service (ECS), simplifying your development to production workflow.

The keyword “Elastic” means you can scale the capacity or reduce it as desired.

Steps:

  • Go to the AWS console and sign in.

  • Select the EC2 container service and Get started

  • The first run page shows, scroll down and click cancel > enter ECS dashboard.

ec2 dashboard

  • To ensure your CLI can connect with your AWS account, run on the terminal: aws configure

If your AWS CLI was properly installed, aws configure will ask for the following:

$ aws configure
AWS Access Key ID [None]: accesskey
AWS Secret Access Key [None]: secretkey
Default region name [None]: us-west-2
Default output format [None]:

Get the security credentials from your AWS account under your username > Access keys. Run aws configure again and fill correctly.

Create a new repository in ECS and enter a name (preferably with the same container name as in your local dev environment for consistency).

For example, use sample-nodejs-app.

ecs1 dashboard

Next, We need to building, tagging, and pushing Docker images to ECR:

  • Retrieve the Docker login command that you can use to authenticate your Docker client to your registry: Note: If you receive an “Unknown options: - no-include-email” error, install the latest version of the AWS CLI. Learn more here.
aws ecr get-login --no-include-email --region us-east-2
  • Run the docker login command that was returned in the previous step (just copy and paste). Note: If you are using Windows PowerShell, run the following command instead:
Invoke-Expression -Command (aws ecr get-login --no-include-email --region us-east-2)

It should output: Login Succeeded.

  • Build your Docker image using the following command. For information on building a Docker file from scratch, see the instructions here. You can skip this step since our image is already built:
docker build -t sample-nodejs-app .
  • With a completed build, tag your image with a keyword (For example, latest) so you can push the image to this repository:
docker tag sample-nodejs-app:latest 559908478199.dkr.ecr.us-east-2.amazonaws.com/sample-nodejs-app:latest
  • Run the following command to push this image to your newly created AWS repository (ECR):
docker push 559908478199.dkr.ecr.us-east-2.amazonaws.com/sample-nodejs-app:latest

Create a new task definition

Tasks function like the _docker run_ command of the Docker CLI but for multiple containers. They define:

  • Container images (to use)

  • Volumes (if any)

  • Networks Environment variables

  • Port mappings

From Task Definitions in the ECS dashboard, press on the Create new Task Definition (ECS) button:

ecs2 dashboard

Set a task name and use the following steps:

  • Add Container: sample-nodejs-app (the one we pushed).

  • Image: the URL to your container. Mine is 559908478199.dkr.ecr.us-east-2.amazonaws.com/sample-nodejs-app

  • Soft limit: 512

  • Map 80 (host) to 3000 (container) for sample-nodejs-app

  • Env Variables: NODE_ENV: production

Create a Cluster

A cluster is the place where AWS containers run. They use configurations similar to EC2 instances. Define the following:

  • Cluster name: demo-nodejs-app-cluster

  • EC2 instance type: t2.micro

  • Number of instances: 1

  • EBS storage: 20

  • Key pair: None

  • VPC: New

(Note: you select the instances based on the size of your application. Here we’ve selected the smallest. Your selection affects how much money you are billed at the end of the month. Visit here for more information)

When the process is complete, you may choose to click on “View cluster.”

Create a service to run it

Go to Task Definition > click demo-nodejs-app > click on the latest revision.

Inside of the task definition, click on the actions dropdown and select Create service

Use the following:

  • Launch type: EC2

  • Service name: demo-nodejs-app-service

  • Number of tasks: 1

You’ll see its status as PENDING. Give it a little time and it will indicate RUNNING.

Go to Cluster (through a link from the service we just created) > EC2 instances > Click on the container instance to reveal the public DNS.

ecs3 dashboard

ecs4 dashboard

Visit the public DNS to view our app! Mine is ec2–18–219–113–111.us-east-2.compute.amazonaws.com

Conclusion

To deploy app on ECS using Docker:

Building image > Push imge to ECR > Create task definition (docker run) > Create cluster > Create service to run!

“Thank you for reading! I hope you found this guide helpful and informative. If you have any questions or feedback, please feel free to leave a comment below.”

Tags: nodejs docker ecs ecr ec2
Share: X (Twitter) Facebook LinkedIn