ENTRYPOINTとCMDの違いは何ですか？

Question

Accepted Answer

**ENTRYPOINT** と **CMD** はどちらもコンテナ起動時に実行される内容を定義しますが、異なる役割を果たし、特定の方法で相互作用します。その違い（および2つの形式— exec形式 vs shell形式）を理解することは、正しく動作するDockerfileを書くために重要です。

## CMD — デフォルトコマンド（上書き可能）

```dockerfile
CMD ["node", "server.js"]
# → the DEFAULT command when the container starts
# → but it's REPLACED if you pass a command at run time:
#   docker run myapp echo hello   → runs "echo hello" INSTEAD of node server.js
```

`CMD` は **デフォルトコマンド** を提供し、`docker run` で指定されたコマンドによって **完全に上書き** されます。

## ENTRYPOINT — 固定実行ファイル

```dockerfile
ENTRYPOINT ["node", "server.js"]
# → ALWAYS runs; run-time arguments are APPENDED (not replacing it):
#   docker run myapp --port 8080   → runs "node server.js --port 8080"
# → makes the container behave like a specific executable
```

`ENTRYPOINT` は **固定実行ファイル** を設定し、常に実行されます。実行時の引数は、それを置き換えるのではなく、その引数として **追記** されます。

## 組み合わせて使用する（一般的なパターン）

```dockerfile
ENTRYPOINT ["node", "server.js"]   # the fixed command
CMD ["--port", "3000"]              # DEFAULT arguments (overridable)
# docker run myapp                  → node server.js --port 3000 (defaults)
# docker run myapp --port 8080      → node server.js --port 8080 (CMD overridden)
→ ENTRYPOINT = the command; CMD = default arguments you can override. A clean pattern.
```

## Exec形式 vs Shell形式

```text
EXEC form  → CMD ["node", "server.js"]  (JSON array) — PREFERRED:
  runs the executable DIRECTLY (PID 1) → receives signals (SIGTERM) → graceful shutdown
SHELL form → CMD node server.js  → runs via /bin/sh -c → the shell is PID 1,
  the app may NOT receive signals properly (shutdown issues) → avoid for the main process
```

## なぜ重要なのか

ENTRYPOINTとCMDの違いを理解することは、**正しく動作するDockerfileを書く** ために重要であり、実践的で価値のある知識であり、一般的に混同されるトピックです。

動作の区別が重要です。**CMD** は `docker run` に渡されたコマンドによって **完全に上書き** されるデフォルトコマンドを提供し、**ENTRYPOINT** は常に実行される固定実行ファイルを設定し、実行時の引数がそれに **追記** される — これらの異なる動作はコンテナが実行時の引数にどのように応答するかに影響します。

**組み合わせて使用する一般的なパターン** を理解すること（`ENTRYPOINT` をコマンドとして、`CMD` を上書き可能なデフォルト引数として使用する）は、クリーンで慣用的なアプローチであり、コンテナを設定可能な実行ファイルのように動作させます — これは広く使われている手法であり、知る価値があります。

重要なことに、**exec形式 vs shell形式** を理解することは正確性のために重要です。**exec形式**（JSONの配列、例：`CMD ["node", "server.js"]`）が推奨されるのは、実行ファイルを **PID 1として直接実行** するため、**SIGTERMなどのシグナルを適切に受け取る** ことができ、**グレースフルシャットダウン** を可能にするからです — 一方、**shell形式**（`CMD node server.js`）はシェル経由で実行され、シェルがPID 1になるため、アプリケーションが **シャットダウンシグナルを正しく受け取れない** ことが多く（グレースフルでない終了、進行中の作業の喪失、遅いシャットダウンにつながる）。

このシグナルハンドリング/グレースフルシャットダウンの問題は、exec形式が回避する実際の微妙な問題です。

コンテナ起動時に実行される内容を定義することはすべてのDockerfileの基本であり、ENTRYPOINT/CMDの区別（およびexec形式 vs shell形式のシグナルハンドリング上の懸念）はコンテナの動作と正確性（引数処理、グレースフルシャットダウン）に直接影響するため、ENTRYPOINT vs CMDを理解すること — それらの役割、どのように組み合わせるか、そして重要なexec形式のシグナル実装の実践 — は価値のある実践的なDocker知識であり、一般的に誤解されているトピックであり、その違いを理解することは実際の動作とシャットダウンのバグを防ぐことができます。