🚢 Understanding Dockerfile: A Complete Guide

📄 What is a Dockerfile?

A Dockerfile is a simple text file containing instructions to create a Docker image. Docker images provide a consistent, reproducible environment to run applications inside containers. By defining dependencies, configurations, and the operating system, Dockerfiles automate image creation, ensuring version-controlled and portable environments.

🔑 Key Concepts:

🏗️ Base Image: The foundational layer of your image, usually an official OS like Ubuntu, CentOS, or Alpine Linux.
📝 Instructions: Commands that tell Docker what to install, how the image behaves, and which files to include.

Common instructions include:

Instruction	Description
🏃‍♂️ `RUN`	Executes commands inside the container (e.g., install software).
📁 `COPY`	Copies files from your local machine to the image.
▶️ `CMD`	Specifies the default command when the container starts.

🛠️ Step-by-Step Guide to Creating a Dockerfile

1️⃣ Create a File Named `Dockerfile`

Create a file called Dockerfile in your project directory. If named differently, specify the filename during build.

Example Dockerfile:

# 🐧 Use Ubuntu 22.04 as the base image
FROM ubuntu:22.04

# 🏷️ Add metadata such as version information
LABEL version="0.0.1"

# 🔄 Update package lists and install essential tools
RUN apt update && apt install -y bash vim curl

# 🌐 Install Nginx web server
RUN apt install -y nginx

Explanation:

FROM ubuntu:22.04 — Use Ubuntu 22.04 as the base image.
LABEL version="0.0.1" — Adds version metadata.
RUN — Executes commands inside the container to install tools and software.

2️⃣ Example Using Alpine Linux

Alpine Linux is lightweight and creates smaller images.

# 🐧 Use Alpine as the base image
FROM alpine

# 🏷️ Add version metadata
LABEL version="0.0.1"

# 🔄 Update package lists and install essential tools
RUN apk update && apk add bash vim curl

Perfect for a compact, minimalistic image.

3️⃣ Complex Dockerfile with a Script

# 🐧 Start with Alpine as the base image
FROM alpine

# 🏷️ Add metadata
LABEL version="0.0.1"

# 🔄 Update packages and install essential tools
RUN apk update && apk add bash vim curl iputils-ping

# 📂 Copy the script into the image
COPY <local-file-path> <container-destination-path>

# 🏠 Set working directory
WORKDIR <container-destination-path>

# 🌿 Add environment variables
ENV API_KEY="123445"

# 👤 Set user and expose ports
USER deploy
EXPOSE 3210

# ⚙️ Make the script executable
RUN chmod +x app.sh

# ▶️ Default command to run
CMD ["./app.sh"]
# Alternatively, ENTRYPOINT ensures always running the executable
ENTRYPOINT ["bash", "./app.sh"]

❤️ Health Check Setup

HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
  CMD curl -f http://localhost/ || exit 1

⏲️ interval: time between checks
⏳ timeout: fail if check takes longer than 5 seconds
🔄 retries: mark container unhealthy after failed attempts
🛡️ start-period: grace period before counting failures

4️⃣ Build Your Docker Image

docker build -t <app-name> <path-to-dockerfile>

Examples:

Build with Dockerfile in current directory:
```
docker build -t app-test .
```

Use custom Dockerfile name:

docker build -t app-test -f <CustomDockerfile> .

Build without cache:

docker build -t app-test:v1 -f <Custom-Dir> . --no-cache

📋 Summary

A Dockerfile is a powerful tool for automating Docker image creation:

📝 Create a Dockerfile: Define the image with FROM, RUN, COPY, and CMD.
🏗️ Build the Image: Use docker build to generate your image.
🚀 Run the Container: Use docker run to start your container.

4.1 KiB Executable File Raw Blame History Unescape Escape