Dockerコンテナの自動起動設計｜restart policyとsystemd連携でサーバー再起動に耐える構成

この記事のポイント

・docker restart policy の unless-stopped がサーバー再起動後の自動起動に本番推奨
・4種類（no / on-failure / always / unless-stopped）を用途に応じて使い分ける
・docker-compose.yml の restart フィールドで複数コンテナに一括設定できる
・起動順序や依存関係の詳細制御が必要な場合は systemd ユニットファイルが有効

# コンテナの restart policy を確認する
$ docker inspect --format='{{.HostConfig.RestartPolicy.Name}}' コンテナ名
no

# restart policy を明示的に no に設定する（デフォルトと同じ動作）
$ docker run --restart=no myapp:latest

# 最大5回まで再起動する（5回失敗すると停止したままになる）
$ docker run --restart=on-failure:5 myapp:latest

$ docker run --restart=always myapp:latest

$ docker run --restart=unless-stopped myapp:latest

# 稼働中のコンテナの restart policy を unless-stopped に変更する
$ docker update --restart=unless-stopped コンテナ名

# 複数のコンテナに一括で設定する
$ docker update --restart=unless-stopped コンテナ名1 コンテナ名2

# 変更後に設定を確認する
$ docker inspect --format='{{.HostConfig.RestartPolicy.Name}}' コンテナ名
unless-stopped

# docker-compose.yml の例（本番環境向け設定）
services:
  web:
    image: nginx:latest
    restart: unless-stopped    # 本番推奨
    ports:
      - "80:80"

  app:
    image: myapp:latest
    restart: unless-stopped
    depends_on:
      - db

  db:
    image: postgres:16
    restart: unless-stopped
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:

# /etc/systemd/system/docker-nginx.service の内容
[Unit]
Description=Nginx Docker Container
After=docker.service
Requires=docker.service

[Service]
Type=simple
Restart=always
RestartSec=10s
ExecStartPre=-/usr/bin/docker stop nginx-container
ExecStartPre=-/usr/bin/docker rm nginx-container
ExecStart=/usr/bin/docker run     --name nginx-container     --rm     -p 80:80     nginx:latest
ExecStop=/usr/bin/docker stop nginx-container

[Install]
WantedBy=multi-user.target

# デーモンをリロードして新しいユニットファイルを読み込む
$ sudo systemctl daemon-reload

# サービスを起動する
$ sudo systemctl start docker-nginx.service

# サーバー再起動後の自動起動を有効にする
$ sudo systemctl enable docker-nginx.service
Created symlink /etc/systemd/system/multi-user.target.wants/docker-nginx.service -> /etc/systemd/system/docker-nginx.service.

# ステータスを確認する
$ sudo systemctl status docker-nginx.service
* docker-nginx.service - Nginx Docker Container
     Loaded: loaded (/etc/systemd/system/docker-nginx.service; enabled; preset: disabled)
     Active: active (running) since Wed 2026-07-16 10:23:45 JST; 5s ago
   Main PID: 3847 (docker)

# 本番用コンテナ起動の基本形
$ docker run -d     --name myapp     --restart=unless-stopped     -p 8080:8080     -v /data/myapp:/app/data     myapp:latest

# restart policy の適用を確認する
$ docker inspect --format='{{.HostConfig.RestartPolicy.Name}}' myapp
unless-stopped

# 本番用 docker-compose.yml の推奨構成
services:
  nginx:
    image: nginx:1.27
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro

  app:
    image: myapp:1.5.0    # latest タグは本番では使わない
    restart: unless-stopped
    environment:
      - NODE_ENV=production
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16
    restart: unless-stopped
    environment:
      - POSTGRES_PASSWORD_FILE=/run/secrets/db_password
    volumes:
      - db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  db_data:

# Dockerデーモンの自動起動設定を確認する
$ sudo systemctl is-enabled docker
enabled

# enabled でない場合は有効化する
$ sudo systemctl enable docker

# コンテナのステータス確認
$ docker ps -a
CONTAINER ID   IMAGE        COMMAND   STATUS
a1b2c3d4e5f6   myapp:latest "run"     Restarting (1) 5 seconds ago

# ログで原因を確認する
$ docker logs --tail=50 コンテナ名
Error: Cannot connect to database at db:5432

# always から unless-stopped に変更する
$ docker update --restart=unless-stopped コンテナ名

# または完全に自動再起動を無効にする
$ docker update --restart=no コンテナ名