※本記事はアフィリエイト広告(PR)を含みます。
本番のComposeで決めることは8つあります。開発用のまま持っていかないための項目を並べます。
これは【深掘り】の記事です。本線の順路ではありません。 読まなくても先へ進めます。 本線の Composeなら1コマンド — 複数コンテナをまとめる の続きとして、そこで書いた compose.yaml をそのまま本番に置いたら何が起きるかを、1つずつ潰していく回です。
この記事のコマンドは、すべてVMの中(Ubuntu Server)で打ちます。 Windows の PowerShell では打ちません。 前提: Dockerの導入を終えて、
docker psとdocker compose versionがsudoなしで通ること。 本線で作ったものには触りません。 練習用に~/prodlabを新しく作って、そこだけで完結させます。~/serverや~/hitokotoには一切触りません。 ディスクを 2GB ほど使います。 最後の「後片づけ」で全部消します。
本線のComposeの回で、こういう compose.yaml を書きました。
services:
web:
image: nginx
ports:
- "80:80"
db:
image: mysql
environment:
MYSQL_ROOT_PASSWORD: password
手元では完璧に動きます。 そしてこれを本番のサーバーに置いてはいけません。
私は一度、これに近いものを検証用のVPSに置いて1週間放置しました。起きたことは3つです。
- ディスクが埋まった。 原因はコンテナのログでした。誰も上限を設定していなかったからです
docker compose pullしたら、動くはずのものが動かなくなった。image: nginxはnginx:latestです。中身が別物に入れ替わっていました- パスワードが
docker inspectで普通に読めた。 サーバーに入れる人には、全員見えていました
このどれも「Dockerの不具合」ではありません。 決めていなかっただけです。
開発の compose.yaml と本番の compose.yaml の差は、機能の差ではありません。決めごとの数の差です。そして決めることは、数えると 8つあります。
対象レベル: 中級〜上級 / 区分: 発展
この記事でわかること
- 開発と本番の差は「決めごとの数」であること。決めることは イメージ・実行・資源・ログ・監視・秘密情報・更新・復旧の8つしかない
latestは「最新」という意味ではなく、ただの既定のタグ名であること。同じlatestが、来週には別のイメージを指す- 脆弱性の件数はゼロにならないこと。ゼロを目指すのではなく、どれを見て、どれを見送るかを決める作業だということ
- ログの上限を決めないと、コンテナは無限にディスクを食うこと。既定の
json-fileに上限は無い -eで渡した秘密情報はdocker inspectで誰でも読めること。環境変数は隠し場所ではない- 1台で運用する限り、ホストが落ちたら全部止まること。そこから先はオーケストレータの仕事になること
この記事でやること
- 8項目の点検表を先に作り、以降はそれを1つずつ埋めていく
- イメージのタグをダイジェスト(
@sha256:...)で固定し、latestとの違いを確かめる trivyを実際に走らせて脆弱性の件数を見る。ゼロにならないことを確認して、付き合い方を決める- ログの上限を設定せずにディスクを食わせ、実際にサイズを測ってから上限を入れる
-eで渡した秘密がdocker inspectで見えることを確認し、ファイル経由に置き換える- 8項目が全部入った
compose.yamlを組み上げて、更新と復旧を実際にやる
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| タグ | イメージ名の後ろの :1.27-alpine の部分。ただの別名で、あとから別のイメージに付け替えられる |
| ダイジェスト | イメージの中身から計算した値(sha256: で始まる長い16進数)。中身が1バイト違えば別の値になる |
| レジストリ | イメージを置いておく倉庫。Docker Hub や、自分で立てたレジストリのこと |
| 脆弱性(CVE) | ソフトウェアの弱点に付けられた世界共通の番号。CVE-2024-1234 の形 |
| ログドライバ | コンテナの標準出力をどこに書くかを決める仕組み。既定は json-file(ホストのファイル) |
| capability | root が持つ権限を細かく分けたもの。「時刻を変えてよい」「1024未満のポートを開いてよい」などが別々になっている |
| ヘルスチェック | 「動いているか」を定期的に確認する仕組み。プロセスが生きていることと、応答できることは別 |
| オーケストレータ | 複数台のサーバーにコンテナを配置し、落ちたら別の台へ移す仕組み。Kubernetes や Swarm のこと |
① まず点検表を作る — 決めることは8つ
本番に出す前に、この8行を埋めます。 埋まっていない行があるなら、まだ出せません。
| # | 決めること | 決めていないと何が起きるか | 開発での既定値 |
|---|---|---|---|
| 1 | イメージ — どこから、どれを取るか | ある日、別の中身に入れ替わる | latest(=毎回変わりうる) |
| 2 | 実行 — 誰の権限で、何を許すか | 侵入されたときの被害が最大になる | root・書き込み自由・全権限 |
| 3 | 資源 — CPU・メモリ・プロセス数の上限 | 1つのコンテナがホストごと巻き込む | 無制限 |
| 4 | ログ — どこに、どれだけ残すか | ディスクが埋まってホストが止まる | json-file・上限なし |
| 5 | 監視 — 生きているかをどう判定するか | 「起動しているのに応答しない」に気づけない | なし |
| 6 | 秘密情報 — どうやって渡すか | docker inspect で全員に見える | -e に平文 |
| 7 | 更新 — どう入れ替えるか | 止めてから起動するまで落ちたままになる | 手で down して up |
| 8 | 復旧 — 壊れたときにどう戻すか | 戻せない | なし |
この記事は、以降この8行を上から順に潰していきます。 最後に、8つ全部が入った compose.yaml を全文で出します。
「開発での既定値」の列に注目してください。 どれも明示的に選んだものではありません。 書かなかった結果そうなっているだけです。本番で怖いのは、間違った設定ではなく、選んでいない設定です。
練習場を作ります。
/home/ubuntu/prodlab
② 決めごと1: イメージ — latest を本番で使わない
latest は「最新」ではない
まず、よくある誤解を潰します。
REPOSITORY TAG IMAGE ID CREATED SIZE
nginx latest 3b25b682ea82 2 weeks ago 192MB
docker pull nginx は docker pull nginx:latest と同じです。タグを省略すると latest が補われます。
latest は Docker が特別扱いする名前ではありません。 「タグを書かなかったときに補われる文字列」という以上の意味はありません。latest タグを持たないイメージも普通にありますし、latest が半年前の版を指しているイメージもあります。
問題はここです。
sha256:3b25b682ea82b2b0dfb8b6e0aaea7a3ba7bfa0dc0e0b0b2e4c...
この nginx:latest が指す中身は、来週には別物になります。 タグは貼り替えられるラベルだからです。同じ compose.yaml を、今日と来月で docker compose pull すると、違うものが起動します。
これは「常に最新で安全」ではありません。「いつ何に変わるか自分で決められない」ということです。設定ファイルの場所が変わったり、既定のユーザーが変わったり、依存ライブラリの版が上がったりします。動かなくなったとき、自分は何も変えていないので原因が分かりません。
タグを固定する
第一段階は、具体的なタグを書くことです。
REPOSITORY TAG IMAGE ID CREATED SIZE
nginx 1.27-alpine a1f2c3d4e5f6 3 weeks ago 52.5MB
nginx latest 3b25b682ea82 2 weeks ago 192MB
別物として並びました。 タグを書く粒度には段階があります。
| 書き方 | 何が固定されるか | 使いどころ |
|---|---|---|
nginx | 何も固定されない | 使わない |
nginx:1 | メジャー版だけ | 使わない(マイナー更新で壊れうる) |
nginx:1.27 | マイナー版まで | パッチ更新は自動で入る。許容できるなら可 |
nginx:1.27-alpine | 版とベースOS | 最低ライン。ここまでは必ず書く |
nginx:1.27-alpine@sha256:... | 中身そのもの | 本番の推奨 |
nginx:1.27-alpine でも、まだ中身は変わります。 1.27.1 から 1.27.2 へ、あるいは同じ版でもベースOSのパッチ当てで作り直されます。タグはあくまで別名です。この記事の nginx:1.27・mysql:8.0 は書いた時点の版で、どちらもすでに更新が止まっています(MySQL 8.0 は 2026年4月30日に保守終了)。実際に使うときは、公式の現行版(MySQL なら 8.4 など)に置き換えてください。
ダイジェストで中身そのものを指す
中身を1バイトも変えたくないなら、ダイジェストで指定します。
自分が今持っているイメージのダイジェストを取ります。
nginx@sha256:1234abcd5678ef90...(64文字の16進数が続く)
この値は自分の環境で実際に取ってください。 記事に書いてある値をコピーしても意味がありません。ダイジェストはイメージごとに違います。
この形で指定すると、タグが貼り替えられても、指すものは変わりません。
RepoDigests が空で返ることがあります。
Template parsing error: template: :1:2: executing "" at <index .RepoDigests 0>: error calling index: reflect: slice index out of range
これは「ローカルでビルドしたイメージ」か、「pull せずに作られたイメージ」です。 ダイジェストはレジストリに置かれたときに決まるので、まだ一度も push / pull していないイメージには存在しません。自分でビルドしたイメージにダイジェストを付けたいなら、レジストリに push する必要があります。
pull せずにダイジェストだけ調べたいときは、manifest を使います。
どこから取るか
「どのイメージか」と同じくらい「どこから取るか」が決めごとです。
| 取得元 | 性質 | 注意 |
|---|---|---|
| Docker Hub の公式イメージ | nginx mysql のように名前空間が無いもの | 無料枠に取得回数の制限がある。CIから何度も引くと止まる |
| Docker Hub の一般ユーザーのイメージ | ユーザー名/イメージ名 の形 | 誰でも上げられる。中身の保証は無い |
| ベンダーの公式レジストリ | ghcr.io/... などの別の場所 | 公式が Docker Hub 以外に置いていることがある |
| 自分で立てたレジストリ | レジストリの回で立てたもの | 外部に落ちても動く。管理の手間は自分持ち |
本番のサーバーが Docker Hub に取りに行けなくなったら、コンテナを作り直せません。 これは実際に起きます(レート制限・障害・イメージの削除)。「復旧」の項目(決めごと8)と直結します。
この記事では公式イメージを使いますが、本番で長く動かすものは、自分のレジストリに写しを持つのが安全です。
# 考え方(この記事では実行しません)
# docker pull nginx:1.27-alpine
# docker tag nginx:1.27-alpine registry.example.internal/nginx:1.27-alpine
# docker push registry.example.internal/nginx:1.27-alpine
スクリーンショットを撮ってください:
01_タグとダイジェスト.pngdocker images nginxでlatestと1.27-alpineが別物として並んでいる画面と、docker inspect --format '{{index .RepoDigests 0}}' nginx:1.27-alpineの結果を、続けて撮ってください。
点検表 1行目「イメージ」の答え: タグを必ず書く。本番はダイジェストで固定する。取得元は自分の管理下に写す。
③ 脆弱性を調べる — ゼロにはならない
「安全なイメージを使いましょう」と書かれた記事は山ほどあります。では、自分が今使っているイメージは安全なのでしょうか。 測らないと分かりません。
イメージを小さくする回で「小さいほど攻撃対象が減る」と書きました。あれは推測でした。 今回は件数を数えます。
道具は2つある
| 道具 | 入手 | 性質 |
|---|---|---|
docker scout | Docker Desktop に同梱。Linux では別途プラグインを入れる | Docker 公式。Docker Hub のアカウントが要ることがある |
trivy | Aqua Security 製。コンテナとして実行できる | 単体で完結する。CI に入れやすい |
まず docker scout が使えるか確認します。
docker: 'scout' is not a docker command.
素の Ubuntu に docker-ce を入れただけでは、scout は入っていません。 Docker Desktop には同梱されていますが、この記事の環境(VMの Ubuntu Server)には無いのが普通です。入っている人はこう打てます。
入っていない場合は trivy を使います。 こちらはコンテナとして走らせられるので、ホストに何も入れずに済みます。
trivy を実際に走らせる
初回はデータベースの取得に時間がかかります(数分・数百MB)。-v trivycache:/root/.cache/ はそのデータベースを名前付きボリュームに残すためです(ボリュームの回でやった形です)。付けないと毎回ゼロから落とし直します。
nginx:1.27-alpine (alpine 3.20.3)
Total: 3 (UNKNOWN: 0, LOW: 0, MEDIUM: 2, HIGH: 1, CRITICAL: 0)
Library Vulnerability Severity Status Installed Fixed
libexpat CVE-2024-45491 HIGH fixed 2.6.2-r0 2.6.3-r0
libxml2 CVE-2024-56171 MEDIUM affected 2.12.7-r0
openssl CVE-2024-9143 MEDIUM fixed 3.3.2-r0 3.3.2-r1
件数と中身は、実行した日によって必ず変わります。 上は形を見せるための例です。自分の環境で出た件数を見てください。
比較のために、大きいイメージも測ります。
Total: 24 (HIGH: 21, CRITICAL: 3)
alpine 版が3件、Debian 版が24件でした。 イメージを小さくする回で「小さいと攻撃対象が減る」と書いたことが、やっと数字になりました。 入っているパッケージが少なければ、報告される弱点も少ない。当たり前ですが、当たり前を数えると判断に使えます。
ゼロにはならない
ここが一番大事なところです。どのイメージを選んでも、件数はゼロになりません。
理由は3つあります。
- 修正版がまだ無い(
Fixedが空欄のもの)。直しようがない - その脆弱性が、自分の使い方では発動しない。
libxml2の弱点は、XMLを読まないアプリには関係ない - 明日また増える。新しい CVE は毎日出る。今日ゼロでも明日は違う
だから「ゼロにする」は目標になりません。 代わりに、こう決めます。
| 決めること | この記事での決め方 |
|---|---|
| どの深刻度を見るか | HIGH と CRITICAL だけ見る。LOW は追わない |
| 直せるものだけ見るか | --ignore-unfixed を付けて、修正版があるものだけに絞る |
| いつ調べるか | イメージを作るときと、週に1回。動いているものも対象 |
| 出たらどうするか | ベースイメージを更新して作り直す。これがほぼ唯一の対処 |
絞った形で走らせます。
Total: 1 (HIGH: 1, CRITICAL: 0)
24件が1件になりました。 減ったのは危険が減ったからではありません。「今、自分に打てる手がある件数」に絞ったからです。この1件は、ベースイメージを新しくすれば消えます。
--ignore-unfixed は「無視する」ではなく「今は手がない」という意味です。 修正版が出たら現れます。消したのではなく、待ち行列に移しただけだと理解してください。
CI で落とすなら、終了コードを使います。
終了コード: 0
CRITICAL で修正版があるものが1件でもあれば、終了コードが 1 になります。 GitHub Actions の回でやった形で、そのままビルドを止められます。
最初から --severity HIGH で --exit-code 1 にしないでください。 毎回落ちて、誰も見なくなります。 CRITICAL から始めて、通るようになってから厳しくするほうが続きます。
自分でビルドしたイメージを調べる
レジストリに無いイメージは、Docker の中を見に行く必要があります。
/var/run/docker.sock を渡すのは、そのコンテナに「Dockerを操作する全権」を渡すのと同じです。 実質的に root を渡しています。手元の検証では便利ですが、本番のサーバーで常時動かすものには絶対に渡さないでください。
スクリーンショットを撮ってください:
02_trivyの件数.pngtrivyをnginx:1.27とnginx:1.27-alpineの両方に対して走らせ、Total の件数が違うところを撮ってください。数字は違って構いません。
点検表 1行目の補足: 脆弱性はゼロにしない。「深刻度」と「修正版の有無」で絞り、対処はベースイメージの更新。
④ 決めごと2: 実行 — 本番の既定値を表にする
ここでやることは、docker run の回でやったことの回収です。 あそこでは「こういうオプションがある」を1つずつ確かめました。ここでは「本番では最初から全部付ける」という既定値にまとめます。
本番の既定値
| 指定 | 何をするか | なぜ既定値にするか |
|---|---|---|
user: "101:101" | root で動かさない | 侵入されても、コンテナ内で root を取られない |
read_only: true | ファイルシステムを書けなくする | ファイルを置かれない・書き換えられない |
tmpfs: | 書く必要がある場所だけをメモリに逃がす | read_only を成立させるため |
cap_drop: [ALL] | capability を全部落とす | root の権限を細分化したものを、まとめて捨てる |
security_opt: [no-new-privileges:true] | 途中で権限が上がるのを禁止 | setuid された実行ファイルで昇格されない |
ports: "127.0.0.1:8080:8080" | 外から直接叩けなくする | 前にリバースプロキシを置く前提 |
この6つを「書かないと本番に出せないもの」と決めます。 --user と --read-only を1つずつ壊して確かめる作業はdocker run の回でやったので、ここでは本番で必ずぶつかる1点だけを実機で潰します。
権限を落とすと、普通の nginx は起動しなくなる
実際に踏みます。
nginx: [emerg] mkdir() "/var/cache/nginx/client_temp" failed (13: Permission denied)
起動しませんでした。 ただし、原因はポートではありません(版によっては /var/run/nginx.pid が開けないというエラーになります)。
いまの Docker(20.10 以降)では、80番を開くのに CAP_NET_BIND_SERVICE は要りません。 コンテナの中で1024未満のポートも非rootで開けるよう設定されているからです。落ちた原因は、普通の nginx イメージが root で動く前提で、/var/cache/nginx などの書き込み先に書けないことです。
対処は2つあります。
| 対処 | 書き方 | 評価 |
|---|---|---|
| root で動かす | user: と cap_drop を外す | 動くが、権限を落とした意味が無い |
| 非root用のイメージを使う | 非rootで8080番で待つイメージを使う | こちらが本筋 |
コンテナの中のポート番号は、外から見える番号と関係ありません。 ports: "80:8080" と書けば、外は80番・中は8080番です。中を80番にする理由がありません。
nginx には、最初から非rootで8080番を使う版が公開されています。
Up 3 seconds
起動しました。 中を確認します。
uid=101(nginx) gid=101(nginx) groups=101(nginx)
200
root ではなく、書き込みもできず、capability も無い状態で、ちゃんと応答しています。
効いていることを確かめる
設定したつもりで効いていないのが一番危険なので、確認します。
touch: /usr/share/nginx/html/x: Read-only file system
[ALL] / [no-new-privileges:true] / true
docker inspect で確認する癖を付けてください。 compose.yaml に書いたつもりで、インデントを間違えて効いていないことがあります。書いたことではなく、動いているものを見ます。
外から見えないことも確認します。
LISTEN 0 4096 127.0.0.1:8080 0.0.0.0:*
127.0.0.1: を付けていないと 0.0.0.0:8080 になり、VMの外から直接叩けます。 ufw で開けたのに繋がらない回で見たとおり、Docker はファイアウォールより手前で穴を開けます。 ufw で塞いだつもりが塞がっていないのは、これが理由です。-p の左側にアドレスを書くのが確実です。
点検表 2行目「実行」の答え: 非root・読み取り専用・capability 全捨て・昇格禁止・待ち受けは localhost。この5つを既定値にする。
⑤ 決めごと3: 資源 — 1つのコンテナでホストを巻き込まない
これもdocker run の回で確かめた内容です。本番の視点だけ足します。
上限を決めない場合、コンテナはホストのメモリを全部使えます。 そしてメモリが尽きると、Linux のカーネルが「どのプロセスを終わらせるか」を判断します。 選ばれるのが原因のコンテナとは限りません。関係ないデータベースが落ちることがあります。
メモリ上限: 0 / CPU上限: 0
0 は「無制限」です。 本番では埋めます。
| 指定 | 意味 | 決め方 |
|---|---|---|
mem_limit | メモリの上限 | 平常時の実測 × 2 程度から始める |
cpus | CPU の上限 | 1台に載せる数から逆算。1.0 で1コア分 |
pids_limit | プロセス数の上限 | プロセスを無限に作られることへの保険。100〜200 |
上限は「余裕を持って大きく」ではなく「実測して決める」ものです。 大きすぎると意味が無く、小さすぎると平常時に落とされます。
実測します。
CONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O
a1b2c3d4e5f6 prod-web 0.00% 3.512MiB / 3.822GiB 0.09% 1.1kB / 0B
LIMIT がホスト全体のメモリになっています。 これが「無制限」の状態です。3.5MiB しか使っていないので、128m で十分だと分かります。
docker stats は今の瞬間しか見えません。 本番で上限を決めるなら、数日ぶんの推移が要ります。それは監視の回で立てた Prometheus の仕事です。この記事では「上限を書く欄がある」ことだけ押さえます。
点検表 3行目「資源」の答え: mem_limit / cpus / pids_limit を必ず書く。値は docker stats の実測から決める。
⑥ ログ — 設定しないとディスクを食い尽くす
冒頭で書いた「ディスクが埋まった」の正体がこれです。 実際に再現します。
まず、ログがどこにあるか見る
/var/lib/docker/containers/a1b2c3.../a1b2c3...-json.log
コンテナの標準出力は、ホストのこのファイルに書かれています。 サイズを見ます。
8.0K /var/lib/docker/containers/a1b2c3.../a1b2c3...-json.log
今は 8KB です。問題は、このファイルに上限が無いことです。
ログドライバ: json-file
既定の json-file には、既定のサイズ上限がありません。 世代交代もしません。アプリが出し続ければ、ディスクが埋まるまで書き続けます。
実際に食わせる
上限なしのコンテナを作って、ログを大量に吐かせます。
十数秒待ってから測ります。
Up 12 seconds
15M /var/lib/docker/containers/b2c3d4.../b2c3d4...-json.log
20万行で 15MB です。 これはたった十数秒の出力です。 毎秒1000行出すアプリなら、1日で 6GB を超えます。 ログを出しているだけでサーバーが止まります。
docker logs で読めるものは、全部このファイルです。 つまり「ログをたくさん出すアプリ」は、それだけでディスクを消費します。
上限を付ける
同じだけ待って測ります。今度はファイルが複数に分かれるので、フォルダごと測ります。
3.2M /var/lib/docker/containers/c3d4e5.../
-rw-r----- 1 root root 331K c3d4e5...-json.log
-rw-r----- 1 root root 1.0M c3d4e5...-json.log.1
-rw-r----- 1 root root 1.0M c3d4e5...-json.log.2
15MB が 3MB 弱で止まりました。 max-size=1m で1ファイル1MB、max-file=3 で3世代まで。それ以上は古いものから消えます。
上限を付けると、古いログは消えます。 これは失うものです。「消えて困るログ」は、消えない場所へ送る必要があります(後述)。
アプリにファイルを書かせない
もう1つ、本番で決めることがあります。アプリがログを「自分でファイルに書く」設定になっていないかです。
lrwxrwxrwx 1 root root 11 access.log -> /dev/stdout
lrwxrwxrwx 1 root root 11 error.log -> /dev/stderr
公式イメージは、ログファイルを標準出力へのリンクにしています。 これが正解の形です。
コンテナの中のファイルにログを書くと、3つの問題が起きます。
- コンテナを作り直すと消える(ボリュームの回でやった、書き込み可能レイヤーの話です)
docker logsで読めないread_only: trueにすると、書けなくて起動しない
アプリは標準出力に出す。集めるのはホスト側の仕事。 これがコンテナでの原則です(モノリスと12 Factor の回でも同じことを言っています)。
どこへ送るか
json-file 以外にも送り先を選べます。
[awslogs fluentd gcplogs gelf journald json-file local splunk syslog]
| ドライバ | どこへ | 使いどころ |
|---|---|---|
json-file | ホストのファイル | 既定。上限を必ず付ける |
local | ホストのファイル(圧縮あり) | 既定で上限がある。1台運用ならこれも良い |
journald | systemd のジャーナル | systemd の回でやった journalctl で読める |
syslog / fluentd / gelf | 別のサーバー | ログを1画面にまとめる場合はこちら |
fluentd などの「外へ送る」ドライバは、ドライバ自身では読み返せません。 いまの Docker Engine は既定で手元に控え(dual logging)を残すので docker logs でも読めますが、控えの量には上限があり、cache-disabled で切ると読めなくなります。「障害のときにどうやって読むか」を決めてから選んでください。
この記事の1台構成では、json-file + 上限にします。ログを外へ送るのは、ログを1画面にする回の話です。
上限はホスト全体の既定値としても設定できます。 Docker の設定ファイルに書くと、書き忘れたコンテナにも効きます。 効果が大きい割に、忘れられがちです。
書く内容はこの形です(JSONです。参考として表示のみ)。
{
"log-driver": "json-file",
"log-opts": { "max-size": "10m", "max-file": "3" }
}
これを変えたら sudo systemctl restart docker が要ります。 そして再起動すると動いているコンテナが止まります。 さらに既に動いているコンテナには適用されません(作り直しが要ります)。本番のサーバーでやるなら、止まってよい時間に。
スクリーンショットを撮ってください:
03_ログのサイズ比較.png上限なしのコンテナの-json.logが十数MBになっているduの結果と、max-size=1mを付けたほうが数MBで止まっている結果を、並べて撮ってください。
点検表 4行目「ログ」の答え: アプリは標準出力に出す。max-size と max-file を必ず書く。ホスト全体の既定にも入れる。
⑦ 決めごと4: 監視 — 起動しているのと、応答できるのは別
プロセスが生きていても、応答しないことがある
prod-web Up 5 minutes
Up は「プロセスが動いている」という意味しかありません。 中で処理が詰まっていても、データベースに繋がらなくなっていても、Up です。
「応答できるか」を判定するのがヘルスチェックです。 作り直して付けます。
判定を見ます。
prod-web Up 8 seconds (health: starting)
15秒ほど待ってからもう一度。
prod-web Up 20 seconds (healthy)
healthy に変わりました。 判定の履歴も残ります。
4つの値の意味
| 指定 | 意味 | 間違えやすいところ |
|---|---|---|
interval | 何秒ごとに確認するか | 短すぎると負荷になる。10〜30秒 |
timeout | 何秒待って応答が無ければ失敗とするか | interval より長くしない |
retries | 何回連続で失敗したら unhealthy にするか | 1にすると、一瞬の詰まりで落ちる。3以上 |
start_period | 起動直後の猶予。この間の失敗は数えない | これが無いと、起動が遅いDBが必ず落ちる |
start_period を書き忘れるのが、一番多い事故です。 MySQL は起動に十数秒から1分かかります(ボリュームの回で踏みました)。start_period が無いと、まだ準備中の間に3回失敗して unhealthy になります。
わざと壊して確かめる
ヘルスチェックは「失敗するところ」を見ないと、書いたつもりで終わります。
prod-web Exited (0) 3 seconds ago
止まりました。そして起き上がってきません。 --restart を付けていないからです。
落ちたら戻る形
ヘルスチェックと再起動は、セットで初めて意味があります。
落とします。
prod-web Up 2 seconds (health: starting)
勝手に戻ってきました。 何回戻ったかも数えられます。
再起動回数: 1
always ではなく unless-stopped を選びます。 違いはdocker run の回で確かめたとおりで、人が docker stop したものを、ホスト再起動で勝手に起こすかどうかです。メンテナンスで止めたものが、再起動で復活してくるのは事故です。
ヘルスチェックは自動では直さない
ここは誤解しやすいところです。
unhealthy になっても、Docker は何もしません。 再起動もしません。状態が unhealthy と表示されるだけです。
| 仕組み | やってくれること |
|---|---|
restart: unless-stopped | プロセスが終了したら起こし直す |
healthcheck | 応答できるかを判定して表示する |
| 両方合わせても | unhealthy のまま動き続けるコンテナは、放置される |
では healthcheck は何のためにあるのか。 2つです。
- Compose の
depends_onで「相手が応答できるようになるまで待つ」ため(後述) - 監視の道具が「異常」と判定する材料にするため
「unhealthy になったら通知する」は、Docker の外の仕事です。 Prometheus の回で立てたものが、これを拾います。Docker だけで完結すると思わないでください。
点検表 5行目「監視」の答え: healthcheck で応答を判定し、restart: unless-stopped で落ちたら戻す。unhealthy の通知は外の仕組みに任せる。
⑧ 秘密情報 — -e で渡さない
見えることを確かめる
docker run の回でも触れましたが、本番の話としてもう一度、実物で確認します。
MYSQL_ROOT_PASSWORD=Sup3rSecret
API_KEY=sk-abcdef123456
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
平文です。 そしてこれは、そのコンテナを止めても残ります(docker inspect はコンテナが存在する限り読めます)。
さらに、コンテナの中からも読めます。
API_KEY=sk-abcdef123456
アプリが乗っ取られたら、環境変数は全部読まれます。 それだけではありません。
| どこから漏れるか | 誰に見えるか |
|---|---|
docker inspect | docker を打てる人全員(実質そのサーバーの管理者全員) |
docker ps --no-trunc | 同上(-e の値は出ないが、コンテナに渡したコマンドの引数は全文出る) |
シェルの履歴 ~/.bash_history | そのユーザー |
| コンテナ内の子プロセス | 中で動く全プロセス |
| クラッシュレポート・ログ | 環境変数をまとめて吐く仕組みは多い |
「環境変数だから安全」は、どこから来た話なのか分かりません。 何も隠れていません。
ファイル経由に置き換える
まともな仕組みは「ファイルとして渡して、権限で守る」です。
-rw------- 1 ubuntu ubuntu 33 db_root_password
chmod 600 を必ず確認してください。 権限の回でやったとおり、644 だと同じサーバーの全ユーザーが読めます。
多くの公式イメージは _FILE 付きの環境変数に対応しています。
| 環境変数 | 意味 |
|---|---|
MYSQL_ROOT_PASSWORD=xxx | 値そのもの。docker inspect で見える |
MYSQL_ROOT_PASSWORD_FILE=/run/secrets/db_root_password | 値が書かれたファイルの場所。見えるのはパスだけ |
Compose の secrets: を使うと、そのファイルが /run/secrets/<名前> に読み取り専用で現れます。
services:
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD_FILE: /run/secrets/db_root_password
secrets:
- db_root_password
secrets:
db_root_password:
file: ./secrets/db_root_password
後述の最終形で起動したあとに、こう確認できます。
-rw------- 1 mysql mysql 33 db_app_password
-rw------- 1 mysql mysql 33 db_root_password
/run/secrets/db_root_password
inspect に出るのは「パス」だけで、中身は出ません。 これが目的です。
ただし、docker compose の secrets: はホストのファイルを見せているだけです。 Docker Swarm の secrets(暗号化して配る)とは別物です。ホストに入れる人には読めます。
どこまでやるかを決める
秘密情報の守り方には段階があります。 どこまでやるかは、そのサーバーに誰が入れるかで決まります。
| 段階 | やり方 | 守れる相手 |
|---|---|---|
| ❌ やらない | -e に平文 | 誰からも守れない |
| △ | .env ファイル + .gitignore | Git に載る事故だけ防げる |
| ○ | Compose の secrets: + chmod 600 | そのサーバーの他ユーザーから守れる |
| ◎ | Swarm / Kubernetes の secrets | 配布経路が管理される |
| ◎◎ | 外部の秘密管理(Vault・クラウドの仕組み) | サーバーに置かない。取りに行く |
どの段階でも「Git に平文で入れない」は絶対です。 これは秘密情報の回でやった SOPS と age の話に繋がります。暗号化してから Git に置くのが、1台運用での現実解です。
.gitignore を必ず置きます。
secrets/
.env
.gitignore は「まだ追跡されていないファイル」にしか効きません。 一度コミットしたものは、書いても対象外のままです。 そしてGit の履歴に入った秘密は、消したつもりでも履歴に残ります。 漏れたらそのパスワードを変えるしかありません。
点検表 6行目「秘密情報」の答え: -e に値を書かない。ファイルで渡して chmod 600。Git には暗号化してから置く。
⑨ 決めごと5: 更新 — 止めてから起動しない
一番やってはいけない更新
(これはやりません。説明のためだけに書いています)
docker compose down
docker compose pull
docker compose up -d
この順番だと、pull にかかる時間ぶん、まるごと止まります。 イメージが大きければ数分です。しかも、pull に失敗したら戻すものがありません。
正しい順番
「新しいものを用意してから、切り替える」が原則です。
[+] Pulling 2/2
web Pulled
db Pulled
この時点では、まだ何も止まっていません。 動いているコンテナはそのままです。
NAME STATUS
prodlab-db-1 Up 10 minutes (healthy)
prodlab-web-1 Up 10 minutes (healthy)
新しいイメージが手元に揃ってから、切り替えます。
[+] Running 2/2
Container prodlab-db-1 Running
Container prodlab-web-1 Recreated
docker compose up -d で入れ替わる範囲
ここが分かっていないと、更新のたびに不安になります。
docker compose up -d は、全部を作り直しません。 「今のコンテナの設定」と「compose.yaml から計算した設定」を比べて、違うものだけ作り直します。
| 状態 | 表示 | 何が起きるか |
|---|---|---|
| 設定もイメージも同じ | Running | 何もしない(止まらない) |
| イメージが変わった | Recreated | 消して作り直す(一瞬止まる) |
compose.yaml の該当箇所が変わった | Recreated | 同上 |
| 新しく増えた | Started | 起動する |
compose.yaml から消えた | 残る | --remove-orphans を付けないと消えない |
上の例では db は Running のまま、web だけ Recreated でした。関係ないサービスは止まりません。
Recreated は「消して作る」です。 つまり、コンテナの中に書いたものは消えます。 ボリュームの回でやったとおり、残したいものは必ずボリュームに出しておく必要があります。更新のたびに消えるかどうかで、ボリュームを付け忘れていないかが分かります。
1つだけ入れ替えたいときは、こう書きます。
--no-deps を付けないと、depends_on で繋がっている相手も対象になります。 web を更新したいだけなのに db が再起動する、という事故を防げます。
ダウンタイムを短くする考え方
Recreated の間は、そのサービスは応答しません。 短くする方法は3つあります。
| 方法 | やること | どれだけ短くなるか |
|---|---|---|
| 先に pull しておく | docker compose pull を別に打つ | 数分 → 数秒。効果が一番大きい |
| 起動を速くする | 中で npm install などをしない。イメージに焼いておく | 数十秒 → 数秒 |
| 入れ替えを重ねる | 新しいのを起動して healthy を待ってから、古いのを止める | ゼロにできる |
3つ目は、Compose 単体では素直に書けません。考え方だけ書きます。
- 新しいイメージで、別の名前のコンテナを起動する
healthyになるまで待つ(ここがhealthcheckの使いどころです)- 前段のリバースプロキシの向き先を、新しいほうへ変える
- 古いコンテナを止めて消す
これを手でやると、必ず手順を飛ばします。 そして自動でやる仕組みが、まさにオーケストレータの中心機能です。「Kubernetes は何をしてくれるのか」の答えの1つが、これです。
戻せることを先に用意する
更新の手順に「戻す手順」が付いていなければ、それは更新ではなく賭けです。
ダイジェストで固定していれば、戻すのは「前のダイジェストに書き換えて up -d」だけです。タグ運用だと、「前に動いていたのがどれか」が分かりません。 ここで②のダイジェストが効いてきます。
CONTAINER REPOSITORY TAG IMAGE ID SIZE
prodlab-db-1 mysql 8.0 abc123def456 586MB
prodlab-web-1 nginxinc/nginx-unprivileged 1.27-alpine def456abc123 52.5MB
この出力を、更新のたびにファイルに残してください。 これが「戻し先」です。
点検表 7行目「更新」の答え: 先に pull、あとから up -d。入れ替わるのは変わったサービスだけ。戻し先を毎回記録する。
⑩ 決めごと6: 復旧 — 戻せることが本番の条件
本線のデプロイと運用の回で「公開の前に、戻せることを確かめる」と書きました。 ここではコンテナの文脈で、具体的に何を戻せればいいのかを3つに分けます。
戻すものは3種類ある
| 種類 | 中身 | どう戻すか |
|---|---|---|
| データ | ボリュームの中身(DB・アップロードされたファイル) | バックアップから復元。これしか手が無い |
| プログラム | イメージ | レジストリから取り直す。ダイジェストで指定 |
| 構成 | compose.yaml・nginx の設定 | Git から取り直す。秘密情報は別 |
この3つのうち、失うと本当に終わるのは「データ」だけです。 他の2つは作り直せます。だからバックアップの話は、実質データの話です。
データのバックアップ
ボリュームの回でやった形を、本番の手順として書き直します。
-rw-rw-r-- 1 ubuntu ubuntu 189K db-20260923-1040.sql.gz
-T を付けないと、the input device is not a TTY で失敗します。 docker run の回でやった -t の話と同じで、パイプで繋ぐときに擬似端末は要りません。
--single-transaction を付けないと、ダンプ中の書き込みで中身が食い違います。 「バックアップは取れているが、復元すると壊れている」という一番つらい形になります。
パスワードをコマンド行に書いていないことに注目してください。 $(cat /run/secrets/...) でファイルから読んでいます。-p'パスワード' と書くと、ホストの ps で見えます。
復元を実際にやる
取っただけのバックアップは、バックアップではありません。 戻せることを確かめて、初めてバックアップです。
Database
information_schema
mysql
performance_schema
sys
app が消えました。 戻します。
Database
app
information_schema
mysql
performance_schema
sys
戻りました。 この「壊して戻す」を、実際に一度やっていないバックアップは信用できません。
手順書を1枚置く
復旧は、動揺しているときにやる作業です。 そのとき考えて手順を組み立てるのは無理です。
バックアップを同じサーバーに置いていたら、意味がありません。 ホストが飛べば一緒に飛びます。別のマシンか、別のサービスに複製するところまでが「バックアップ」です。
「まだ確認していないこと」を正直に書いてください。 手順書で一番危険なのは、やっていないことが、やったように書かれていることです。
点検表 8行目「復旧」の答え: データ・プログラム・構成の3つに分け、データはバックアップして復元を実演する。手順書を1枚置き、バックアップは別の場所へ。
⑪ 1台で運用する限界
ここまでの8項目を全部埋めても、埋まらないものが1つ残ります。
このコンテナは全部、同じ1台のホストの上にあります。 つまり、
ホストが落ちたら、全部止まります。 restart: unless-stopped も healthcheck も、ホストが動いていることが前提です。ホストが死んだら、誰も起こしてくれません。
| 落ちるもの | ここまでの仕組みで戻るか |
|---|---|
| コンテナのプロセス | 戻る(restart) |
| コンテナが応答しなくなった | 判定はできる。直すのは人 |
| Docker デーモン | systemd が起こす |
| ホストのOS | 戻らない |
| ホストのハードウェア | 戻らない |
| データセンターの区画 | 戻らない |
1台構成では、下の3つは「人が気づいて、別の場所で作り直す」しかありません。 ⑩の手順書は、まさにそのための紙です。
では、どうするのか。 答えは「台数を増やして、落ちた台の仕事を別の台へ移す仕組みを入れる」です。それがオーケストレータです。
| やりたいこと | 1台での答え | オーケストレータの答え |
|---|---|---|
| 落ちたら起こす | restart | 別の台で起こし直す |
| 応答しないものを外す | 人が見る | 自動で振り分け先から外す |
| 止めずに更新する | 手で入れ替える | 順に入れ替える仕組みが標準機能 |
| 秘密情報を配る | ファイル + 権限 | 配布経路ごと管理する仕組み |
この表の右側が、Kubernetes の回と3台クラスタの回でやったことです。 「Kubernetes は何のためにあるのか」が、ここでやっと繋がります。先に1台で全部やってみたから、何が足りないかが分かります。
ただし「だから Kubernetes を入れよう」ではありません。 Swarm という選択肢の回で見たとおり、1台で足りているなら、増やす理由がありません。 増えるのは運用の手間です。この記事の8項目を埋めた1台は、埋めていない3台より、ずっとまともです。
この記事の範囲は、ここまでです。 接続だけ示して、先へは進みません。
1 台の限界を越えて 2 台目を足すなら、VPS 側の機能も選択肢になります。クラウド VPS byGMO
は初期費用 0 円の定額制で、ローカル接続による複数台構成と、月間稼働率 99.99% の SLA を打ち出しています(2026-11 時点)。4GB プラン(仮想 4 コア・200GB)は 12 ヶ月契約で月額 2,618 円ですが、公式の表示月額とは別にサーチャージ費が毎月かかり、合計では月 3,927 円になります(税込)。
⑫ 8項目が全部入った compose.yaml
最後に、ここまでの決めごとを全部1枚にまとめます。 番号は点検表の番号です。
まず、置くファイルを揃えます。db は user: "999:999" で動かすので、秘密のファイルの持ち主も 999 にします。 ファイルから渡す secrets: は中でバインドマウントされ、ホスト側の持ち主と権限がそのまま見えるからです(uid・gid・mode を書いても無視されます)。
-rw------- 1 999 999 33 db_app_password
-rw------- 1 999 999 33 db_root_password
ダイジェストを取ります。ここで出た値を、次の compose.yaml に貼ります。
compose.yaml の全文です。
name: prodlab
services:
# ============================================
# Web(外向き。前段にリバースプロキシを置く前提)
# ============================================
web:
# (1) イメージ: タグ + ダイジェストで固定
# ⚠️ @sha256: の値は自分の環境で docker inspect して貼ること
image: nginxinc/nginx-unprivileged:1.27-alpine@sha256:ここに自分で取った値を貼る
# (2) 実行: 非root・読み取り専用・権限なし・昇格禁止
user: "101:101"
read_only: true
cap_drop:
- ALL
security_opt:
- no-new-privileges:true
tmpfs:
- /tmp
- /var/cache/nginx
- /var/run
# (2) 実行: 外から直接叩かせない(前段のプロキシ経由にする)
ports:
- "127.0.0.1:8080:8080"
volumes:
- ./html:/usr/share/nginx/html:ro
# (3) 資源: docker stats の実測から決める
mem_limit: 128m
cpus: 0.5
pids_limit: 100
# (4) ログ: 上限を必ず書く
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
# (5) 監視: 応答できるかを判定する
healthcheck:
test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8080/ || exit 1"]
interval: 30s
timeout: 3s
retries: 3
start_period: 5s
# (5) 監視: 落ちたら戻す(always ではなく unless-stopped)
restart: unless-stopped
depends_on:
db:
condition: service_healthy
networks:
- front
- back
# ============================================
# DB(外に出さない)
# ============================================
db:
# (1)
image: mysql:8.0@sha256:ここに自分で取った値を貼る
# (2) mysql の公式イメージの利用者番号は 999
user: "999:999"
cap_drop:
- ALL
cap_add:
- CHOWN
- SETGID
- SETUID
security_opt:
- no-new-privileges:true
# ⚠️ DB は read_only にしない(データを書くため)
# (2) ports は書かない = 外に出さない。back の中だけで話す
# (6) 秘密情報: 値ではなくファイルの場所を渡す
environment:
MYSQL_ROOT_PASSWORD_FILE: /run/secrets/db_root_password
MYSQL_DATABASE: app
MYSQL_USER: appuser
MYSQL_PASSWORD_FILE: /run/secrets/db_app_password
TZ: Asia/Tokyo
secrets:
- db_root_password
- db_app_password
# (8) 復旧: データはボリュームに出す(作り直しで消えない)
volumes:
- dbdata:/var/lib/mysql
# (3)
mem_limit: 1g
cpus: 1.0
pids_limit: 200
# (4)
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
# (5) ⚠️ start_period が無いと、起動中に unhealthy になる
healthcheck:
test: ["CMD-SHELL", "mysqladmin ping -h 127.0.0.1 --silent"]
interval: 15s
timeout: 5s
retries: 5
start_period: 60s
# (5)
restart: unless-stopped
networks:
- back
# (6) 秘密情報の実体(このファイル自体には値を書かない)
secrets:
db_root_password:
file: ./secrets/db_root_password
db_app_password:
file: ./secrets/db_app_password
# (8) データの置き場
volumes:
dbdata:
# (2) DB を外向きのネットワークに置かない
networks:
front:
back:
internal: true
back に internal: true を付けています。 ネットワークの回でやったとおり、これを付けるとそのネットワークだけに繋がっているコンテナは、外へ出られません。 DB がインターネットに出ていく必要はないので、塞ぎます。
DB では cap_drop: ALL のあとに3つ戻しています。 MySQL の公式イメージは起動時にデータ置き場の持ち主を直すため、CHOWN などが要ります。全部落とすと起動しません。 落として、落ちて、ログを読んで、必要なものだけ戻す。--read-only のときと同じ手順です。
起動します。
構文OK
[+] Running 4/4
Network prodlab_back Created
Network prodlab_front Created
Container prodlab-db-1 Healthy
Container prodlab-web-1 Started
docker compose config --quiet は、起動せずに構文と参照だけ確かめます。 本番では必ず先に打ちます。 インデント1つで意味が変わるので、これで弾けるものは弾いておきます。
db が Healthy になってから web が Started になっています。 depends_on の condition: service_healthy が効いています。Compose の深掘り回で「depends_on だけでは足りない」と書いた、その答えがこれです。
確認します。
NAME STATUS
prodlab-db-1 Up 2 minutes (healthy)
prodlab-web-1 Up 1 minute (healthy)
HTTP 200
点検表を埋め直す
書いたことではなく、動いているものを見ます。
非root: 101:101
読取専用: true
権限: [ALL]
昇格禁止: [no-new-privileges:true]
メモリ: 134217728
ログ: json-file map[max-file:3 max-size:10m]
再起動: unless-stopped
健康: healthy
| # | 決めごと | 埋まったか |
|---|---|---|
| 1 | イメージ | 済 — タグ + ダイジェスト固定。trivy で HIGH/CRITICAL を確認 |
| 2 | 実行 | 済 — 非root・読取専用・cap全捨て・昇格禁止・localhost 待ち受け |
| 3 | 資源 | 済 — mem_limit / cpus / pids_limit |
| 4 | ログ | 済 — 標準出力 + max-size / max-file |
| 5 | 監視 | 半分 — unhealthy の通知は、まだ無い |
| 6 | 秘密情報 | 済 — secrets: でファイル渡し。.gitignore 済み |
| 7 | 更新 | 済 — 先に pull → up -d。戻し先を記録 |
| 8 | 復旧 | 半分 — 別マシンへの複製は、まだ手動 |
「半分」が2つ残っています。 正直に書きます。「全部済」の点検表は、たいてい嘘です。 埋まっていない行は、埋まっていないと書いておくほうが、あとで自分を助けます。
スクリーンショットを撮ってください:
04_点検表の確認.pngdocker inspectで非root・読取専用・ログ上限・healthy が並んで表示されている画面を撮ってください。
つまずいたところ
--cap-drop ALL --user 101:101 を付けたら nginx が Permission denied で落ちた。 「セキュリティのために権限を落とす」を素直にやったら起動しなくなり、しばらく cap_add を1つずつ足して試しました。答えは cap_add ではなく、最初から非rootで動く8080番のイメージを使うことでした(80番を開けないのが原因だと思い込んでいましたが、いまの Docker では非rootでも80番は開けます)。 コンテナの中のポート番号を80にする理由が無いことに気づくのに時間がかかりました。「Webは80番」という習慣が抜けていませんでした。
mysql:8.0 に read_only: true を付けて起動しなくした。 read_only は良いものだと思って全部に付けました。データベースはデータを書くので、当然動きません。 tmpfs で逃がそうとして、/var/lib/mysql を tmpfs にしかけました。それをやると、再起動でデータが全部消えます。 危うく「原因不明でデータが消えるDB」を作るところでした。read_only は「書かないもの」に付けるものです。
healthcheck を付けたら、MySQL が毎回 unhealthy で止まった。 start_period を書いていませんでした。MySQL は初回起動でデータ置き場を作るため1分近くかかります。interval: 15s × retries: 5 = 75秒より、初期化のほうが長かったわけです。start_period は「起動が遅いもの」ほど大きく取る。 DB は 60s から始めました。
trivy の初回実行で、何も出ないまま数分固まった。 止まったと思って Ctrl+C を3回打ちました。脆弱性データベースを落としている最中でした。 途中で止めると、次も最初から落とし直します。 -v trivycache:/root/.cache/ を付けてから、2回目以降は数秒で終わるようになりました。
docker compose exec に -T を付けず、mysqldump の出力が壊れた。 the input device is not a TTY が出るときもあれば、エラーは出ないのに .sql.gz の末尾が切れているときもありました。後者が厄介で、復元しようとして初めて気づきます。 パイプに繋ぐ exec には必ず -T。 そして取ったバックアップは、必ず一度戻す。
秘密のファイルを作るとき umask を忘れて 644 になっていた。 openssl rand > secrets/xxx と打っただけだと、既定の権限で作られます。chmod 600 を後から打てば直りますが、「作った瞬間から他人に読めていた」時間が存在します。 umask 077 を先に打つ形に変えました。
docker compose down でボリュームも消えたと思い込んでいた。 消えていませんでした(ボリュームの回で確認済み)。逆方向の勘違いのほうが危険です。 -v を付けたらデータは本当に消えます。後片づけのコマンドをコピーする前に、対象を読んでください。
「本番でどうするか」を、動く前に決めようとして手が止まった。 8項目を全部きれいに設計してから作ろうとして、1週間何もできませんでした。順番が逆でした。 まず開発の形で動かして、動いたものに8項目を1つずつ足すほうが速い。 この記事の構成が、そのまま作業の順番です。
後片づけ
作ったものを全部消します。データも消えます。練習用なので構いませんが、コマンドの対象を必ず読んでください。
Compose のものを止めて消します。-v を付けるので、DBのデータは本当に消えます。
単体で起動したコンテナを消します。
trivy のキャッシュ用ボリュームを消します(数百MBあります)。
イメージを消します(他で使っていなければ)。
秘密のファイルごと、練習場を消します。
空き容量を確認します。
本線で作ったものが無事か確認します。
ログの既定値を /etc/docker/daemon.json に書いた人は、そのままで構いません。 ホスト全体に効く良い設定です。戻したい場合は、ファイルを消して sudo systemctl restart docker してください。 その再起動で、動いているコンテナは全部止まります。
まとめ — 理解できたこと
- 開発と本番の差は、機能の差ではなく決めごとの数の差。 決めることは イメージ・実行・資源・ログ・監視・秘密情報・更新・復旧の8つ
- 本番で怖いのは、間違った設定ではなく「選んでいない設定」。 書かなかった結果の既定値が、そのまま本番の設定になっている
latestは「最新」ではなく、タグを省略したときに補われる文字列。 中身は黙って入れ替わる。本番はダイジェストで固定する- 脆弱性の件数はゼロにならない。 深刻度と修正版の有無で絞り、対処はベースイメージの更新。CI では
CRITICALから止め始める - 普通の nginx は、非root・capability なしでは書き込み先に書けず起動しない(80番はいまの Docker なら開ける)。対処は権限を戻すことではなく、非rootで8080番を使うイメージにすること
json-fileに上限は無い。 20万行で 15MB。max-sizeとmax-fileを書かないと、ログだけでディスクが埋まる- アプリはログをファイルに書かない。標準出力に出す。 集めるのはホスト側の仕事
Upは「プロセスが動いている」以上の意味を持たない。 応答できるかはhealthcheckが判定する。start_periodを忘れると、起動の遅いDBが必ず落ちるunhealthyになっても Docker は何もしない。 再起動もしない。通知は Docker の外の仕事-eで渡した秘密はdocker inspectで全員に読める。 ファイルで渡してchmod 600。Git には暗号化してから- 更新は「先に pull、あとから切り替え」。
docker compose up -dは変わったサービスだけを作り直す。Recreatedはコンテナの中身を消す - 戻すものは3種類。 データ・プログラム・構成。失うと終わるのはデータだけなので、バックアップの話は実質データの話
- 復元を一度もやっていないバックアップは、バックアップではない
- 1台で運用する限り、ホストが落ちたら全部止まる。
restartもhealthcheckも、ホストが生きている前提。そこから先がオーケストレータの領分 - 点検表の全部に「済」が付いたら、たいてい嘘。 埋まっていない行は、埋まっていないと書いておく
【深掘り】Docker シリーズは、この記事で終わりです。 最初の回で「コンテナは軽い仮想マシンではない」と、名前空間と cgroups の話から始めました。そこから Dockerfile の1行ずつ、レイヤーキャッシュ、イメージの大きさ、ネットワーク、ボリューム、docker run の長い1行、Compose、そして本番の決めごとまで来ました。通して振り返ると、やっていたことは一貫して「書かなかったときに何が起きるか」を見ることでした。 EXPOSE を書いてもポートは開かない、-v を書かないとデータは消える、--restart を書かないと起き上がらない、max-size を書かないとディスクが埋まる。Docker は、書かなかったことを親切に補ってはくれません。 その代わり、書いたことは正確にやります。 だから、何を書かなかったかを自分で分かっていることが、そのまま運用できるかどうかの境目になります。この8項目の点検表は、そのための紙です。手元の compose.yaml を開いて、8行のうち何行が埋まっているか数えるところから始めてください。
参考リンク
- roadmap.sh — Docker
- Docker 公式 — Compose file reference
- Docker 公式 — Compose の services
- Docker 公式 — Compose の secrets
- Docker 公式 — ログドライバの設定
- Docker 公式 — json-file ログドライバ
- Docker 公式 — 資源の制限
- Docker 公式 — Docker Scout
- Trivy 公式ドキュメント
- Trivy のリポジトリ
- nginx 非root版の公式イメージ
- MySQL 公式イメージ
- The Twelve-Factor App — Logs
この段階の確認
【深掘り】Docker は、ここで終わりです。 次に進む前に、答えを見ずに試してください。
読み終えた直後は、たいてい「分かった気」になっています。 手が動くかどうかは別です。
説明できますか
EXPOSEを書いてもポートが開かないのはなぜか- 行の順番でビルド時間が変わるのはなぜか
- コンテナの中の
localhostが繋がらないのは、なぜ当然なのか
手が動きますか
- 1.2GBのイメージを、50MB台まで小さくする
- ボリュームを使い、コンテナを消してもデータが残ることを確かめる
depends_onを書いても落ちる状況を作り、直す
1つでも詰まったら、飛ばした回があります。 そこへ戻ってください。戻るのは後退ではありません。 戻り先の目安: Dockerfileの回 / レイヤーキャッシュの回 / ボリュームの回 / Composeの依存の回
全部答えられたなら、次の段階へ進んでください。
次に読む
この記事は 【深掘り】Docker の 11 / 11 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | DockerでCIのテストを回す — 手元では通るのにCIで落ちる |
| → 次の記事 | JSXの正体 — ただの関数呼び出しだった |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- タグ固定・脆弱性検査・非root・読み取り専用
- ログ上限・healthcheck・秘密情報・更新と復旧
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント