Docker Composeの使い方|compose.yamlの書き方とコマンド

  • 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 の決め方も紹介します。

この記事で確認した環境(2026年11月18日)
  • 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
目次
  1. Docker Compose とは
  2. compose.yaml の書き方
  3. よく使う docker compose コマンド
  4. docker compose config で書き間違いを確かめる
  5. 環境変数と .env
  6. depends_on と healthcheck で起動の順番をそろえる
  7. ボリュームでデータを残す
  8. ポートは 127.0.0.1 に限って公開する
  9. restart の方針と mem_limit
  10. WordPress と MariaDB を動かす例
  11. まとめ

Docker Compose とは

docker run を1つのファイルにまとめる

Docker Compose は、複数のコンテナの設定を compose.yaml という1つのファイルに書いておき、まとめて起動・停止するツールです。docker run では、コンテナごとに次のような長いコマンドを打つ必要があります。

Bash
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-alpine

Compose なら、これらをファイルに書いておき、docker compose up -d だけで起動できます。ネットワークも自動で作られ、コンテナどうしはサービス名(db など)で通信できます。docker コマンドそのものの使い方はLinux コマンドと Docker コマンドの対応の記事で紹介しています。

docker compose と docker-compose の違い

いまの Compose は docker コマンドのプラグイン(Compose V2)で、docker compose(間にスペース)と書きます。古い記事に出てくる docker-compose(ハイフン)は以前の版のコマンドです。バージョンは次のコマンドで確かめられます。

Bash
docker compose version
Text
Docker Compose version v2.36.2-desktop.1

ファイル名も、いまは compose.yaml が標準です。docker-compose.yml も引き続き読み込まれます。

compose.yaml の書き方

例にする構成

この記事では、次の3つのサービスを動かす myapp を例にします。僕が運用している Web アプリの形を、小さくしたものです。

サービスイメージ役割
web自分で build(Python)アプリ本体。8000番で待ち受ける
dbpostgres:16-alpineデータベース
nginxnginx:1.30-alpineリバースプロキシ。外から受けるのはここだけ
Text
myapp/
├── compose.yaml
├── .env
├── nginx/
│   └── default.conf
└── web/
    ├── Dockerfile
    └── app.py

compose.yaml の全体

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 したイメージにこの名前が付く
buildDockerfile のあるフォルダ。ここからイメージを作る
environmentコンテナに渡す環境変数
portsホストに公開するポート(ホスト側:コンテナ側)
volumesデータの保存先やファイルのマウント
depends_on先に起動しておくサービス
healthcheckコンテナが正常に動いているかを確かめるコマンド
restartコンテナが止まったときに自動で起動し直すか
mem_limit使えるメモリの上限

web の Dockerfile と nginx の設定

web は、確認用の小さな Python のアプリです。実際の Django アプリなら、ここが Gunicorn で動く Django になります(Gunicorn についてはGunicorn と Django の記事で紹介しています)。

Dockerfile
FROM python:3.12-alpine
WORKDIR /app
COPY app.py .
EXPOSE 8000
CMD ["python", "app.py"]
Python
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 のネットワークの中で名前が解決されます。

nginx
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)

Bash
docker compose up -d

-d を付けると、バックグラウンドで起動してターミナルに戻ります。付けないと、全サービスのログが流れ続ける状態になり、Ctrl + C で止まります。

build: のあるサービスは、イメージがまだなければ最初の up で作られます。2回目以降は、すでにイメージがあれば作り直しません。コードを変えたら --build を付けます。例の myapp を初めて起動したときの出力です(イメージを作る部分は省略しています)。

Bash
docker compose up -d --build
Text
(イメージを作る出力は省略)
 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 にも、サービス名でつながっています。

Bash
curl -s http://127.0.0.1:8080/
Text
hello from .env
db: reachable

状態を見る(ps)

Bash
docker compose ps
Text
NAME            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)

Bash
docker compose logs web
Text
web-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 から届いたリクエストが記録されていました。

Bash
docker compose logs -f web
docker compose logs --tail 3 nginx

