Dockerfileとは何か、またどのように書くのか？

Question

Accepted Answer

**Dockerfile**は、**Dockerイメージをビルド**するための命令が記述されたテキストファイルです。ベースイメージ、依存関係、コピーするファイル、アプリケーションの実行方法を記述し、イメージビルドの再現性とバージョン管理を可能にします。

## 基本的なDockerfile

```dockerfile
# FROM — the base image to build on
FROM node:20-alpine

# WORKDIR — set the working directory inside the image
WORKDIR /app

# COPY dependency files first (for better layer caching)
COPY package*.json ./
# RUN — execute a command during the BUILD (install dependencies)
RUN npm install

# COPY the rest of the application code
COPY . .

# EXPOSE — document the port the app listens on
EXPOSE 3000

# CMD — the command to run when a CONTAINER starts
CMD ["node", "server.js"]
```

## 主要な命令

```text
FROM     → the base image (starting point) — REQUIRED, usually first
WORKDIR  → set the working directory for subsequent instructions
COPY/ADD → copy files from the host into the image
RUN      → execute a command at BUILD time (install packages, compile) → creates a layer
ENV      → set environment variables
EXPOSE   → document which port(s) the container listens on
CMD      → the default command to run when the container STARTS (one per Dockerfile)
ENTRYPOINT → the executable that runs (CMD provides default args to it)
ARG      → build-time variables
```

## RUN vs CMD vs ENTRYPOINT（よく混同される）

```text
RUN        → runs at BUILD time (builds the image — e.g. install dependencies)
CMD        → runs at CONTAINER START (the default command; overridable at run)
ENTRYPOINT → the main executable at start (CMD becomes its default arguments)
→ RUN builds the image; CMD/ENTRYPOINT define what runs when it starts.
```

## なぜ重要なのか

Dockerfileを理解することは本質的に重要です。Dockerイメージはこれを使ってビルドされるため、Dockerfileの書き方は基本的で日々必要なDockerのスキルです。

Dockerfileは**再現性があり、バージョン管理可能なイメージビルド**を提供します。コード内にイメージの構築方法（ベースイメージ、依存関係、ファイル、設定、実行コマンド）を正確に記述することで、誰もが同じイメージを一貫してビルドでき、これはDockerの再現性という価値の中心です。

**主要な命令**を理解することが必要です。`FROM`（ベースイメージ）、`WORKDIR`、`COPY`（ファイルの取り込み）、`RUN`（依存関係のインストールなどのビルド時コマンド実行）、`ENV`、`EXPOSE`、および`CMD`/`ENTRYPOINT`（コンテナ起動時の実行内容定義）です。これらを理解することで、実際のアプリケーション向けの効果的なDockerfileが書けます。

特に重要で、よく混同される点は、**`RUN` vs `CMD` vs `ENTRYPOINT`**の区別です。`RUN`は**ビルド時**に実行され（イメージの構築、例：パッケージのインストール）、`CMD`/`ENTRYPOINT`は**コンテナ起動時**に実行される内容を定義します（アプリケーションコマンド）。この違いを理解することは、よくある間違いを防ぐために必須です。

実践的なパターン（例えば、レイヤーキャッシュを効果的に使うため、コード前に依存関係ファイルをコピーする）を知ることは、効率的なDockerfileの作成に反映されます。

イメージのビルドはDocker使用の基本であり（すべてのDockerワークフローはイメージを含み、カスタムイメージはDockerfileで構築されます）、命令を理解し、ビルド時と実行時の区別を理解することは、正確で効率的なイメージを作成するために必要なため、Dockerfileの理解は本質的で頻繁に適用されるDockerの知識です。これはDockerを使用するすべてのユーザーにとってのコアスキルであり、Dockerの再現性という約束を実践に変え、アプリケーションのコンテナ化のほぼ普遍的な要件です。