本番のDocker Composeを組む — 決めることは8つある

本番のDocker Compose。コンテナを載せたサーバーと8個のチェック欄のある点検表、鍵と工具。

※本記事はアフィリエイト広告(PR)を含みます。

本番のComposeで決めることは8つあります。開発用のまま持っていかないための項目を並べます。

前回: DockerでCIのテストを回す — 手元では通るのにCIで落ちる

これは【深掘り】の記事です。本線の順路ではありません。 読まなくても先へ進めます。 本線の 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台で運用する限り、ホストが落ちたら全部止まること。そこから先はオーケストレータの仕事になること

この記事でやること

  1. 8項目の点検表を先に作り、以降はそれを1つずつ埋めていく
  2. イメージのタグをダイジェスト(@sha256:...)で固定し、latest との違いを確かめる
  3. trivy を実際に走らせて脆弱性の件数を見る。ゼロにならないことを確認して、付き合い方を決める
  4. ログの上限を設定せずにディスクを食わせ、実際にサイズを測ってから上限を入れる
  5. -e で渡した秘密が docker inspect で見えることを確認し、ファイル経由に置き換える
  6. 8項目が全部入った compose.yaml を組み上げて、更新と復旧を実際にやる

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
タグイメージ名の後ろの :1.27-alpine の部分。ただの別名で、あとから別のイメージに付け替えられる
ダイジェストイメージの中身から計算した値(sha256: で始まる長い16進数)。中身が1バイト違えば別の値になる
レジストリイメージを置いておく倉庫。Docker Hub や、自分で立てたレジストリのこと
脆弱性(CVE)ソフトウェアの弱点に付けられた世界共通の番号。CVE-2024-1234 の形
ログドライバコンテナの標準出力をどこに書くかを決める仕組み。既定は json-file(ホストのファイル)
capabilityroot が持つ権限を細かく分けたもの。「時刻を変えてよい」「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 を全文で出します。

「開発での既定値」の列に注目してください。 どれも明示的に選んだものではありません。 書かなかった結果そうなっているだけです。本番で怖いのは、間違った設定ではなく、選んでいない設定です。

練習場を作ります。

bash
$ mkdir -p ~/prodlab && cd ~/prodlab
$ pwd
/home/ubuntu/prodlab

② 決めごと1: イメージ — latest を本番で使わない

latest は「最新」ではない

まず、よくある誤解を潰します。

bash
$ docker pull nginx
$ docker images nginx
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 が半年前の版を指しているイメージもあります。

問題はここです。

bash
$ docker inspect --format '{{.Id}}' nginx:latest
sha256:3b25b682ea82b2b0dfb8b6e0aaea7a3ba7bfa0dc0e0b0b2e4c...

この nginx:latest が指す中身は、来週には別物になります。 タグは貼り替えられるラベルだからです。同じ compose.yaml を、今日と来月で docker compose pull すると、違うものが起動します。

これは「常に最新で安全」ではありません。「いつ何に変わるか自分で決められない」ということです。設定ファイルの場所が変わったり、既定のユーザーが変わったり、依存ライブラリの版が上がったりします。動かなくなったとき、自分は何も変えていないので原因が分かりません。

タグを固定する

第一段階は、具体的なタグを書くことです。

bash
$ docker pull nginx:1.27-alpine
$ docker images nginx
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バイトも変えたくないなら、ダイジェストで指定します。

自分が今持っているイメージのダイジェストを取ります。

bash
$ docker inspect --format '{{index .RepoDigests 0}}' nginx:1.27-alpine
nginx@sha256:1234abcd5678ef90...(64文字の16進数が続く)

この値は自分の環境で実際に取ってください。 記事に書いてある値をコピーしても意味がありません。ダイジェストはイメージごとに違います。

この形で指定すると、タグが貼り替えられても、指すものは変わりません。

bash
$ docker pull nginx@sha256:ここに自分で取った値を貼る

RepoDigests が空で返ることがあります。

bash
$ docker inspect --format '{{index .RepoDigests 0}}' myapp:dev
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 を使います。

bash
$ docker manifest inspect nginx:1.27-alpine | head -5

どこから取るか

「どのイメージか」と同じくらい「どこから取るか」が決めごとです。

取得元性質注意
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_タグとダイジェスト.png docker images nginx で latest と 1.27-alpine が別物として並んでいる画面と、docker inspect --format '{{index .RepoDigests 0}}' nginx:1.27-alpine の結果を、続けて撮ってください。

