docker runのオプションが長くなって、毎回打つのがつらい- Web アプリと DB をまとめて起動・停止したい
compose.yamlのdepends_onやportsの書き方がよく分からない
僕は、Django・Next.js・PostgreSQL で作った Web アプリも、WordPress と MariaDB も、その前に置く nginx のリバースプロキシも、すべて Docker Compose で動かしています。コンテナが何個あっても、docker compose up -d の1行で起動できるからです。
この記事では、compose.yaml の書き方と、よく使う docker compose コマンドをまとめます。あわせて、僕の環境で使っている depends_on と healthcheck、.env、ポートを 127.0.0.1 に限る理由、restart と mem_limit の決め方も紹介します。
- macOS 27.2(Docker Desktop)
- Docker Engine 28.2.2、Docker Compose v2.36.2
- イメージ:python:3.12-alpine、postgres:16-alpine、nginx:1.30-alpine
Docker Compose とは
docker run を1つのファイルにまとめる
Docker Compose は、複数のコンテナの設定を compose.yaml という1つのファイルに書いておき、まとめて起動・停止するツールです。docker run では、コンテナごとに次のような長いコマンドを打つ必要があります。
docker network create myapp_default
docker run -d --name db --network myapp_default \
-e POSTGRES_PASSWORD=change-me -v db_data:/var/lib/postgresql/data postgres:16-alpine
docker run -d --name nginx --network myapp_default -p 127.0.0.1:8080:80 nginx:1.30-alpineCompose なら、これらをファイルに書いておき、docker compose up -d だけで起動できます。ネットワークも自動で作られ、コンテナどうしはサービス名(db など)で通信できます。docker コマンドそのものの使い方はLinux コマンドと Docker コマンドの対応の記事で紹介しています。
docker compose と docker-compose の違い
いまの Compose は docker コマンドのプラグイン(Compose V2)で、docker compose(間にスペース)と書きます。古い記事に出てくる docker-compose(ハイフン)は以前の版のコマンドです。バージョンは次のコマンドで確かめられます。
docker compose versionDocker Compose version v2.36.2-desktop.1ファイル名も、いまは compose.yaml が標準です。docker-compose.yml も引き続き読み込まれます。
compose.yaml の書き方
例にする構成
この記事では、次の3つのサービスを動かす myapp を例にします。僕が運用している Web アプリの形を、小さくしたものです。
| サービス | イメージ | 役割 |
|---|---|---|
web | 自分で build(Python) | アプリ本体。8000番で待ち受ける |
db | postgres:16-alpine | データベース |
nginx | nginx:1.30-alpine | リバースプロキシ。外から受けるのはここだけ |
myapp/
├── compose.yaml
├── .env
├── nginx/
│ └── default.conf
└── web/
├── Dockerfile
└── app.pycompose.yaml の全体
name: myapp
services:
web:
build: ./web
image: myapp-web:local
environment:
APP_MESSAGE: ${APP_MESSAGE:-hello from web}
DB_HOST: db
DB_NAME: ${DB_NAME:?Set DB_NAME in .env}
DB_USER: ${DB_USER:?Set DB_USER in .env}
DB_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
depends_on:
db:
condition: service_healthy
healthcheck:
test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/health', timeout=3).close()"]
interval: 10s
timeout: 5s
retries: 3
start_period: 10s
mem_limit: 256m
restart: unless-stopped
db:
image: postgres:16-alpine
environment:
POSTGRES_DB: ${DB_NAME:?Set DB_NAME in .env}
POSTGRES_USER: ${DB_USER:?Set DB_USER in .env}
POSTGRES_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
volumes:
- db_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U \"$$POSTGRES_USER\" -d \"$$POSTGRES_DB\""]
interval: 5s
timeout: 5s
retries: 5
mem_limit: 256m
restart: unless-stopped
nginx:
image: nginx:1.30-alpine
ports:
- "127.0.0.1:8080:80"
volumes:
- ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
depends_on:
web:
condition: service_healthy
mem_limit: 64m
restart: unless-stopped
volumes:
db_data:長く見えますが、services: の下にサービスごとの設定を並べ、最後に volumes: でデータの置き場所を宣言しているだけです。
よく使う項目
| 項目 | 意味 |
|---|---|
name | プロジェクト名。コンテナ・ネットワーク・ボリュームの名前の先頭に付く |
image | 使うイメージ。build と一緒に書くと、build したイメージにこの名前が付く |
build | Dockerfile のあるフォルダ。ここからイメージを作る |
environment | コンテナに渡す環境変数 |
ports | ホストに公開するポート(ホスト側:コンテナ側) |
volumes | データの保存先やファイルのマウント |
depends_on | 先に起動しておくサービス |
healthcheck | コンテナが正常に動いているかを確かめるコマンド |
restart | コンテナが止まったときに自動で起動し直すか |
mem_limit | 使えるメモリの上限 |
web の Dockerfile と nginx の設定
web は、確認用の小さな Python のアプリです。実際の Django アプリなら、ここが Gunicorn で動く Django になります(Gunicorn についてはGunicorn と Django の記事で紹介しています)。
FROM python:3.12-alpine
WORKDIR /app
COPY app.py .
EXPOSE 8000
CMD ["python", "app.py"]import os
import socket
from http.server import BaseHTTPRequestHandler, HTTPServer
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
if self.path == "/health":
body = "ok\n"
else:
# DB のコンテナにサービス名で接続できるかを確かめる
try:
socket.create_connection((os.environ["DB_HOST"], 5432), timeout=3).close()
db = "reachable"
except OSError as e:
db = f"error: {e}"
body = f"{os.environ.get('APP_MESSAGE')}\ndb: {db}\n"
self.send_response(200)
self.send_header("Content-Type", "text/plain; charset=utf-8")
self.end_headers()
self.wfile.write(body.encode())
if __name__ == "__main__":
print("listening on 0.0.0.0:8000", flush=True)
HTTPServer(("0.0.0.0", 8000), Handler).serve_forever()nginx は、受けたリクエストを web の8000番へ渡すだけの設定です。proxy_pass にサービス名の web を書けば、Compose のネットワークの中で名前が解決されます。
server {
listen 80;
location / {
proxy_pass http://web:8000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}よく使う docker compose コマンド
コマンドは、compose.yaml のあるフォルダで実行します。
起動する(up -d)
docker compose up -d-d を付けると、バックグラウンドで起動してターミナルに戻ります。付けないと、全サービスのログが流れ続ける状態になり、Ctrl + C で止まります。
build: のあるサービスは、イメージがまだなければ最初の up で作られます。2回目以降は、すでにイメージがあれば作り直しません。コードを変えたら --build を付けます。例の myapp を初めて起動したときの出力です(イメージを作る部分は省略しています)。
docker compose up -d --build(イメージを作る出力は省略)
web Built
Network myapp_default Creating
Network myapp_default Created
Volume "myapp_db_data" Creating
Volume "myapp_db_data" Created
Container myapp-db-1 Creating
Container myapp-db-1 Created
Container myapp-web-1 Creating
Container myapp-web-1 Created
Container myapp-nginx-1 Creating
Container myapp-nginx-1 Created
Container myapp-db-1 Starting
Container myapp-db-1 Started
Container myapp-db-1 Waiting
Container myapp-db-1 Healthy
Container myapp-web-1 Starting
Container myapp-web-1 Started
Container myapp-web-1 Waiting
Container myapp-web-1 Healthy
Container myapp-nginx-1 Starting
Container myapp-nginx-1 Startedネットワーク(myapp_default)とボリューム(myapp_db_data)が自動で作られ、db → web → nginx の順に起動しました。Waiting と Healthy は、後で説明する healthcheck を待っているところです。コンテナ名は「プロジェクト名-サービス名-番号」になります。
ブラウザか curl で http://127.0.0.1:8080/ を開くと、nginx を通して web の応答が返りました。web から db にも、サービス名でつながっています。
curl -s http://127.0.0.1:8080/hello from .env
db: reachable状態を見る(ps)
docker compose psNAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
myapp-db-1 postgres:16-alpine "docker-entrypoint.s…" db 12 seconds ago Up 11 seconds (healthy) 5432/tcp
myapp-nginx-1 nginx:1.30-alpine "/docker-entrypoint.…" nginx 12 seconds ago Up Less than a second 127.0.0.1:8080->80/tcp
myapp-web-1 myapp-web:local "python app.py" web 12 seconds ago Up 5 seconds (healthy) 8000/tcp動いているコンテナの一覧です。STATUS に healthcheck の結果(healthy)、PORTS に公開しているポートが出ます。ホストに公開しているのは nginx の 127.0.0.1:8080->80/tcp だけで、db と web はコンテナの中のポート番号だけが表示されています。docker compose ps -a とすると、止まっているコンテナも表示されます。
ログを見る(logs -f)
docker compose logs webweb-1 | listening on 0.0.0.0:8000
web-1 | 127.0.0.1 - - [18/Nov/2026 05:21:16] "GET /health HTTP/1.1" 200 -
web-1 | 172.18.0.4 - - [18/Nov/2026 05:21:17] "GET / HTTP/1.1" 200 -行の先頭にサービス名が付きます。healthcheck の /health と、nginx から届いたリクエストが記録されていました。
docker compose logs -f web
docker compose logs --tail 3 nginxサービス名を省くと、全サービスのログがまとめて出ます。-f は新しいログを流し続ける指定で、Ctrl + C で抜けます。--tail で、最後の何行だけを見るかを指定できます。
コンテナの中でコマンドを実行する(exec)
動いているコンテナの中で、シェルやコマンドを実行します。指定するのはコンテナ名ではなく、compose.yaml のサービス名です。DB にテーブルを作り、1行入れてみました。
docker compose exec db psql -U myapp -d myapp -c "CREATE TABLE notes (body text); INSERT INTO notes VALUES ('kept');"CREATE TABLE
INSERT 0 1docker compose exec web sh -c 'echo $APP_MESSAGE'
docker compose exec web python --versionhello from .env
Python 3.12.16docker compose exec web sh とすれば、コンテナの中のシェルに入れます。Django なら docker compose exec web python manage.py migrate のように、manage.py の実行にも使います。
イメージを作り直す(build)
web/app.py の /health の応答を ok から ok v2 に書き換えてから、up -d だけを実行してみました。
docker compose up -d
docker compose exec web wget -qO- http://127.0.0.1:8000/health Container myapp-db-1 Running
Container myapp-web-1 Running
Container myapp-nginx-1 Running
(中略)
okイメージがすでにあるので作り直されず、古いコードのまま ok が返りました。build でイメージを作り直してから up -d すると、変更が反映されました。
docker compose build web
docker compose up -d
docker compose exec web wget -qO- http://127.0.0.1:8000/health(イメージを作る出力は省略)
web Built
Container myapp-db-1 Running
Container myapp-web-1 Recreate
Container myapp-web-1 Recreated
Container myapp-nginx-1 Running
(中略)
ok v2build はイメージを作るだけで、動いているコンテナは入れ替わりません。そのあとの up -d で、web だけが新しいイメージで作り直されました(Recreate)。up -d --build は、この2つを1回で行う書き方です。
再起動する(restart)
docker compose restart web Container myapp-web-1 Restarting
Container myapp-web-1 Startedrestart は、いまあるコンテナをそのまま止めて起動し直します。公式ドキュメントにあるとおり、compose.yaml や .env を書き換えた内容は、restart では反映されません。
なお、restart の直後に curl でアクセスしたところ、nginx から 502 Bad Gateway が返りました。web が起動し直している最中だったためと考えられます。再起動した直後の数秒は、このようにエラーになることがあります。
<html>
<head><title>502 Bad Gateway</title></head>
(以下略)設定を変えたときは、restart ではなく docker compose up -d を実行します。.env の APP_MESSAGE を changed in .env に書き換えてから実行すると、設定の変わった web だけが作り直され、新しい値になりました。
docker compose up -d
curl -s http://127.0.0.1:8080/ Container myapp-db-1 Running
Container myapp-web-1 Recreate
Container myapp-web-1 Recreated
Container myapp-nginx-1 Running
(中略)
changed in .env
db: reachable止める(down / stop)
docker compose stop
docker compose down
docker compose down -v| コマンド | コンテナ | ネットワーク | 名前付きボリューム(DB のデータ) |
|---|---|---|---|
stop | 止める(残る) | 残る | 残る |
down | 削除する | 削除する | 残る |
down -v | 削除する | 削除する | 削除する |
普段止めるときは down で十分で、DB のデータは名前付きボリュームに残ります(次の「ボリュームでデータを残す」で確かめています)。down -v はデータまで消すので、作り直してよい開発用の環境のときだけ使います。
コマンドの早見表
| コマンド | やること |
|---|---|
docker compose up -d | バックグラウンドで起動(設定が変わったものは作り直す) |
docker compose up -d --build | イメージを作り直してから起動 |
docker compose ps | 状態を見る(-a で止まったものも) |
docker compose logs -f <サービス> | ログを流し続けて見る |
docker compose exec <サービス> <コマンド> | コンテナの中で実行 |
docker compose build | イメージを作る |
docker compose restart <サービス> | そのまま起動し直す(設定の変更は反映されない) |
docker compose down | コンテナとネットワークを削除(-v でボリュームも) |
docker compose config | 変数を展開した最終形を表示・文法を確かめる |
docker compose config で書き間違いを確かめる
変数を展開した最終形を表示する
docker compose config は、.env の値を埋め込んだあとの、Compose が実際に使う設定を表示します。コンテナは起動しないので、書き換えたあとの確認に便利です。例の myapp で実行した結果の一部です。
docker compose configname: myapp
services:
db:
environment:
POSTGRES_DB: myapp
POSTGRES_PASSWORD: change-me
POSTGRES_USER: myapp
(中略)
image: postgres:16-alpine
mem_limit: "268435456"
(中略)
nginx:
(中略)
ports:
- mode: ingress
host_ip: 127.0.0.1
target: 80
published: "8080"
protocol: tcp
(中略)
volumes:
db_data:
name: myapp_db_data.env の値が入り、256m と書いた mem_limit がバイト数(268435456)で表示されています。ボリュームの実際の名前は、プロジェクト名が付いた myapp_db_data になることも分かります。
サービス名やボリューム名だけを見たいときは、--services・--volumes を付けます。
docker compose config --servicesdb
web
nginx書き間違いを見つける
-q(--quiet)を付けると、問題がなければ何も表示せず、間違いがあるときだけエラーを出します。わざとインデントをずらしたファイルと、restart を restarts と書き間違えたファイルで試しました。
docker compose config -qyaml: line 51: mapping values are not allowed in this contextvalidating /path/to/myapp/compose.yaml: services.db Additional property restarts is not allowedYAML の文法の誤りだけでなく、存在しない項目名も見つけてくれます。compose.yaml を書き換えたら、up の前に一度 config -q を通しておくと安心です。
環境変数と .env
.env に値を書く
パスワードなど、ファイルに直接書きたくない値は、compose.yaml と同じフォルダの .env に書きます。
# .env
DB_NAME=myapp
DB_USER=myapp
DB_PASSWORD=change-me
APP_MESSAGE=hello from .envcompose.yaml の中の ${DB_PASSWORD} のような部分が、.env の値に置き換わります。.env は Compose が自動で読み込むので、指定は要りません。別のファイルを使うときは --env-file で渡します。
${変数:?} で必須に、${変数:-} で既定値を付ける
| 書き方 | 意味 |
|---|---|
${DB_NAME} | 値を入れる。なければ空になり、警告が出る |
${APP_MESSAGE:-hello from web} | なければ hello from web を使う |
${DB_NAME:?Set DB_NAME in .env} | なければエラーで止める(メッセージ付き) |
パスワードやデータベース名は、空のまま起動すると困るので :? で必須にしています。.env がない状態で確かめると、次のエラーで止まりました。
error while interpolating services.web.environment.DB_NAME: required variable DB_NAME is missing a value: Set DB_NAME in .envシェルの環境変数は .env より優先される
同じ名前の変数がシェルにもあると、.env よりシェルの値が使われます。APP_MESSAGE="from shell" を付けて config を実行すると、.env に書いた hello from .env ではなく、シェルの値が入りました。
APP_MESSAGE="from shell" docker compose config --format json "web": {
(中略)
"environment": {
"APP_MESSAGE": "from shell",
(以下略)「.env を直したのに値が変わらない」ときは、シェルに同じ名前の変数が残っていないかを echo $APP_MESSAGE などで確かめてみてください。
.env は Git に入れない
.env にはパスワードを書くので、.gitignore に入れて Git の管理から外します。代わりに、値をダミーにした .env.example をリポジトリに入れておくと、ほかの環境で何を設定すればよいかが分かります。
depends_on と healthcheck で起動の順番をそろえる
depends_on だけでは「起動した」までしか待たない
depends_on: [db] のように書くだけだと、Compose は db のコンテナが起動したことまでしか待ちません。PostgreSQL は、コンテナが起動してから接続を受け付けるまでに少し時間がかかります。そのため、アプリが先に DB へつなぎに行って失敗することがあります。
healthcheck と condition: service_healthy を組み合わせる
そこで、db に healthcheck を書き、web の depends_on に condition: service_healthy を付けます。こうすると、db の healthcheck が成功する(healthy になる)まで、web の起動を待ちます。
web:
depends_on:
db:
condition: service_healthy
db:
image: postgres:16-alpine
healthcheck:
test: ["CMD-SHELL", "pg_isready -U \"$$POSTGRES_USER\" -d \"$$POSTGRES_DB\""]
interval: 5s
timeout: 5s
retries: 5| 項目 | 意味 |
|---|---|
test | 確かめるコマンド。終了コード0なら成功 |
interval | 確かめる間隔 |
timeout | 1回の確認の制限時間 |
retries | 何回続けて失敗したら unhealthy にするか |
start_period | 起動直後の、失敗を数えない猶予の時間 |
例では、同じ考え方で nginx も web の healthcheck を待つようにしています。docker compose stop で全部止めてから起動し直すと、この順番で立ち上がりました。
docker compose stop
docker compose up -d(stop の出力と、up の最初の数行は省略)
Container myapp-db-1 Starting
Container myapp-db-1 Started
Container myapp-db-1 Waiting
Container myapp-db-1 Healthy
Container myapp-web-1 Starting
Container myapp-web-1 Started
Container myapp-web-1 Waiting
Container myapp-web-1 Healthy
Container myapp-nginx-1 Starting
Container myapp-nginx-1 Starteddb が Healthy になってから web が起動し、web が Healthy になってから nginx が起動しています。
healthcheck の書き方の注意
pg_isready の例の $$POSTGRES_USER は、$ を2つ重ねています。$ が1つだと、Compose がファイルを読む時点で変数として置き換えてしまうからです。$$ と書くと、コンテナの中のシェルに $POSTGRES_USER として渡ります。
MariaDB の公式イメージには、確認用の healthcheck.sh が入っています。
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s自分で作るアプリなら、/health のような確認用の URL を用意しておき、それにアクセスするコマンドを書きます。イメージに curl が入っていないことも多いので、例の web では Python の urllib を使っています。
ボリュームでデータを残す
名前付きボリューム
コンテナを削除すると、コンテナの中に書いたファイルは消えます。DB のデータのように残したいものは、名前付きボリュームに置きます。
services:
db:
volumes:
- db_data:/var/lib/postgresql/data
volumes:
db_data:最後の volumes: で宣言した db_data は、Docker が管理する場所に作られます。実際の名前は、プロジェクト名の付いた myapp_db_data です。exec の例で入れた1行が、down のあとも残るかを確かめました。
docker compose down
docker compose ps -a
docker volume ls --filter name=myapp(中略)
Container myapp-db-1 Removed
Network myapp_default Removing
Network myapp_default Removed
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
DRIVER VOLUME NAME
local myapp_db_dataコンテナとネットワークは削除されましたが、ボリュームは残っています。もう一度起動して、テーブルの中身を見ます。
docker compose up -d
docker compose exec db psql -U myapp -d myapp -c "SELECT * FROM notes;" body
------
kept
(1 row)コンテナを作り直しても、データは残っていました。down -v を実行すると、ボリュームも削除されます。
docker compose down -v(中略)
Volume myapp_db_data Removing
Volume myapp_db_data Removed
Network myapp_default Removedバインドマウントと :ro
ホストのファイルをそのままコンテナに見せたいときは、パスで指定します(バインドマウント)。設定ファイルのように、コンテナから書き換える必要がないものには :ro(読み取り専用)を付けておくと安心です。
volumes:
- ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro| 種類 | 書き方の例 | 向いているもの |
|---|---|---|
| 名前付きボリューム | db_data:/var/lib/postgresql/data | DB のデータ、WordPress の wp-content |
| バインドマウント | ./nginx/default.conf:/etc/nginx/...:ro | 設定ファイル、証明書、静的ファイル |
ポートは 127.0.0.1 に限って公開する
“8080:80” と書くと、すべてのアドレスで待ち受ける
ports に "8080:80" とだけ書くと、ホストのすべてのネットワーク(0.0.0.0)の8080番で待ち受けます。VPS なら、インターネットから直接つながる状態です。
ホストの中からだけ使えればよいポートは、127.0.0.1: を付けて公開先を限ります。
ports:
- "127.0.0.1:8080:80"config の出力でも、host_ip: 127.0.0.1 になっていることを確かめられます。起動したあとは、docker compose port で実際の公開先を確かめられます。
docker compose port nginx 80127.0.0.1:8080同じ Mac から 127.0.0.1:8080 にアクセスすると 200 が返りました。一方、同じ Mac の LAN 側の IP アドレス(192.168.x.x など)の8080番にアクセスすると、つながりませんでした(curl の終了コードは 7)。
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/
curl -s -m 3 -o /dev/null -w "%{http_code}\n" http://192.168.x.x:8080/200
000ufw などのファイアウォールでは守れないことがある
Linux で Docker がポートを公開するときは、Docker 自身が iptables のルールを書き込みます。そのため、ufw で8080番を閉じたつもりでも、Docker が公開したポートには外からつながってしまうことがあります(Docker の公式ドキュメントにも、ufw とは組み合わせにくいことが書かれています)。
僕の VPS では、ファイアウォールに頼らず、compose.yaml の公開先で守ることにしています。WordPress の管理画面のように自分だけが使うものは 127.0.0.1 に限り、SSH のポート転送でつないでいます(SSH の使い方はSSH の記事にまとめています)。
外に出すのは nginx だけにする
例の compose.yaml では、ports を書いているのは nginx だけです。web と db はホストにポートを公開していないので、同じ Compose のネットワークの中のコンテナからしかつながりません。DB のポート(5432 や 3306)は、特に理由がなければ公開しません。
複数の Compose のプロジェクトを1つの nginx の後ろに並べたいときは、外部のネットワークを作って共有します。
name: myapp2
services:
web:
image: myapp2-web:local
networks:
proxy:
aliases:
- myapp2-web
networks:
proxy:
external: trueexternal: true は、「このネットワークは Compose の外で作ったものを使う」という指定です。先に docker network create proxy で作っておき、nginx 側の Compose も同じ proxy につなぎます。nginx からは myapp2-web という名前で届きます。nginx と Let’s Encrypt の組み合わせはDocker の nginx でリバースプロキシを作る記事で紹介しています。
restart の方針と mem_limit
restart の選び方
| 値 | 動き |
|---|---|
"no"(既定) | 自動では起動し直さない |
always | 止まったら必ず起動し直す。手で止めても、Docker の再起動で起動する |
on-failure | エラーで終わったときだけ起動し直す |
unless-stopped | 止まったら起動し直す。ただし手で止めたものは起動しない |
no は YAML では真偽値と解釈されることがあるので、"no" と引用符で囲んで書きます。
僕の使い分け
サイトとして常に動かしておく Web アプリと nginx は unless-stopped にしています。サーバーを再起動しても自動で立ち上がり、メンテナンスで docker compose stop したときは勝手に起動しません。
一方、記事を書くときだけ起動する WordPress は restart: "no" にしています。使い終わったら止めておき、サーバーの再起動で勝手に立ち上がってメモリを使わないようにするためです。
mem_limit でメモリの上限を決める
小さな VPS で複数のコンテナを動かすときは、mem_limit でコンテナごとのメモリの上限を決めておきます。1つのコンテナがメモリを使い切って、ほかのサービスまで巻き込んで止まるのを防ぐためです。
mem_limit: 256m設定した上限は、docker stats の右側に表示されます。例の myapp を起動した直後の使用量です。
docker stats --no-stream --format '{{.Name}} {{.MemUsage}}' $(docker compose ps -q)myapp-db-1 59.44MiB / 256MiB
myapp-nginx-1 10.38MiB / 64MiB
myapp-web-1 11.85MiB / 256MiB上限を超えたコンテナは、強制的に終了させられます。小さくしすぎると落ちる原因になるので、docker stats で普段の使用量を見てから、余裕を持たせて決めます。僕は WordPress を 512m、MariaDB を 256m にしています。
WordPress と MariaDB を動かす例
compose.yaml
ここまでの考え方で書いた、WordPress と MariaDB の compose.yaml です。.env には DB_NAME・DB_USER・DB_PASSWORD・DB_ROOT_PASSWORD を書きます。
name: mywp
services:
wordpress:
image: wordpress:php8.3-apache
environment:
WORDPRESS_DB_HOST: db
WORDPRESS_DB_NAME: ${DB_NAME:?Set DB_NAME in .env}
WORDPRESS_DB_USER: ${DB_USER:?Set DB_USER in .env}
WORDPRESS_DB_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
ports:
- "127.0.0.1:${WP_PORT:-8090}:80"
volumes:
- wp_content:/var/www/html/wp-content
depends_on:
db:
condition: service_healthy
mem_limit: 512m
restart: "no"
db:
image: mariadb:11
environment:
MARIADB_DATABASE: ${DB_NAME:?Set DB_NAME in .env}
MARIADB_USER: ${DB_USER:?Set DB_USER in .env}
MARIADB_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD:?Set DB_ROOT_PASSWORD in .env}
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s
mem_limit: 256m
restart: "no"
volumes:
wp_content:
db_data:この例は docker compose config -q でエラーが出ないことを確かめています。WP_PORT=8091 を付けて実行すると、公開するポートが 127.0.0.1 の8091番に変わりました。
この例のポイント
- 管理画面は
127.0.0.1の8090番だけで公開し、外からは直接つながらない - MariaDB の healthcheck が通るまで WordPress を起動しない
- 記事を書くときだけ起動するので
restart: "no"、小さな VPS 向けにmem_limitを付ける wp-content(テーマ・プラグイン・画像)と DB のデータは名前付きボリュームに残す
まとめ
Docker Compose を使うと、複数のコンテナの設定を compose.yaml にまとめ、1つのコマンドで起動・停止できます。
- 起動は
docker compose up -d、コードを変えたら--build、設定を変えたらup -dをもう一度 - 状態は
ps、ログはlogs -f、中での作業はexec - パスワードは
.envに書き、${変数:?}で必須にする - DB には
healthcheckを書き、depends_onでservice_healthyを待つ - 公開するポートは
127.0.0.1:に限り、外に出すのは nginx だけにする restartとmem_limitは、常時動かすかどうかとサーバーのメモリで決める
書き換えたら docker compose config -q で確かめる習慣をつけておくと、起動してから慌てることが減ります。
