Ansibleのpre_tasks・post_tasksで実行順序を設計する方法｜Playbookの前処理・後処理とhandlerの実行タイミングを理解する設計入門

この記事のポイント

・pre_tasksはroles・tasks実行前、post_tasksは実行後に動く
・前提条件チェックをpre_tasksに入れると障害を事前に検出できる
・handlerの実行タイミングを把握するとPre/Post設計の信頼性が上がる
・flush_handlersでhandlerをその場で実行する場面を覚えておく

# pre_tasks でディスク残量を確認してから role を動かす例
- hosts: webservers
  pre_tasks:
    - name: ディスク残量が10GB以上あることを確認する
      ansible.builtin.assert:
        that:
          - ansible_mounts | selectattr('mount', '==', '/') | map(attribute='size_available') | first > 10737418240
        fail_msg: "/ のディスク残量が不足しています。role の実行を中断します。"
        success_msg: "ディスク残量を確認しました。処理を続けます。"
  roles:
    - webserver_deploy

# RHEL系のみに適用するroleを動かす前にOS確認
- hosts: all
  pre_tasks:
    - name: 対象OSがRHEL系であることを確認する
      ansible.builtin.assert:
        that:
          - ansible_os_family == "RedHat"
        fail_msg: "このPlaybookはRHEL系OSにのみ対応しています（検出: {{ ansible_os_family }}）"
  roles:
    - rhel_hardening

# NTPサービスの起動を事前確認
- hosts: appservers
  pre_tasks:
    - name: chronydが起動していることを確認する
      ansible.builtin.service_facts:

    - name: chronydが起動状態であることをassertする
      ansible.builtin.assert:
        that:
          - ansible_facts.services['chronyd.service']['state'] == 'running'
        fail_msg: "chronydが起動していません。時刻同期を先に確認してください。"
  roles:
    - app_deploy

# roleでデプロイ後にヘルスチェックを走らせる
- hosts: webservers
  roles:
    - app_deploy
  post_tasks:
    - name: アプリケーションのヘルスチェックエンドポイントを確認する
      ansible.builtin.uri:
        url: "http://{{ inventory_hostname }}:8080/health"
        return_content: false
        status_code: 200
      retries: 5
      delay: 10
      register: health_result
      until: health_result.status == 200

# post_tasks で Slack 通知を送る
  post_tasks:
    - name: Slack にデプロイ完了を通知する
      community.general.slack:
        token: "{{ slack_token }}"
        msg: "{{ inventory_hostname }} へのデプロイが完了しました"
        channel: "#deploy-notify"
      delegate_to: localhost

# 間違えやすい例: post_tasks の前に httpd を再起動したい
  tasks:
    - name: Apacheの設定ファイルを更新する
      ansible.builtin.template:
        src: httpd.conf.j2
        dest: /etc/httpd/conf/httpd.conf
      notify: httpd を再起動する

  post_tasks:
    - name: Apacheが応答することを確認する  # この時点ではhandlerがまだ動いていない
      ansible.builtin.uri:
        url: "http://localhost/health"
        status_code: 200

  handlers:
    - name: httpd を再起動する
      ansible.builtin.service:
        name: httpd
        state: restarted

# flush_handlers で handler を先に実行してから post_tasks へ
- hosts: webservers
  tasks:
    - name: Apacheの設定ファイルを更新する
      ansible.builtin.template:
        src: httpd.conf.j2
        dest: /etc/httpd/conf/httpd.conf
      notify: httpd を再起動する

    - name: notifyされたhandlerをここで先に実行する
      ansible.builtin.meta: flush_handlers

  post_tasks:
    - name: Apacheが応答することを確認する  # この時点でhandlerは完了済み
      ansible.builtin.uri:
        url: "http://localhost/health"
        status_code: 200

  handlers:
    - name: httpd を再起動する
      ansible.builtin.service:
        name: httpd
        state: restarted

# 前処理・本処理・後処理の3層構造
- hosts: appservers
  gather_facts: true

  pre_tasks:
    - name: ディスク残量を確認する（1GB以上）
      ansible.builtin.assert:
        that:
          - ansible_mounts | selectattr('mount', '==', '/') | map(attribute='size_available') | first > 1073741824
        fail_msg: "ディスク残量不足のため処理を中断します"

    - name: 依存サービスの起動を確認する
      ansible.builtin.service_facts:

    - name: MariaDBが起動していることをassertする
      ansible.builtin.assert:
        that:
          - ansible_facts.services['mariadb.service']['state'] == 'running'
        fail_msg: "MariaDBが起動していません"

  roles:
    - app_deploy
    - nginx_config

  post_tasks:
    - name: notifyされたhandlerを先に実行する
      ansible.builtin.meta: flush_handlers

    - name: アプリケーションのヘルスチェック
      ansible.builtin.uri:
        url: "http://{{ inventory_hostname }}/health"
        status_code: 200
      retries: 3
      delay: 10
      register: check_result
      until: check_result.status == 200

    - name: デプロイ完了をSlackへ通知する
      community.general.slack:
        token: "{{ slack_token }}"
        msg: "{{ inventory_hostname }} のデプロイが完了しました（ヘルスチェック: OK）"
        channel: "#ops-notify"
      delegate_to: localhost