サービス名を省くと、全サービスのログがまとめて出ます。-f は新しいログを流し続ける指定で、Ctrl + C で抜けます。--tail で、最後の何行だけを見るかを指定できます。

コンテナの中でコマンドを実行する(exec)

動いているコンテナの中で、シェルやコマンドを実行します。指定するのはコンテナ名ではなく、compose.yaml のサービス名です。DB にテーブルを作り、1行入れてみました。

Bash
docker compose exec db psql -U myapp -d myapp -c "CREATE TABLE notes (body text); INSERT INTO notes VALUES ('kept');"
Text
CREATE TABLE
INSERT 0 1
Bash
docker compose exec web sh -c 'echo $APP_MESSAGE'
docker compose exec web python --version
Text
hello from .env
Python 3.12.16

docker 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 だけを実行してみました。

Bash
docker compose up -d
docker compose exec web wget -qO- http://127.0.0.1:8000/health
Text
 Container myapp-db-1  Running
 Container myapp-web-1  Running
 Container myapp-nginx-1  Running
(中略)
ok

イメージがすでにあるので作り直されず、古いコードのまま ok が返りました。build でイメージを作り直してから up -d すると、変更が反映されました。

Bash
docker compose build web
docker compose up -d
docker compose exec web wget -qO- http://127.0.0.1:8000/health
Text
(イメージを作る出力は省略)
 web  Built
 Container myapp-db-1  Running
 Container myapp-web-1  Recreate
 Container myapp-web-1  Recreated
 Container myapp-nginx-1  Running
(中略)
ok v2

build はイメージを作るだけで、動いているコンテナは入れ替わりません。そのあとの up -d で、web だけが新しいイメージで作り直されました(Recreate)。up -d --build は、この2つを1回で行う書き方です。

再起動する(restart)

Bash
docker compose restart web
Text
 Container myapp-web-1  Restarting
 Container myapp-web-1  Started

restart は、いまあるコンテナをそのまま止めて起動し直します。公式ドキュメントにあるとおり、compose.yaml や .env を書き換えた内容は、restart では反映されません。

なお、restart の直後に curl でアクセスしたところ、nginx から 502 Bad Gateway が返りました。web が起動し直している最中だったためと考えられます。再起動した直後の数秒は、このようにエラーになることがあります。

Text
<html>
<head><title>502 Bad Gateway</title></head>
(以下略)

設定を変えたときは、restart ではなく docker compose up -d を実行します。.env の APP_MESSAGE を changed in .env に書き換えてから実行すると、設定の変わった web だけが作り直され、新しい値になりました。

Bash
docker compose up -d
curl -s http://127.0.0.1:8080/
Text
 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)

Bash
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 で実行した結果の一部です。

Bash
docker compose config
Text
name: 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 を付けます。

Bash
docker compose config --services
Text
db
web
nginx

書き間違いを見つける

-q(--quiet)を付けると、問題がなければ何も表示せず、間違いがあるときだけエラーを出します。わざとインデントをずらしたファイルと、restart を restarts と書き間違えたファイルで試しました。

Bash
docker compose config -q
Text
yaml: line 51: mapping values are not allowed in this context
Text
validating /path/to/myapp/compose.yaml: services.db Additional property restarts is not allowed

YAML の文法の誤りだけでなく、存在しない項目名も見つけてくれます。compose.yaml を書き換えたら、up の前に一度 config -q を通しておくと安心です。

環境変数と .env

.env に値を書く

パスワードなど、ファイルに直接書きたくない値は、compose.yaml と同じフォルダの .env に書きます。

Text
# .env
DB_NAME=myapp
DB_USER=myapp
DB_PASSWORD=change-me
APP_MESSAGE=hello from .env

compose.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 がない状態で確かめると、次のエラーで止まりました。

Text
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 ではなく、シェルの値が入りました。

Bash
APP_MESSAGE="from shell" docker compose config --format json
Text
    "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 の起動を待ちます。

YAML
  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確かめる間隔
