In this article 🚢 We’ll write a docker multi-stage build together. 🎉 We’ll discover how to use the docker file in development and production. ✨ We’ll apply some of the best practices recommended by the Docker team. Let’s go. First, let’s think about the use cases to design the docker build: To install all the dependencies to support the local dev server. To run a production server with an optimized bundle. In order to cover both of the use cases, we’ll use Docker’s and split the build into 3 stages: multi-stage builds : to simply install all the dependencies. dev : to compile a production build with optimized bundle size. build : to serve the production build. prod The Docker Multi-stage Build The “dev” Stage It’s fairly straightforward. All we need to do is to install npm dependencies and apply some of the : best practices We’ll use “ ” as the based image to produce minimal image size. node:alpine We’ll install from node:alpine. missing shared libraries We’ll assign a to Docker to limit its privileges non-root user We’ll set the environment to “development”. We’ll install the dependencies based on to achieve consistent installation across machines. yarn lock file # Dockerfile

#
# 🧑‍💻 Development
#
FROM node:18-alpine as dev
# add the missing shared libraries from alpine base image
RUN apk add --no-cache libc6-compat
# Create app folder
WORKDIR /app

# Set to dev environment
ENV NODE_ENV development

# Create non-root user for Docker
RUN addgroup --system --gid 1001 node
RUN adduser --system --uid 1001 node

# Copy source code into app folder
COPY --chown=node:node . .

# Install dependencies
RUN yarn --frozen-lockfile

# Set Docker as a non-root user
USER node The “build” Stage The build stage is the most interesting stage. The purpose is to compile the source code and generate the least amount of assets. We’ll use the same base image and best practices . as the dev stage We’ll set the environment to “production”. We’ll copy the dependencies we installed in the dev stage to run the . Nest CLI build script Once the build is completed, we’ll install the production-only dependencies and clean the . This will minimize the bundle size. yarn cache # Dockerfile

#
# 🏡 Production Build
#
FROM node:18-alpine as build

WORKDIR /app
RUN apk add --no-cache libc6-compat

# Set to production environment
ENV NODE_ENV production

# Re-create non-root user for Docker
RUN addgroup --system --gid 1001 node
RUN adduser --system --uid 1001 node

# In order to run `yarn build` we need access to the Nest CLI.
# Nest CLI is a dev dependency.
COPY --chown=node:node --from=dev /app/node_modules ./node_modules
# Copy source code
COPY --chown=node:node . .

# Generate the production build. The build script runs "nest build" to compile the application.
RUN yarn build

# Install only the production dependencies and clean cache to optimize image size.
RUN yarn --frozen-lockfile --production && yarn cache clean

# Set Docker as a non-root user
USER node The “prod” Stage Now that we have the optimized production build, we can complete the docker build by serving the NestJS server. We’ll use the same base image and best practices as . the build stage We’ll copy the compiled output and the production-only node_modules from the build stage. These are the necessary files we need to run the server. Finally, start the server with Node. “nest start” command is not available at this stage because the Nest CLI is a dev dependency. # Dockerfile

#
# 🚀 Production Server
#
FROM node:18-alpine as prod

WORKDIR /app
RUN apk add --no-cache libc6-compat

# Set to production environment
ENV NODE_ENV production

# Re-create non-root user for Docker
RUN addgroup --system --gid 1001 node
RUN adduser --system --uid 1001 node

# Copy only the necessary files
COPY --chown=node:node --from=build /app/dist dist
COPY --chown=node:node --from=build /app/node_modules node_modules

# Set Docker as non-root user
USER node

CMD ["node", "dist/main.js"] The Complete Multi-stage Dockerfile # Dockerfile

#
# 🧑‍💻 Development
#
FROM node:18-alpine as dev
# add the missing shared libraries from alpine base image
RUN apk add --no-cache libc6-compat
# Create app folder
WORKDIR /app

# Set to dev environment
ENV NODE_ENV dev

# Create non-root user for Docker
RUN addgroup --system --gid 1001 node
RUN adduser --system --uid 1001 node

# Copy source code into app folder
COPY --chown=node:node . .

# Install dependencies
RUN yarn --frozen-lockfile

# Set Docker as a non-root user
USER node

#
# 🏡 Production Build
#
FROM node:18-alpine as build

WORKDIR /app
RUN apk add --no-cache libc6-compat

# Set to production environment
ENV NODE_ENV production

# Re-create non-root user for Docker
RUN addgroup --system --gid 1001 node
RUN adduser --system --uid 1001 node

