Development vs production Dockerfiles - When to Use Which

The Big Idea

Discover why using one Dockerfile for everything can slow you down and how splitting them can speed up your app's journey to users!

The Scenario

Imagine you build your app on your computer and then try to run the exact same setup on a server for users. You copy all your files and tools, including things only needed for building, not running. Suddenly, the server is slow, uses too much space, and sometimes your app crashes.

The Problem

Manually copying everything means your production environment is cluttered with unnecessary files and tools. This wastes space, slows down startup, and can cause security risks. Also, fixing bugs becomes harder because the production setup is not clean or optimized.

The Solution

Using separate Dockerfiles for development and production lets you keep your build tools and debugging helpers in development images, while production images stay small, fast, and secure. This clear separation makes your app run smoothly where it matters most.

Before vs After

✗ Before

FROM node:latest
WORKDIR /app
COPY . .
RUN npm install
CMD npm start

✓ After

### Development Dockerfile
FROM node:latest
WORKDIR /app
COPY . .
RUN npm install
CMD npm run dev

### Production Dockerfile
FROM node:latest AS build
WORKDIR /app
COPY . .
RUN npm install
RUN npm run build

FROM node:alpine
WORKDIR /app
COPY --from=build /app/package*.json .
COPY --from=build /app/dist/ .
RUN npm install --production
CMD npm start

What It Enables

This approach enables fast, reliable deployments with lean production containers and rich development environments.

Real Life Example

A developer uses a full Node.js image with debugging tools during coding, but deploys a tiny Alpine-based image with only the compiled app to the cloud, saving bandwidth and improving startup time.

Key Takeaways

Development Dockerfiles include tools for building and debugging.

Production Dockerfiles focus on minimal size and security.

Separating them improves app performance and deployment reliability.

Practice

1. Why do we use separate Dockerfiles for development and production environments?

easy

A. Because development needs debugging tools and production needs optimized images

B. Because production requires more debugging tools than development

C. Because development images must be smaller than production images

D. Because production Dockerfiles always include all source code

Solution

1. Step 1: Understand development Dockerfile purpose

   Development Dockerfiles include debugging tools and full dependencies to help developers test and debug easily.

2. Step 2: Understand production Dockerfile purpose

   Production Dockerfiles are optimized for smaller size, speed, and security, removing unnecessary tools.

3. Final Answer:

   Because development needs debugging tools and production needs optimized images -> Option A

4. Quick Check:

   Separate Dockerfiles fit different environment needs [OK]

Hint: Dev needs tools; prod needs speed and security [OK]

Common Mistakes:

• Thinking production needs more debugging tools
• Assuming development images must be smaller
• Believing production always includes all source code

2. Which of the following is a correct way to specify a base image in a production Dockerfile?

easy

A. BASE node:alpine

B. FROM node:latest

C. FROM alpine:node

D. FROM node:alpine

Solution

1. Step 1: Identify correct Dockerfile syntax for base image

   The correct keyword to specify a base image is 'FROM', followed by the image name and tag.

2. Step 2: Choose a lightweight base image for production

   For production, 'node:alpine' is a lightweight image suitable for smaller, optimized containers.

3. Final Answer:

   FROM node:alpine -> Option D

4. Quick Check:

   Use 'FROM' and lightweight image for production [OK]

Hint: Use 'FROM' and lightweight tags like alpine for production [OK]

Common Mistakes:

• Using 'BASE' instead of 'FROM'
• Incorrect image name order like 'alpine:node'
• Using 'latest' tag for production images

3. Given this production Dockerfile snippet:

FROM node:alpine
WORKDIR /app
COPY package.json ./
RUN npm install --production
COPY . .
CMD ["node", "server.js"]

What is the main effect of the npm install --production command?

medium

A. Installs all dependencies including devDependencies

B. Installs no dependencies at all

C. Installs only production dependencies, skipping devDependencies

D. Installs only devDependencies

Solution

1. Step 1: Understand npm install --production flag

   The '--production' flag tells npm to install only dependencies needed for running the app, skipping devDependencies used for development.

2. Step 2: Relate to production Dockerfile purpose

   Skipping devDependencies reduces image size and improves security for production environments.

3. Final Answer:

   Installs only production dependencies, skipping devDependencies -> Option C

4. Quick Check:

   npm install --production = only production deps [OK]

Hint: npm install --production skips devDependencies [OK]

Common Mistakes:

• Assuming it installs all dependencies
• Thinking it installs no dependencies
• Confusing devDependencies with production dependencies

4. You have a development Dockerfile that installs extra debugging tools but your production image is unexpectedly large. What is a likely cause?

medium

A. You used the development Dockerfile to build the production image

B. You forgot to copy source code in production Dockerfile

C. You used a smaller base image in production

D. You ran npm install without --production flag in development

Solution

1. Step 1: Identify cause of large production image

   If the production image is large, it may include unnecessary development tools and dependencies.

2. Step 2: Check which Dockerfile was used for production build

   Using the development Dockerfile for production will include extra tools, increasing image size.

3. Final Answer:

   You used the development Dockerfile to build the production image -> Option A

4. Quick Check:

   Wrong Dockerfile causes large production image [OK]

Hint: Use correct Dockerfile for each environment [OK]

Common Mistakes:

• Assuming missing source code causes large image
• Thinking smaller base image increases size
• Confusing npm install flags in development

5. You want to create a multi-stage Dockerfile that uses a full Node.js image for development and a lightweight Alpine image for production. Which snippet correctly achieves this?

hard

A. FROM node:alpine AS build
WORKDIR /app
COPY . .
RUN npm install
FROM node:alpine
COPY --from=build /app .
CMD ["node", "server.js"]

B. FROM node:latest AS build
WORKDIR /app
COPY . .
RUN npm install
FROM node:alpine
COPY --from=build /app .
CMD ["node", "server.js"]

C. FROM node:alpine AS build
WORKDIR /app
COPY . .
RUN npm install --production
FROM node:latest
COPY --from=build /app .
CMD ["node", "server.js"]

D. FROM node:latest
WORKDIR /app
COPY . .
RUN npm install
CMD ["node", "server.js"]

Solution

1. Step 1: Identify multi-stage build structure

   The first stage uses a full Node.js image (node:latest) for building with all tools, suitable for development.

2. Step 2: Use lightweight Alpine image for final production stage

   The second stage uses node:alpine to copy only necessary files from build stage, creating a smaller production image.

3. Step 3: Verify correct order and commands

   FROM node:latest AS build WORKDIR /app COPY . . RUN npm install FROM node:alpine COPY --from=build /app . CMD ["node", "server.js"] correctly uses 'AS build' for first stage and copies from it to the lightweight image.

4. Final Answer:

   FROM node:latest AS build WORKDIR /app COPY . . RUN npm install FROM node:alpine COPY --from=build /app . CMD ["node", "server.js"] -> Option B

5. Quick Check:

   Multi-stage: full image build + alpine production [OK]

Hint: Use full image first, then alpine with COPY --from=build [OK]

Common Mistakes:

• Using alpine for build stage losing dev tools
• Using latest image for final production stage
• Not using multi-stage COPY syntax