点検表 1行目「イメージ」の答え: タグを必ず書く。本番はダイジェストで固定する。取得元は自分の管理下に写す。


③ 脆弱性を調べる — ゼロにはならない

「安全なイメージを使いましょう」と書かれた記事は山ほどあります。では、自分が今使っているイメージは安全なのでしょうか。 測らないと分かりません。

イメージを小さくする回で「小さいほど攻撃対象が減る」と書きました。あれは推測でした。 今回は件数を数えます。

道具は2つある

道具入手性質
docker scoutDocker Desktop に同梱。Linux では別途プラグインを入れるDocker 公式。Docker Hub のアカウントが要ることがある
trivyAqua Security 製。コンテナとして実行できる単体で完結する。CI に入れやすい

まず docker scout が使えるか確認します。

bash
$ docker scout version
docker: 'scout' is not a docker command.

素の Ubuntu に docker-ce を入れただけでは、scout は入っていません。 Docker Desktop には同梱されていますが、この記事の環境(VMの Ubuntu Server)には無いのが普通です。入っている人はこう打てます。

bash
$ docker scout quickview nginx:1.27-alpine

入っていない場合は trivy を使います。 こちらはコンテナとして走らせられるので、ホストに何も入れずに済みます。

trivy を実際に走らせる

bash
$ docker run --rm \
    -v trivycache:/root/.cache/ \
    aquasec/trivy:latest image nginx:1.27-alpine

