AnsibleのBlocks・rescue・alwaysでエラー処理を設計する方法｜タスク失敗時のロールバックと通知の実践パターン

この記事のポイント

・block・rescue・alwaysで失敗時の自動ロールバックを設計できる
・rescueではansible_failed_taskで失敗原因を取得できる
・alwaysは成否を問わず実行。ロック解除・通知に使う
・rescue内で失敗するとfailed=1。軽量タスクのみに絞る

# deploy.yml（基本的なblock/rescue/always構造）
---
- name: アプリデプロイPlaybook
  hosts: webservers
  tasks:
    - block:
        - name: アプリパッケージを配布する
          ansible.builtin.copy:
            src: /deploy/myapp-2.5.0.tar.gz
            dest: /opt/myapp/myapp-2.5.0.tar.gz
            owner: appuser
            mode: '0644'

        - name: アプリを展開する
          ansible.builtin.unarchive:
            src: /opt/myapp/myapp-2.5.0.tar.gz
            dest: /opt/myapp/
            remote_src: true

        - name: サービスを再起動する
          ansible.builtin.systemd:
            name: myapp
            state: restarted
      rescue:
        - name: サービスを停止する
          ansible.builtin.systemd:
            name: myapp
            state: stopped

        - name: 前回のデプロイを復元する
          ansible.builtin.copy:
            src: /deploy/myapp-2.4.1.tar.gz
            dest: /opt/myapp/myapp-backup.tar.gz
            owner: appuser
            mode: '0644'

        - name: 旧バージョンでサービスを起動する
          ansible.builtin.systemd:
            name: myapp
            state: started
      always:
        - name: デプロイ結果をログに記録する
          ansible.builtin.lineinfile:
            path: /var/log/deploy.log
            line: "{{ ansible_date_time.iso8601 }}: deploy on {{ inventory_hostname }} finished"
            create: true

# ansible-playbook deploy.yml の実行ログ（rescueが発動した例）
# 環境: RHEL 9.4 / Ansible Core 2.16 / 対象: web01.example.com

PLAY [アプリデプロイPlaybook] *********************************

TASK [アプリパッケージを配布する] ****************************
changed: [web01.example.com]

TASK [アプリを展開する] *************************************
changed: [web01.example.com]

TASK [サービスを再起動する] **********************************
fatal: [web01.example.com]: FAILED! => {
    "changed": false,
    "msg": "Failed to restart myapp.service: Unit not found."
}

TASK [サービスを停止する] ************************************
changed: [web01.example.com]

TASK [前回のデプロイを復元する] ******************************
changed: [web01.example.com]

TASK [旧バージョンでサービスを起動する] ***********************
changed: [web01.example.com]

TASK [デプロイ結果をログに記録する] **************************
changed: [web01.example.com]

PLAY RECAP ***************************************************
web01.example.com  : ok=5  changed=5  unreachable=0  failed=0  rescued=1

# whenとbecomeをblockレベルで設定する例
- block:
    - name: Nginxをインストールする
      ansible.builtin.dnf:
        name: nginx
        state: present
    - name: Nginxを起動する
      ansible.builtin.systemd:
        name: nginx
        state: started
  when: ansible_os_family == "RedHat"
  become: true
  rescue:
    - name: エラーをデバッグ出力する
      ansible.builtin.debug:
        msg: "Nginx設定に失敗しました: {{ ansible_failed_task.name }}"

# 失敗情報を取得して記録する
rescue:
  - name: 失敗したタスクとエラー内容をデバッグ出力する
    ansible.builtin.debug:
      msg:
        - "失敗タスク: {{ ansible_failed_task.name }}"
        - "エラーメッセージ: {{ ansible_failed_result.msg | default('メッセージなし') }}"

  - name: 失敗内容をログファイルに書き込む
    ansible.builtin.lineinfile:
      path: /var/log/ansible-deploy-error.log
      line: >-
        {{ ansible_date_time.iso8601 }}
        host={{ inventory_hostname }}
        task={{ ansible_failed_task.name }}
      create: true

# alwaysで一時ファイルとロックを確実に削除する例
always:
  - name: 作業用の一時ディレクトリを削除する
    ansible.builtin.file:
      path: /tmp/deploy_work
      state: absent

  - name: デプロイロックファイルを解除する
    ansible.builtin.file:
      path: /var/lock/deploy.lock
      state: absent

# alwaysで成否に応じてメッセージを切り替える例
always:
  - name: デプロイ完了通知を送る
    ansible.builtin.uri:
      url: "{{ notification_webhook_url }}"
      method: POST
      body_format: json
      body:
        text: >-
          {{ inventory_hostname }}: {{
            '失敗→ロールバック完了' if ansible_failed_task is defined
            else 'デプロイ成功'
          }}
    ignore_errors: true

# roles/deploy/tasks/main.yml（本番デプロイのロールバック設計）
---
- name: バックアップを取得してからデプロイする
  block:
    - name: 現行バージョンをバックアップする
      ansible.builtin.copy:
        src: /opt/myapp/current/
        dest: /opt/myapp/backup/
        remote_src: true

    - name: 新バージョンを展開する
      ansible.builtin.unarchive:
        src: "{{ deploy_package }}"
        dest: /opt/myapp/current/
        remote_src: true

    - name: DBマイグレーションを実行する
      ansible.builtin.command:
        cmd: /opt/myapp/current/bin/migrate.sh
      register: migrate_result

    - name: ヘルスチェックエンドポイントを確認する
      ansible.builtin.uri:
        url: http://localhost:8080/healthz
        status_code: 200
        timeout: 10
      retries: 5
      delay: 3
  rescue:
    - name: ロールバック開始をデバッグ出力する
      ansible.builtin.debug:
        msg: "デプロイ失敗: {{ ansible_failed_task.name }}。ロールバックします"

    - name: バックアップを現行ディレクトリに戻す
      ansible.builtin.copy:
        src: /opt/myapp/backup/
        dest: /opt/myapp/current/
        remote_src: true

    - name: サービスを再起動する
      ansible.builtin.systemd:
        name: myapp
        state: restarted
  always:
    - name: デプロイログにステータスを記録する
      ansible.builtin.lineinfile:
        path: /var/log/deploy.log
        line: >-
          {{ ansible_date_time.iso8601 }} {{ inventory_hostname }}:
          {{ 'ROLLBACK' if ansible_failed_task is defined else 'SUCCESS' }}
        create: true

# rescue内でSlack Webhookへ通知する例
rescue:
  - name: Slackへ障害通知を送る
    ansible.builtin.uri:
      url: "{{ slack_webhook_url }}"
      method: POST
      body_format: json
      body:
        text: |
          [障害] デプロイ失敗
          ホスト: {{ inventory_hostname }}
          失敗タスク: {{ ansible_failed_task.name }}
          エラー: {{ ansible_failed_result.msg | default('詳細不明') }}
    ignore_errors: true