Skip to main content

Dockerizing Node.js Applications

In this tutorial, we'll explore how to dockerize your Node.js applications. Docker is a platform that allows you to automate the deployment, scaling, and management of applications. It does this through the use of containerization, a lightweight form of virtualization.

Prerequisites​

Before we begin, you'll need to have a few things set up and ready to go:

  • Node.js installed on your local machine.
  • Docker installed on your local machine.
  • Basic understanding of Node.js and Docker.

Step 1: Create a Simple Node.js Application​

Let's start by creating a simple Node.js application. Create an app.js file and add the following code:

const express = require('express');
const app = express();
const port = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('Hello, Docker!');
});

app.listen(port, () => {
  console.log(`App running on port ${port}`);
});

This application uses Express.js to create a basic web server that responds with "Hello, Docker!" when accessed at the root URL.

Step 2: Create a Dockerfile​

A Dockerfile is a text document that contains all the commands a user could call on the command line to assemble an image. Create a Dockerfile in the root of your project and add the following:

# Use an official Node.js runtime as the parent image
FROM node:14

# Set the working directory in the container to /app
WORKDIR /app

# Copy package.json and package-lock.json to the working directory
COPY package*.json ./

# Install the application dependencies
RUN npm install

# Copy the rest of the application code to the working directory
COPY . .

# Make port 3000 available outside the container
EXPOSE 3000

# Run the application when the container launches
CMD ["node", "app.js"]

Step 3: Build the Docker Image​

Now that you have your Dockerfile, you can build your image. Run the following command in your terminal:

docker build -t my-nodejs-app .

This command tells Docker to build an image using the Dockerfile in the current directory and to tag the image with the name my-nodejs-app.

Step 4: Run the Docker Container​

After the image has been built, you can run it as a container. Run the following command in your terminal:

docker run -p 8080:3000 -d my-nodejs-app

This command tells Docker to run a new container from the my-nodejs-app image and to map port 3000 in the container to port 8080 on your local machine.

Now, if you navigate to http://localhost:8080 in your web browser, you should see the message "Hello, Docker!".

This tutorial has given you a brief introduction to dockerizing Node.js applications. By following these steps, you can package your applications into portable containers, improving deployment and scalability. Keep practicing and exploring more about Docker and Node.js. Happy coding!