timeout1回の確認の制限時間
retries何回続けて失敗したら unhealthy にするか
start_period起動直後の、失敗を数えない猶予の時間

例では、同じ考え方で nginx も web の healthcheck を待つようにしています。docker compose stop で全部止めてから起動し直すと、この順番で立ち上がりました。

Bash
docker compose stop
docker compose up -d
Text
(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  Started

db が Healthy になってから web が起動し、web が Healthy になってから nginx が起動しています。

healthcheck の書き方の注意

pg_isready の例の $$POSTGRES_USER は、$ を2つ重ねています。$ が1つだと、Compose がファイルを読む時点で変数として置き換えてしまうからです。$$ と書くと、コンテナの中のシェルに $POSTGRES_USER として渡ります。

MariaDB の公式イメージには、確認用の healthcheck.sh が入っています。

YAML
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

自分で作るアプリなら、/health のような確認用の URL を用意しておき、それにアクセスするコマンドを書きます。イメージに curl が入っていないことも多いので、例の web では Python の urllib を使っています。

ボリュームでデータを残す

名前付きボリューム

コンテナを削除すると、コンテナの中に書いたファイルは消えます。DB のデータのように残したいものは、名前付きボリュームに置きます。

YAML
services:
  db:
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:

最後の volumes: で宣言した db_data は、Docker が管理する場所に作られます。実際の名前は、プロジェクト名の付いた myapp_db_data です。exec の例で入れた1行が、down のあとも残るかを確かめました。

Bash
docker compose down
docker compose ps -a
docker volume ls --filter name=myapp
Text
(中略)
 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

コンテナとネットワークは削除されましたが、ボリュームは残っています。もう一度起動して、テーブルの中身を見ます。

Bash
docker compose up -d
docker compose exec db psql -U myapp -d myapp -c "SELECT * FROM notes;"
Text
 body 
------
 kept
(1 row)

コンテナを作り直しても、データは残っていました。down -v を実行すると、ボリュームも削除されます。

Bash
docker compose down -v
Text
(中略)
 Volume myapp_db_data  Removing
 Volume myapp_db_data  Removed
 Network myapp_default  Removed

バインドマウントと :ro

ホストのファイルをそのままコンテナに見せたいときは、パスで指定します(バインドマウント)。設定ファイルのように、コンテナから書き換える必要がないものには :ro(読み取り専用)を付けておくと安心です。

YAML
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
種類書き方の例向いているもの
名前付きボリュームdb_data:/var/lib/postgresql/dataDB のデータ、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: を付けて公開先を限ります。

YAML
    ports:
      - "127.0.0.1:8080:80"

config の出力でも、host_ip: 127.0.0.1 になっていることを確かめられます。起動したあとは、docker compose port で実際の公開先を確かめられます。

Bash
docker compose port nginx 80
Text
127.0.0.1:8080

同じ Mac から 127.0.0.1:8080 にアクセスすると 200 が返りました。一方、同じ Mac の LAN 側の IP アドレス(192.168.x.x など)の8080番にアクセスすると、つながりませんでした(curl の終了コードは 7)。

Bash
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/
Text
200
000

ufw などのファイアウォールでは守れないことがある

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 の後ろに並べたいときは、外部のネットワークを作って共有します。

YAML
name: myapp2

services:
  web:
    image: myapp2-web:local
    networks:
      proxy:
        aliases:
          - myapp2-web

networks:
  proxy:
    external: true

external: 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つのコンテナがメモリを使い切って、ほかのサービスまで巻き込んで止まるのを防ぐためです。

YAML
    mem_limit: 256m

設定した上限は、docker stats の右側に表示されます。例の myapp を起動した直後の使用量です。

Bash
docker stats --no-stream --format '{{.Name}}  {{.MemUsage}}' $(docker compose ps -q)
Text
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 を書きます。

YAML
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 で確かめる習慣をつけておくと、起動してから慌てることが減ります。

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

この記事を書いた人

普段は主にPython開発をしています。
最近はAI駆動開発にも関わっています。