初回はデータベースの取得に時間がかかります(数分・数百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

件数と中身は、実行した日によって必ず変わります。 上は形を見せるための例です。自分の環境で出た件数を見てください。

比較のために、大きいイメージも測ります。

bash
$ docker run --rm -v trivycache:/root/.cache/ \
    aquasec/trivy:latest image --severity HIGH,CRITICAL nginx:1.27
Total: 24 (HIGH: 21, CRITICAL: 3)

alpine 版が3件、Debian 版が24件でした。 イメージを小さくする回で「小さいと攻撃対象が減る」と書いたことが、やっと数字になりました。 入っているパッケージが少なければ、報告される弱点も少ない。当たり前ですが、当たり前を数えると判断に使えます。

ゼロにはならない

ここが一番大事なところです。どのイメージを選んでも、件数はゼロになりません。

理由は3つあります。

  1. 修正版がまだ無い(Fixed が空欄のもの)。直しようがない
  2. その脆弱性が、自分の使い方では発動しない。libxml2 の弱点は、XMLを読まないアプリには関係ない
  3. 明日また増える。新しい CVE は毎日出る。今日ゼロでも明日は違う

だから「ゼロにする」は目標になりません。 代わりに、こう決めます。

決めることこの記事での決め方
どの深刻度を見るかHIGH と CRITICAL だけ見る。LOW は追わない
直せるものだけ見るか--ignore-unfixed を付けて、修正版があるものだけに絞る
いつ調べるかイメージを作るときと、週に1回。動いているものも対象
出たらどうするかベースイメージを更新して作り直す。これがほぼ唯一の対処

絞った形で走らせます。

bash
$ docker run --rm -v trivycache:/root/.cache/ \
    aquasec/trivy:latest image \
    --severity HIGH,CRITICAL --ignore-unfixed \
    nginx:1.27-alpine
Total: 1 (HIGH: 1, CRITICAL: 0)

24件が1件になりました。 減ったのは危険が減ったからではありません。「今、自分に打てる手がある件数」に絞ったからです。この1件は、ベースイメージを新しくすれば消えます。

--ignore-unfixed は「無視する」ではなく「今は手がない」という意味です。 修正版が出たら現れます。消したのではなく、待ち行列に移しただけだと理解してください。

CI で落とすなら、終了コードを使います。

bash
$ docker run --rm -v trivycache:/root/.cache/ \
    aquasec/trivy:latest image \
    --severity CRITICAL --ignore-unfixed --exit-code 1 \
    nginx:1.27-alpine
$ echo "終了コード: $?"
終了コード: 0

CRITICAL で修正版があるものが1件でもあれば、終了コードが 1 になります。 GitHub Actions の回でやった形で、そのままビルドを止められます。

最初から --severity HIGH で --exit-code 1 にしないでください。 毎回落ちて、誰も見なくなります。 CRITICAL から始めて、通るようになってから厳しくするほうが続きます。

自分でビルドしたイメージを調べる

レジストリに無いイメージは、Docker の中を見に行く必要があります。

bash
$ docker run --rm \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v trivycache:/root/.cache/ \
    aquasec/trivy:latest image 自分のイメージ名:タグ

/var/run/docker.sock を渡すのは、そのコンテナに「Dockerを操作する全権」を渡すのと同じです。 実質的に root を渡しています。手元の検証では便利ですが、本番のサーバーで常時動かすものには絶対に渡さないでください。

スクリーンショットを撮ってください: 02_trivyの件数.png trivy を 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 は起動しなくなる

実際に踏みます。

bash
$ docker run --rm --cap-drop ALL --user 101:101 nginx:1.27-alpine
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番を使う版が公開されています。

bash
$ docker pull nginxinc/nginx-unprivileged:1.27-alpine
$ docker run -d --name prod-web \
    --user 101:101 \
    --cap-drop ALL \
    --security-opt no-new-privileges:true \
    --read-only \
    --tmpfs /tmp \
    --tmpfs /var/cache/nginx \
    --tmpfs /var/run \
    -p 127.0.0.1:8080:8080 \
    nginxinc/nginx-unprivileged:1.27-alpine
$ docker ps --filter name=prod-web --format '{{.Status}}'
Up 3 seconds

起動しました。 中を確認します。

bash
$ docker exec prod-web id
uid=101(nginx) gid=101(nginx) groups=101(nginx)
bash
$ curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/
200

root ではなく、書き込みもできず、capability も無い状態で、ちゃんと応答しています。

効いていることを確かめる

設定したつもりで効いていないのが一番危険なので、確認します。

bash
$ docker exec prod-web sh -c 'touch /usr/share/nginx/html/x 2>&1'
touch: /usr/share/nginx/html/x: Read-only file system
bash
$ docker inspect --format '{{.HostConfig.CapDrop}} / {{.HostConfig.SecurityOpt}} / {{.HostConfig.ReadonlyRootfs}}' prod-web
[ALL] / [no-new-privileges:true] / true

docker inspect で確認する癖を付けてください。 compose.yaml に書いたつもりで、インデントを間違えて効いていないことがあります。書いたことではなく、動いているものを見ます。

外から見えないことも確認します。

bash
$ ss -tlnp | grep 8080
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 のカーネルが「どのプロセスを終わらせるか」を判断します。 選ばれるのが原因のコンテナとは限りません。関係ないデータベースが落ちることがあります。

bash
$ docker inspect --format 'メモリ上限: {{.HostConfig.Memory}} / CPU上限: {{.HostConfig.NanoCpus}}' prod-web
メモリ上限: 0 / CPU上限: 0

0 は「無制限」です。 本番では埋めます。

指定意味決め方
mem_limitメモリの上限平常時の実測 × 2 程度から始める
cpusCPU の上限1台に載せる数から逆算。1.0 で1コア分
pids_limitプロセス数の上限プロセスを無限に作られることへの保険。100〜200

上限は「余裕を持って大きく」ではなく「実測して決める」ものです。 大きすぎると意味が無く、小さすぎると平常時に落とされます。

実測します。

bash
$ docker stats --no-stream prod-web
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 の実測から決める。


⑥ ログ — 設定しないとディスクを食い尽くす

冒頭で書いた「ディスクが埋まった」の正体がこれです。 実際に再現します。

まず、ログがどこにあるか見る

bash
$ docker inspect --format '{{.LogPath}}' prod-web
/var/lib/docker/containers/a1b2c3.../a1b2c3...-json.log

コンテナの標準出力は、ホストのこのファイルに書かれています。 サイズを見ます。

bash
$ sudo du -h "$(docker inspect --format '{{.LogPath}}' prod-web)"
8.0K    /var/lib/docker/containers/a1b2c3.../a1b2c3...-json.log

今は 8KB です。問題は、このファイルに上限が無いことです。

bash
$ docker info --format 'ログドライバ: {{.LoggingDriver}}'
ログドライバ: json-file

既定の json-file には、既定のサイズ上限がありません。 世代交代もしません。アプリが出し続ければ、ディスクが埋まるまで書き続けます。

実際に食わせる

上限なしのコンテナを作って、ログを大量に吐かせます。

bash
$ docker run -d --name log-bad alpine sh -c \
    'i=0; while [ $i -lt 200000 ]; do echo "$i これはログの1行です。実際のアプリはもっと長い行を出します。"; i=$((i+1)); done; sleep 3600'

十数秒待ってから測ります。

bash
$ docker ps --filter name=log-bad --format '{{.Status}}'
$ sudo du -h "$(docker inspect --format '{{.LogPath}}' log-bad)"
Up 12 seconds
15M     /var/lib/docker/containers/b2c3d4.../b2c3d4...-json.log

20万行で 15MB です。 これはたった十数秒の出力です。 毎秒1000行出すアプリなら、1日で 6GB を超えます。 ログを出しているだけでサーバーが止まります。

docker logs で読めるものは、全部このファイルです。 つまり「ログをたくさん出すアプリ」は、それだけでディスクを消費します。

上限を付ける

bash
$ docker rm -f log-bad
$ docker run -d --name log-good \
    --log-opt max-size=1m --log-opt max-file=3 \
    alpine sh -c \
    'i=0; while [ $i -lt 200000 ]; do echo "$i これはログの1行です。実際のアプリはもっと長い行を出します。"; i=$((i+1)); done; sleep 3600'

同じだけ待って測ります。今度はファイルが複数に分かれるので、フォルダごと測ります。

bash
$ sudo du -sh "$(dirname "$(docker inspect --format '{{.LogPath}}' log-good)")"
$ sudo ls -lh "$(dirname "$(docker inspect --format '{{.LogPath}}' log-good)")" | grep json.log
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つ、本番で決めることがあります。アプリがログを「自分でファイルに書く」設定になっていないかです。

bash
$ docker exec prod-web ls -l /var/log/nginx/
lrwxrwxrwx 1 root root 11 access.log -> /dev/stdout
lrwxrwxrwx 1 root root 11 error.log -> /dev/stderr

公式イメージは、ログファイルを標準出力へのリンクにしています。 これが正解の形です。

コンテナの中のファイルにログを書くと、3つの問題が起きます。

  1. コンテナを作り直すと消える(ボリュームの回でやった、書き込み可能レイヤーの話です)
  2. docker logs で読めない
  3. read_only: true にすると、書けなくて起動しない

アプリは標準出力に出す。集めるのはホスト側の仕事。 これがコンテナでの原則です(モノリスと12 Factor の回でも同じことを言っています)。

どこへ送るか

json-file 以外にも送り先を選べます。

bash
$ docker info --format '{{.Plugins.Log}}'
[awslogs fluentd gcplogs gelf journald json-file local splunk syslog]
ドライバどこへ使いどころ
json-fileホストのファイル既定。上限を必ず付ける
localホストのファイル(圧縮あり)既定で上限がある。1台運用ならこれも良い
journaldsystemd のジャーナルsystemd の回でやった journalctl で読める
syslog / fluentd / gelf別のサーバーログを1画面にまとめる場合はこちら

fluentd などの「外へ送る」ドライバは、ドライバ自身では読み返せません。 いまの Docker Engine は既定で手元に控え(dual logging)を残すので docker logs でも読めますが、控えの量には上限があり、cache-disabled で切ると読めなくなります。「障害のときにどうやって読むか」を決めてから選んでください。

この記事の1台構成では、json-file + 上限にします。ログを外へ送るのは、ログを1画面にする回の話です。

上限はホスト全体の既定値としても設定できます。 Docker の設定ファイルに書くと、書き忘れたコンテナにも効きます。 効果が大きい割に、忘れられがちです。

bash
$ cat /etc/docker/daemon.json 2>/dev/null || echo "(ファイルが無い)"

書く内容はこの形です(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: 監視 — 起動しているのと、応答できるのは別

プロセスが生きていても、応答しないことがある

bash
$ docker ps --filter name=prod-web --format '{{.Names}} {{.Status}}'
prod-web Up 5 minutes

Up は「プロセスが動いている」という意味しかありません。 中で処理が詰まっていても、データベースに繋がらなくなっていても、Up です。

「応答できるか」を判定するのがヘルスチェックです。 作り直して付けます。

bash
$ docker rm -f prod-web
$ docker run -d --name prod-web \
    --user 101:101 --cap-drop ALL --read-only \
    --tmpfs /tmp --tmpfs /var/cache/nginx --tmpfs /var/run \
    -p 127.0.0.1:8080:8080 \
    --health-cmd 'wget -q -O /dev/null http://127.0.0.1:8080/ || exit 1' \
    --health-interval 10s \
    --health-timeout 3s \
    --health-retries 3 \
    --health-start-period 5s \
    nginxinc/nginx-unprivileged:1.27-alpine

判定を見ます。

bash
$ docker ps --filter name=prod-web --format '{{.Names}} {{.Status}}'
prod-web Up 8 seconds (health: starting)

15秒ほど待ってからもう一度。

bash
$ docker ps --filter name=prod-web --format '{{.Names}} {{.Status}}'
prod-web Up 20 seconds (healthy)

healthy に変わりました。 判定の履歴も残ります。

bash
$ docker inspect --format '{{json .State.Health}}' prod-web | head -c 400

4つの値の意味

指定意味間違えやすいところ
interval何秒ごとに確認するか短すぎると負荷になる。10〜30秒
timeout何秒待って応答が無ければ失敗とするかinterval より長くしない
retries何回連続で失敗したら unhealthy にするか1にすると、一瞬の詰まりで落ちる。3以上
start_period起動直後の猶予。この間の失敗は数えないこれが無いと、起動が遅いDBが必ず落ちる

start_period を書き忘れるのが、一番多い事故です。 MySQL は起動に十数秒から1分かかります(ボリュームの回で踏みました)。start_period が無いと、まだ準備中の間に3回失敗して unhealthy になります。

わざと壊して確かめる

ヘルスチェックは「失敗するところ」を見ないと、書いたつもりで終わります。

bash
$ docker exec prod-web sh -c 'kill -QUIT 1' 2>/dev/null
$ docker ps -a --filter name=prod-web --format '{{.Names}} {{.Status}}'
prod-web Exited (0) 3 seconds ago

止まりました。そして起き上がってきません。 --restart を付けていないからです。

落ちたら戻る形

ヘルスチェックと再起動は、セットで初めて意味があります。

bash
$ docker rm -f prod-web
$ docker run -d --name prod-web \
    --restart unless-stopped \
    --user 101:101 --cap-drop ALL --read-only \
    --tmpfs /tmp --tmpfs /var/cache/nginx --tmpfs /var/run \
    -p 127.0.0.1:8080:8080 \
    --health-cmd 'wget -q -O /dev/null http://127.0.0.1:8080/ || exit 1' \
    --health-interval 10s --health-timeout 3s \
    --health-retries 3 --health-start-period 5s \
    nginxinc/nginx-unprivileged:1.27-alpine

落とします。

bash
$ docker exec prod-web sh -c 'kill -QUIT 1' 2>/dev/null
$ docker ps --filter name=prod-web --format '{{.Names}} {{.Status}}'
prod-web Up 2 seconds (health: starting)

勝手に戻ってきました。 何回戻ったかも数えられます。

bash
$ docker inspect --format '再起動回数: {{.RestartCount}}' prod-web
再起動回数: 1

always ではなく unless-stopped を選びます。 違いはdocker run の回で確かめたとおりで、人が docker stop したものを、ホスト再起動で勝手に起こすかどうかです。メンテナンスで止めたものが、再起動で復活してくるのは事故です。

ヘルスチェックは自動では直さない

ここは誤解しやすいところです。

unhealthy になっても、Docker は何もしません。 再起動もしません。状態が unhealthy と表示されるだけです。

仕組みやってくれること
restart: unless-stoppedプロセスが終了したら起こし直す
healthcheck応答できるかを判定して表示する
両方合わせてもunhealthy のまま動き続けるコンテナは、放置される

では healthcheck は何のためにあるのか。 2つです。

  1. Compose の depends_on で「相手が応答できるようになるまで待つ」ため(後述)
  2. 監視の道具が「異常」と判定する材料にするため

「unhealthy になったら通知する」は、Docker の外の仕事です。 Prometheus の回で立てたものが、これを拾います。Docker だけで完結すると思わないでください。

点検表 5行目「監視」の答え: healthcheck で応答を判定し、restart: unless-stopped で落ちたら戻す。unhealthy の通知は外の仕組みに任せる。


⑧ 秘密情報 — -e で渡さない

見えることを確かめる

docker run の回でも触れましたが、本番の話としてもう一度、実物で確認します。

bash
$ docker run -d --name secret-bad \
    -e MYSQL_ROOT_PASSWORD=Sup3rSecret \
    -e API_KEY=sk-abcdef123456 \
    alpine sleep 3600
$ docker inspect secret-bad --format '{{range .Config.Env}}{{println .}}{{end}}'
MYSQL_ROOT_PASSWORD=Sup3rSecret
API_KEY=sk-abcdef123456
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

平文です。 そしてこれは、そのコンテナを止めても残ります(docker inspect はコンテナが存在する限り読めます)。

さらに、コンテナの中からも読めます。

bash
$ docker exec secret-bad env | grep -i key
API_KEY=sk-abcdef123456

アプリが乗っ取られたら、環境変数は全部読まれます。 それだけではありません。

どこから漏れるか誰に見えるか
docker inspectdocker を打てる人全員(実質そのサーバーの管理者全員)
docker ps --no-trunc同上(-e の値は出ないが、コンテナに渡したコマンドの引数は全文出る)
シェルの履歴 ~/.bash_historyそのユーザー
コンテナ内の子プロセス中で動く全プロセス
クラッシュレポート・ログ環境変数をまとめて吐く仕組みは多い

「環境変数だから安全」は、どこから来た話なのか分かりません。 何も隠れていません。

ファイル経由に置き換える

まともな仕組みは「ファイルとして渡して、権限で守る」です。

bash
$ mkdir -p ~/prodlab/secrets
$ cd ~/prodlab
$ (umask 077; openssl rand -base64 24 > secrets/db_root_password)
$ chmod 600 secrets/db_root_password
$ ls -l secrets/
-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

後述の最終形で起動したあとに、こう確認できます。

bash
$ docker compose exec db sh -c 'ls -l /run/secrets/'
$ docker compose exec db printenv MYSQL_ROOT_PASSWORD_FILE
-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 ファイル + .gitignoreGit に載る事故だけ防げる
○Compose の secrets: + chmod 600そのサーバーの他ユーザーから守れる
◎Swarm / Kubernetes の secrets配布経路が管理される
◎◎外部の秘密管理(Vault・クラウドの仕組み)サーバーに置かない。取りに行く

どの段階でも「Git に平文で入れない」は絶対です。 これは秘密情報の回でやった SOPS と age の話に繋がります。暗号化してから Git に置くのが、1台運用での現実解です。

.gitignore を必ず置きます。

bash
$ cd ~/prodlab
$ printf 'secrets/\n.env\n' > .gitignore
$ cat .gitignore
secrets/
.env

.gitignore は「まだ追跡されていないファイル」にしか効きません。 一度コミットしたものは、書いても対象外のままです。 そしてGit の履歴に入った秘密は、消したつもりでも履歴に残ります。 漏れたらそのパスワードを変えるしかありません。

点検表 6行目「秘密情報」の答え: -e に値を書かない。ファイルで渡して chmod 600。Git には暗号化してから置く。


⑨ 決めごと5: 更新 — 止めてから起動しない

一番やってはいけない更新

(これはやりません。説明のためだけに書いています)
docker compose down
docker compose pull
docker compose up -d

この順番だと、pull にかかる時間ぶん、まるごと止まります。 イメージが大きければ数分です。しかも、pull に失敗したら戻すものがありません。

正しい順番

「新しいものを用意してから、切り替える」が原則です。

bash
$ cd ~/prodlab
$ docker compose pull
[+] Pulling 2/2
 web Pulled
 db  Pulled

この時点では、まだ何も止まっていません。 動いているコンテナはそのままです。

bash
$ docker compose ps --format 'table {{.Name}}\t{{.Status}}'
NAME            STATUS
prodlab-db-1    Up 10 minutes (healthy)
prodlab-web-1   Up 10 minutes (healthy)

新しいイメージが手元に揃ってから、切り替えます。

bash
$ docker compose up -d
[+] 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つだけ入れ替えたいときは、こう書きます。

bash
$ docker compose up -d --no-deps web

--no-deps を付けないと、depends_on で繋がっている相手も対象になります。 web を更新したいだけなのに db が再起動する、という事故を防げます。

ダウンタイムを短くする考え方

Recreated の間は、そのサービスは応答しません。 短くする方法は3つあります。

方法やることどれだけ短くなるか
先に pull しておくdocker compose pull を別に打つ数分 → 数秒。効果が一番大きい
起動を速くする中で npm install などをしない。イメージに焼いておく数十秒 → 数秒
入れ替えを重ねる新しいのを起動して healthy を待ってから、古いのを止めるゼロにできる

3つ目は、Compose 単体では素直に書けません。考え方だけ書きます。

  1. 新しいイメージで、別の名前のコンテナを起動する
  2. healthy になるまで待つ(ここが healthcheck の使いどころです)
  3. 前段のリバースプロキシの向き先を、新しいほうへ変える
  4. 古いコンテナを止めて消す

これを手でやると、必ず手順を飛ばします。 そして自動でやる仕組みが、まさにオーケストレータの中心機能です。「Kubernetes は何をしてくれるのか」の答えの1つが、これです。

戻せることを先に用意する

更新の手順に「戻す手順」が付いていなければ、それは更新ではなく賭けです。

ダイジェストで固定していれば、戻すのは「前のダイジェストに書き換えて up -d」だけです。タグ運用だと、「前に動いていたのがどれか」が分かりません。 ここで②のダイジェストが効いてきます。

bash
$ docker compose images
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

この出力を、更新のたびにファイルに残してください。 これが「戻し先」です。

bash
$ cd ~/prodlab
$ docker compose images > deployed-$(date +%Y%m%d-%H%M).txt
$ ls *.txt

点検表 7行目「更新」の答え: 先に pull、あとから up -d。入れ替わるのは変わったサービスだけ。戻し先を毎回記録する。


⑩ 決めごと6: 復旧 — 戻せることが本番の条件

本線のデプロイと運用の回で「公開の前に、戻せることを確かめる」と書きました。 ここではコンテナの文脈で、具体的に何を戻せればいいのかを3つに分けます。

戻すものは3種類ある

種類中身どう戻すか
データボリュームの中身(DB・アップロードされたファイル)バックアップから復元。これしか手が無い
プログラムイメージレジストリから取り直す。ダイジェストで指定
構成compose.yaml・nginx の設定Git から取り直す。秘密情報は別

この3つのうち、失うと本当に終わるのは「データ」だけです。 他の2つは作り直せます。だからバックアップの話は、実質データの話です。

データのバックアップ

ボリュームの回でやった形を、本番の手順として書き直します。

bash
$ cd ~/prodlab
$ mkdir -p backup
$ docker compose exec -T db sh -c \
    'mysqldump -uroot -p"$(cat /run/secrets/db_root_password)" --all-databases --single-transaction' \
    | gzip > backup/db-$(date +%Y%m%d-%H%M).sql.gz
$ ls -lh backup/
-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 で見えます。

復元を実際にやる

取っただけのバックアップは、バックアップではありません。 戻せることを確かめて、初めてバックアップです。

bash
$ docker compose exec -T db sh -c \
    'mysql -uroot -p"$(cat /run/secrets/db_root_password)" -e "DROP DATABASE IF EXISTS app;"'
$ docker compose exec -T db sh -c \
    'mysql -uroot -p"$(cat /run/secrets/db_root_password)" -e "SHOW DATABASES;"'
Database
information_schema
mysql
performance_schema
sys

app が消えました。 戻します。

bash
$ gunzip -c backup/db-*.sql.gz | docker compose exec -T db sh -c \
    'mysql -uroot -p"$(cat /run/secrets/db_root_password)"'
$ docker compose exec -T db sh -c \
    'mysql -uroot -p"$(cat /run/secrets/db_root_password)" -e "SHOW DATABASES;"'
Database
app
information_schema
mysql
performance_schema
sys

戻りました。 この「壊して戻す」を、実際に一度やっていないバックアップは信用できません。

手順書を1枚置く

復旧は、動揺しているときにやる作業です。 そのとき考えて手順を組み立てるのは無理です。

bash
$ cd ~/prodlab
$ cat > RECOVERY.md <<'EOF'
  # 復旧手順(このサーバーが飛んだとき)
  
  ## 用意するもの
  - backup/db-*.sql.gz (別のマシンにも置いてあること)
  - secrets/ の中身 (暗号化して別管理。ここには無い)
  - compose.yaml (Git から取る)
  
  ## 手順
  1. 新しいホストに Docker を入れる
  2. Git から compose.yaml と設定を取ってくる
  3. secrets/ を復元して chmod 600・sudo chown 999:999 にする
  4. docker compose pull   ← ダイジェスト固定なので同じ中身が来る
  5. docker compose up -d
  6. db が healthy になるのを待つ
  7. gunzip -c backup/db-最新.sql.gz を db の mysql に流し込む
  8. curl で 200 が返ることを確認する
  
  ## まだ確認していないこと
  - backup/ の別マシンへの複製は、いまは手動
  EOF
$ head -5 RECOVERY.md

バックアップを同じサーバーに置いていたら、意味がありません。 ホストが飛べば一緒に飛びます。別のマシンか、別のサービスに複製するところまでが「バックアップ」です。

「まだ確認していないこと」を正直に書いてください。 手順書で一番危険なのは、やっていないことが、やったように書かれていることです。

点検表 8行目「復旧」の答え: データ・プログラム・構成の3つに分け、データはバックアップして復元を実演する。手順書を1枚置き、バックアップは別の場所へ。


⑪ 1台で運用する限界

ここまでの8項目を全部埋めても、埋まらないものが1つ残ります。

bash
$ docker ps --format 'table {{.Names}}\t{{.Status}}'

このコンテナは全部、同じ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 を書いても無視されます)。

bash
$ cd ~/prodlab
$ mkdir -p secrets backup html
$ echo '<h1>prodlab</h1>' > html/index.html
$ umask 077
$ openssl rand -base64 24 > secrets/db_root_password
$ openssl rand -base64 24 > secrets/db_app_password
$ chmod 600 secrets/db_root_password secrets/db_app_password
$ sudo chown 999:999 secrets/db_root_password secrets/db_app_password
$ ls -ln secrets/
-rw------- 1 999 999 33 db_app_password
-rw------- 1 999 999 33 db_root_password

ダイジェストを取ります。ここで出た値を、次の compose.yaml に貼ります。

bash
$ docker pull nginxinc/nginx-unprivileged:1.27-alpine
$ docker pull mysql:8.0
$ docker inspect --format '{{index .RepoDigests 0}}' nginxinc/nginx-unprivileged:1.27-alpine
$ docker inspect --format '{{index .RepoDigests 0}}' mysql:8.0

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 のときと同じ手順です。

起動します。

bash
$ cd ~/prodlab
$ docker compose config --quiet && echo "構文OK"
$ docker compose up -d
構文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 だけでは足りない」と書いた、その答えがこれです。

確認します。

bash
$ docker compose ps --format 'table {{.Name}}\t{{.Status}}'
$ curl -s -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:8080/
NAME            STATUS
prodlab-db-1    Up 2 minutes (healthy)
prodlab-web-1   Up 1 minute (healthy)
HTTP 200

点検表を埋め直す

書いたことではなく、動いているものを見ます。

bash
$ docker inspect prodlab-web-1 --format '非root: {{.Config.User}}
  読取専用: {{.HostConfig.ReadonlyRootfs}}
  権限: {{.HostConfig.CapDrop}}
  昇格禁止: {{.HostConfig.SecurityOpt}}
  メモリ: {{.HostConfig.Memory}}
  ログ: {{.HostConfig.LogConfig.Type}} {{.HostConfig.LogConfig.Config}}
  再起動: {{.HostConfig.RestartPolicy.Name}}
  健康: {{.State.Health.Status}}'
非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_点検表の確認.png docker 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のデータは本当に消えます。

bash
$ cd ~/prodlab
$ docker compose down -v
$ docker compose ps -a

単体で起動したコンテナを消します。

bash
$ docker rm -f prod-web secret-bad log-bad log-good 2>/dev/null
$ docker ps -a

trivy のキャッシュ用ボリュームを消します(数百MBあります)。

bash
$ docker volume rm trivycache
$ docker volume ls

イメージを消します(他で使っていなければ)。

bash
$ docker rmi nginxinc/nginx-unprivileged:1.27-alpine mysql:8.0 nginx:1.27-alpine nginx:1.27 nginx:latest alpine aquasec/trivy:latest 2>/dev/null
$ docker images

秘密のファイルごと、練習場を消します。

bash
$ rm -rf ~/prodlab
$ ls ~

空き容量を確認します。

bash
$ docker system df
$ df -h /

本線で作ったものが無事か確認します。

bash
$ ls ~/server ~/hitokoto 2>/dev/null

ログの既定値を /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行のうち何行が埋まっているか数えるところから始めてください。


参考リンク


この段階の確認

【深掘り】Docker は、ここで終わりです。 次に進む前に、答えを見ずに試してください。

読み終えた直後は、たいてい「分かった気」になっています。 手が動くかどうかは別です。

説明できますか

  1. EXPOSE を書いてもポートが開かないのはなぜか
  2. 行の順番でビルド時間が変わるのはなぜか
  3. コンテナの中の localhost が繋がらないのは、なぜ当然なのか

手が動きますか

  • 1.2GBのイメージを、50MB台まで小さくする
  • ボリュームを使い、コンテナを消してもデータが残ることを確かめる
  • depends_on を書いても落ちる状況を作り、直す

1つでも詰まったら、飛ばした回があります。 そこへ戻ってください。戻るのは後退ではありません。 戻り先の目安: Dockerfileの回 / レイヤーキャッシュの回 / ボリュームの回 / Composeの依存の回

全部答えられたなら、次の段階へ進んでください。


次に読む

この記事は 【深掘り】Docker の 11 / 11 本目です。

記事
← 前の記事DockerでCIのテストを回す — 手元では通るのにCIで落ちる
→ 次の記事JSXの正体 — ただの関数呼び出しだった

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Docker — Production
  • タグ固定・脆弱性検査・非root・読み取り専用
  • ログ上限・healthcheck・秘密情報・更新と復旧

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次