Ansibleのdelegate_toとrun_onceの使い方｜ロードバランサー操作を含むオーケストレーション設計

この記事のポイント

・delegate_toでタスクを別ホスト（LBなど）に移譲できる
・run_once: trueで全ホスト中1回だけ実行を保証できる
・delegate_to＋run_onceで実行場所と回数を同時に制御できる
・serial: 1と組み合わせて無停止ローリングデプロイを設計できる

# web01の処理ループ中にlb01上でコマンドを実行する例
- name: HAProxyでweb01をバックエンドから解除する
  shell: >
    echo "disable server myapp/{{ inventory_hostname }}"
    | socat stdio /var/run/haproxy/admin.sock
  delegate_to: lb01

# lb01の上でweb01のIPアドレスを使った操作の例
- name: HAProxy統計ページで対象バックエンドの状態を確認
  shell: >
    echo "show stat"
    | socat stdio /var/run/haproxy/admin.sock
    | grep {{ hostvars[inventory_hostname]['ansible_host'] }}
  delegate_to: lb01
  register: backend_stat

# 全Webサーバーのうち1台だけでDBマイグレーションを実行する
- name: DBスキーママイグレーション（1回だけ実行）
  shell: /app/bin/migrate.sh
  run_once: true

# Ansible実行PCからSlackへ1回だけ通知する
- name: デプロイ開始をSlackに通知（1回だけ）
  uri:
    url: "{{ slack_webhook_url }}"
    method: POST
    body_format: json
    body:
      text: "Rolling deploy started: {{ ansible_date_time.iso8601 }}"
  delegate_to: localhost
  run_once: true

# inventory/hosts.ini
[lb]
lb01 ansible_host=192.168.1.10

[web]
web01 ansible_host=192.168.1.21
web02 ansible_host=192.168.1.22
web03 ansible_host=192.168.1.23

# deploy.yml --- ローリングアップデート with LB操作
- name: WebサーバーのローリングアップデートPlaybook
  hosts: web
  serial: 1
  become: true

  tasks:

    # 1. デプロイ開始通知（全体で1回だけ）
    - name: デプロイ開始をSlackに通知
      uri:
        url: "{{ slack_webhook_url }}"
        method: POST
        body_format: json
        body:
          text: "Rolling deploy started on {{ inventory_hostname }}"
      delegate_to: localhost
      run_once: true

    # 2. LBからこのホストを切り離す
    - name: HAProxyでバックエンドを無効化
      shell: >
        echo "disable server myapp/{{ inventory_hostname }}"
        | socat stdio /var/run/haproxy/admin.sock
      delegate_to: lb01

    # 3. コネクションドレインを待機する
    - name: ドレイン待機（30秒）
      pause:
        seconds: 30

    # 4. アプリを更新する
    - name: アプリパッケージを最新化
      dnf:
        name: myapp
        state: latest

    - name: アプリサービスを再起動
      systemd:
        name: myapp
        state: restarted

    # 5. ヘルスチェックが通るまで待機する
    - name: ヘルスチェックエンドポイントをポーリング
      uri:
        url: "http://{{ hostvars[inventory_hostname]['ansible_host'] }}:8080/health"
        status_code: 200
      delegate_to: localhost
      retries: 12
      delay: 5
      register: health_check
      until: health_check.status == 200

    # 6. LBにホストを復帰させる
    - name: HAProxyでバックエンドを再有効化
      shell: >
        echo "enable server myapp/{{ inventory_hostname }}"
        | socat stdio /var/run/haproxy/admin.sock
      delegate_to: lb01

PLAY [WebサーバーのローリングアップデートPlaybook] ****

TASK [デプロイ開始をSlackに通知] ****
ok: [web01 -> localhost]

TASK [HAProxyでバックエンドを無効化] ****
changed: [web01 -> lb01]

TASK [ドレイン待機（30秒）] ****
Pausing for 30 seconds
ok: [web01]

TASK [アプリパッケージを最新化] ****
changed: [web01]

TASK [アプリサービスを再起動] ****
changed: [web01]

TASK [ヘルスチェックエンドポイントをポーリング] ****
ok: [web01 -> localhost]

TASK [HAProxyでバックエンドを再有効化] ****
changed: [web01 -> lb01]

（以降、web02、web03と同様の処理が順次実行される）

PLAY RECAP ****
web01  : ok=7  changed=4
web02  : ok=7  changed=4
web03  : ok=7  changed=4

# ansible.cfg にControlPersistを設定する例
[ssh_connection]
ssh_args = -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/.ansible-ssh-%h-%p-%r

# lb01へのSSH疎通確認
ansible lb01 -m ping -i inventory/hosts.ini