Docker Swarmにcompose.ymlをそのまま持ち込めるか｜docker stack deployで効くdeployキーと無視されるbuildの扱い

この記事のポイント

・docker stack deployはdeployブロック（replicas・placement・restart_policy）を読み取りSwarmサービスを構成する
・build・depends_on・restartキーはdocker stack deployでは完全に無視される
・buildを使っているサービスは「ビルド→レジストリpush→image:書き換え」の3ステップで対応する
・depends_onの代替はhealthcheck + deploy.restart_policy.condition: on-failureで吸収できる

$ docker swarm init --advertise-addr 192.168.1.10
Swarm initialized: current node (abc123xyz) is now a manager.

To add a worker to this swarm, run the following command:
    docker swarm join --token SWMTKN-1-xxx 192.168.1.10:2377

services:
  db:
    image: mysql:8.0
    restart: always          # ← Swarmでは無視される
    container_name: wp_db    # ← Swarmでは無視される
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: wordpress

  wordpress:
    build: .                 # ← Swarmでは無視される（事前にpush必須）
    depends_on:
      - db                   # ← Swarmでは無視される
    ports:
      - "80:80"
    environment:
      WORDPRESS_DB_HOST: db:3306

services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: wordpress
    deploy:
      replicas: 1
      restart_policy:
        condition: on-failure
        max_attempts: 3
      placement:
        constraints:
          - node.role == manager

  wordpress:
    image: myrepo/wordpress:latest   # ← buildの代わりにpush済みイメージを指定
    ports:
      - "80:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
    deploy:
      replicas: 2
      restart_policy:
        condition: on-failure
      update_config:
        parallelism: 1
        delay: 10s

networks:
  default:
    driver: overlay

# スタック名を "myapp" として展開する
$ docker stack deploy -c compose.yml myapp
Creating network myapp_default
Creating service myapp_db
Creating service myapp_wordpress

# サービス一覧を確認する
$ docker service ls
ID             NAME                  MODE         REPLICAS   IMAGE
a1b2c3d4e5f6   myapp_db              replicated   1/1        mysql:8.0
f6e5d4c3b2a1   myapp_wordpress       replicated   2/2        myrepo/wordpress:latest

# 特定サービスのタスク（コンテナ）状態を確認する
$ docker service ps myapp_wordpress
ID             NAME                    IMAGE                     NODE        DESIRED STATE   CURRENT STATE
x1y2z3a4b5c6   myapp_wordpress.1       myrepo/wordpress:latest   node01      Running         Running 2 minutes ago
c6b5a4z3y2x1   myapp_wordpress.2       myrepo/wordpress:latest   node02      Running         Running 2 minutes ago

deploy:
  replicas: 3    # サービスを3コンテナで動かす

deploy:
  placement:
    constraints:
      - node.role == worker           # ワーカーノードにのみ配置
      - node.labels.region == tokyo   # ラベルで絞り込む場合

$ docker node update --label-add region=tokyo node01

deploy:
  update_config:
    parallelism: 1       # 同時に更新するコンテナ数
    delay: 10s           # 各バッチ間の待機時間
    failure_action: rollback   # 失敗したら自動ロールバック
    order: start-first   # 新コンテナを先に起動してから旧コンテナを停止

deploy:
  restart_policy:
    condition: on-failure   # 失敗時のみ再起動（any / none も指定可能）
    delay: 5s               # 再起動前の待機時間
    max_attempts: 3         # 最大再起動回数（超えたらタスクを停止）
    window: 120s            # max_attemptsをカウントする時間窓

deploy:
  resources:
    limits:
      cpus: '0.50'     # CPUの上限（コア数の割合）
      memory: 512M     # メモリの上限
    reservations:
      cpus: '0.25'     # スケジューリング時に確保するCPU
      memory: 256M     # スケジューリング時に確保するメモリ

deploy:
  mode: global    # 全ノードに1コンテナずつ配置（監視エージェントなどに使う）
  # mode: replicated  # デフォルト。replicasで数を指定

# カレントディレクトリのDockerfileを使ってビルドする
$ docker build -t myrepo/myapp:v1.0 .

# Docker Hubに送る場合は事前にログインしておく
$ docker login

$ docker push myrepo/myapp:v1.0
The push refers to repository [docker.io/myrepo/myapp]
v1.0: digest: sha256:abc123... size: 1234

# 修正前
services:
  app:
    build: .
    ports:
      - "8080:8080"

# 修正後
services:
  app:
    image: myrepo/myapp:v1.0   # pushしたイメージを指定
    ports:
      - "8080:8080"
    deploy:
      replicas: 2

$ docker service ps myapp_wordpress --no-trunc
ID        NAME                 IMAGE                      NODE    DESIRED   CURRENT STATE        ERROR
xxx       myapp_wordpress.1    myrepo/wordpress:latest    node02  Running   Preparing 3 min      "No such image: myrepo/wordpress:latest"

# ノードの状態とラベルを確認する
$ docker node ls
ID          HOSTNAME   STATUS   AVAILABILITY   MANAGER STATUS
abc123 *    node01     Ready    Active         Leader
def456      node02     Ready    Active

# ノードに付いているラベルを確認する
$ docker node inspect node02 --pretty | grep -A 5 Labels
Labels:
 - region=osaka

deploy:
  restart_policy:
    condition: on-failure
    max_attempts: 5      # 最大5回リトライする間にDBが起動するのを待つ
    delay: 5s

# 同じコマンドで再実行すると差分が適用される
$ docker stack deploy -c compose.yml myapp
Updating service myapp_wordpress (id: f6e5d4c3b2a1)

# スタックを完全に削除する場合
$ docker stack rm myapp