Ansibleのfactsとgather_facts制御｜setupモジュールでホスト情報を収集して条件分岐に使う方法

この記事のポイント

・gather_facts: true（デフォルト）でsetupモジュールが自動的にホスト情報を収集する
・ansible_distributionでOS種別を判定してwhen条件分岐に使える
・gather_facts: falseに設定すると大規模環境でPlaybookを高速化できる
・/etc/ansible/facts.d/にINIファイルを置くとカスタムfactsを定義できる

PLAY [webservers] **************************************************************

TASK [Gathering Facts] *********************************************************
ok: [webserver01]
ok: [webserver02]
ok: [db01]

# 対象ホストの全factsを表示する
ansible webserver01 -m setup

# filterオプションで絞り込む（ディストリビューション情報のみ）
ansible webserver01 -m setup -a "filter=ansible_distribution*"

webserver01 | SUCCESS => {
    "ansible_facts": {
        "ansible_distribution": "RedHat",
        "ansible_distribution_major_version": "9",
        "ansible_distribution_release": "Plow",
        "ansible_distribution_version": "9.4"
    },
    "changed": false
}

# メモリ情報だけ確認する
ansible db01 -m setup -a "filter=ansible_memory_mb"

db01 | SUCCESS => {
    "ansible_facts": {
        "ansible_memory_mb": {
            "nocache": {
                "free": 13412,
                "used": 2427
            },
            "real": {
                "free": 6893,
                "total": 15839,
                "used": 8946
            },
            "swap": {
                "cached": 0,
                "free": 2047,
                "total": 2047,
                "used": 0
            }
        }
    },
    "changed": false
}

---
- name: ファイルを配布する（facts不要なため収集をスキップ）
  hosts: all
  gather_facts: false
  tasks:
    - name: 設定ファイルを転送する
      copy:
        src: files/app.conf
        dest: /etc/app/app.conf
        mode: '0644'

---
- name: ネットワーク情報だけ収集する
  hosts: all
  gather_facts: true
  gather_subset:
    - network
    - '!hardware'
    - '!virtual'
  tasks:
    - name: IPアドレスを表示する
      debug:
        msg: "{{ ansible_default_ipv4.address }}"

---
- name: Webサーバーをインストールする（OS混在環境対応）
  hosts: webservers
  become: true
  tasks:
    - name: Apache をインストールする（RHEL系）
      dnf:
        name: httpd
        state: present
      when: ansible_os_family == "RedHat"

    - name: Apache をインストールする（Debian系）
      apt:
        name: apache2
        state: present
        update_cache: true
      when: ansible_os_family == "Debian"

    - name: Apache を起動する（RHEL系：サービス名が httpd）
      service:
        name: httpd
        state: started
        enabled: true
      when: ansible_os_family == "RedHat"

    - name: Apache を起動する（Debian系：サービス名が apache2）
      service:
        name: apache2
        state: started
        enabled: true
      when: ansible_os_family == "Debian"

TASK [Apache をインストールする（RHEL系）] **********************************
changed: [webserver01]

TASK [Apache をインストールする（Debian系）] **********************************
skipping: [webserver01]

TASK [Apache をインストールする（RHEL系）] **********************************
skipping: [ubuntu01]

TASK [Apache をインストールする（Debian系）] **********************************
changed: [ubuntu01]

---
- name: MariaDB の innodb_buffer_pool_size を設定する
  hosts: dbservers
  become: true
  tasks:
    - name: バッファプールを16GB以上のサーバーは8GBに設定する
      lineinfile:
        path: /etc/my.cnf.d/server.cnf
        regexp: '^innodb_buffer_pool_size'
        line: 'innodb_buffer_pool_size = 8G'
      when: ansible_memtotal_mb >= 16384

    - name: バッファプールを8GB未満のサーバーは1GBに設定する
      lineinfile:
        path: /etc/my.cnf.d/server.cnf
        regexp: '^innodb_buffer_pool_size'
        line: 'innodb_buffer_pool_size = 1G'
      when: ansible_memtotal_mb < 8192

---
- name: DBホストにのみ監視エージェントの設定を追加する
  hosts: all
  tasks:
    - name: DB用の監視設定を配置する（ホスト名に "db" が含まれるホストのみ）
      copy:
        src: files/db-monitor.conf
        dest: /etc/monitor/db-monitor.conf
      when: "'db' in ansible_hostname"

    - name: 特定サブネットのホストにのみファイアウォール設定を適用する
      firewalld:
        zone: internal
        permanent: true
        state: enabled
      when: ansible_default_ipv4.address | ansible.utils.ipaddr('192.168.10.0/24')

# /etc/ansible/facts.d/app.fact（INI形式）
# このファイルを対象ホストに事前に配置する

[app]
version = 2.5.1
environment = production
deploy_user = appuser

---
- name: カスタムfactsファイルを配置する
  hosts: appservers
  become: true
  tasks:
    - name: facts.d ディレクトリを作成する
      file:
        path: /etc/ansible/facts.d
        state: directory
        mode: '0755'

    - name: カスタムfactsファイルをコピーする
      copy:
        src: files/app.fact
        dest: /etc/ansible/facts.d/app.fact
        mode: '0644'

    - name: カスタムfactsを再収集する
      setup:
        filter: ansible_local

---
- name: カスタムfactsを使ってアプリの設定を制御する
  hosts: appservers
  tasks:
    - name: アプリのバージョンを表示する
      debug:
        msg: "アプリバージョン: {{ ansible_local.app.app.version }}"

    - name: 本番環境のみロギングを有効化する
      template:
        src: templates/logging.conf.j2
        dest: /etc/app/logging.conf
      when: ansible_local.app.app.environment == "production"