# In order to run `yarn build` we need access to the Nest CLI.
# Nest CLI is a dev dependency.
COPY --chown=node:node --from=dev /app/node_modules ./node_modules
# Copy source code
COPY --chown=node:node . .

# Generate the production build. The build script runs "nest build" to compile the application.
RUN yarn build

# Install only the production dependencies and clean cache to optimize image size.
RUN yarn --frozen-lockfile --production && yarn cache clean

# Set Docker as a non-root user
USER node

#
# 🚀 Production Server
#
FROM node:18-alpine as prod

WORKDIR /app
RUN apk add --no-cache libc6-compat

# Set to production environment
ENV NODE_ENV production

# Re-create non-root user for Docker
RUN addgroup --system --gid 1001 node
RUN adduser --system --uid 1001 node

# Copy only the necessary files
COPY --chown=node:node --from=build /app/dist dist
COPY --chown=node:node --from=build /app/node_modules node_modules

# Set Docker as non-root user
USER node

CMD ["node", "dist/main.js"] How to Use It in Local Development We are done with the hard part! To use the docker file for local development, all we need to do is to . For example, we can build and run the NestJS server with watch mode in a docker compose file: build the docker image with the dev stage # docker-compose.yml

services:
  api:
    container_name: nestjs
    image: nestjs-dev
    restart: unless-stopped
    build:
      context: .
      dockerfile: Dockerfile
      # ✨ Target the dev stage
      target: dev
    # Mount host directory to docker container to support watch mode
    volumes:
      - .:/app
      # This ensures that the NestJS container manages the node_modules folder
      # rather than synchronizes it with the host machine
      - /app/node_modules
    env_file:
      - docker.env
    ports:
      - 8082:8082
    networks:
      - nest
    depends_on:
      - postgres
    command: npx nest start --watch

  # ...other services How to Use It in Production You can simply build the production image by building all 3 stages. For example, we can run “docker build” in GitHub Actions as part of the deployment workflow. # .github/workflows/ci.yml

jobs
  deploy:
    steps:
      - uses: actions/checkout@v3
 
      - uses: actions/setup-node@v3
        with:
          node-version: '18.x'

      - name: Build NestJS image
        env:
          REGISTRY: nestjs-regiestry
          REPOSITORY: nestjs-example
          IMAGE_TAG: example
        # ✨ target the production stage
        run: docker build . -t $REGISTRY/$REPOSITORY:$IMAGE_TAG --target prod

      # ...rest of the steps Since the “prod” is the last stage, we don’t need to specify the target for the build command. Running docker build . -t $REGISTRY/$REPOSITORY:$IMAGE_TAG will build the same image. References — Docker Docs Compose file version 3 reference — Docker docs Develop with Docker — Docker docs Multi-stage builds — Docker Hub Node — GitHub node:alpine — NestJS NestCLI and scripts — Docker Docs USER — Yarn yarn.lock — Yarn yarn cache This was originally posted on . article Daw-Chih’s website

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

How to Share Rust Types With TypeScript for WebAssembly in 30 Seconds: A Quick Guide

How to Optimize Google Cloud BigQuery and Control the Cost

Check out my website!

Nominated for 2022 - HackerNoon Contributor of the Year - Product Management

Nominated for 2022 - HackerNoon Contributor of the Year - Typescript

Nominated for 2022 - HackerNoon Contributor of the Year - Leadership

Nominated for 2022 - HackerNoon Contributor of the Year - Software Engineering

Nominated for Coding Guru of 2022

Nominated for 2022 - HackerNoon Contributor of the Year - Learning

Too Long; Didn't Read

The Ultimate NestJS Dockfile for Optimized Production Image and Local Development

The Ultimate NestJS Dockfile for Optimized Production Image and Local Development

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

A Guide to Design Thinking and Continuous Delivery from an Ex-Principal Engineer

10 Ways to Future-Proof Your Business With Cloud

10 Upcoming DevOps Conferences for 2018

101 Stories To Learn About Cloud Infrastructure

The Ten Top Cities for Highest Cloud Engineering Salaries

10 Things to Think About When Choosing a Hosting Provider

A Guide to Design Thinking and Continuous Delivery from an Ex-Principal Engineer

10 Ways to Future-Proof Your Business With Cloud

10 Upcoming DevOps Conferences for 2018

101 Stories To Learn About Cloud Infrastructure

The Ten Top Cities for Highest Cloud Engineering Salaries

10 Things to Think About When Choosing a Hosting Provider

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps