Ansible : Playbook を利用する (基本)2024/09/11

Ansible Playbook の基本的な利用方法です。

Playbook は冪等性 (べきとうせい) を確保するための処理をまとめたもので、YAML 形式で記述します。

[1]

例として、あるファイルが常に同じ属性で存在するシンプルな Playbook を作成します。

freebsd@dlp:~ $

vi playbook_sample.yml

# 対象ホスト名 または グループ名
- hosts: 10.0.0.51
  tasks:
  # 任意のタスク名
  - name: Test Task
    # [file] モジュールを利用してファイルの状態を記述
    file:
      path: /home/freebsd/test.conf
      state: touch
      owner: freebsd
      group: freebsd
      mode: 0600

# Playbook 実行

freebsd@dlp:~ $

ansible-playbook playbook_sample.yml


PLAY [10.0.0.51] *******************************************************************

TASK [Gathering Facts] *************************************************************
ok: [10.0.0.51]

TASK [Test Task] *******************************************************************
changed: [10.0.0.51]

PLAY RECAP *************************************************************************
10.0.0.51                  : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

# 確認

freebsd@dlp:~ $

ansible 10.0.0.50 -m command -a "ls -l /home/freebsd"

10.0.0.51 | CHANGED | rc=0 >>
total 1
-rw-------  1 freebsd freebsd 0 Sep 11 10:25 test.conf

[2]	例として、Apache2 がインストールされ、起動した状態とする Playbook です。

freebsd@dlp:~ $

vi playbook_sample.yml

- hosts: target_servers
  # 他のユーザー権限を利用 (デフォルト : root)
  become: yes
  # 他のユーザー権限を利用する方法
  become_method: sudo
  tasks:
  # タスクの定義
  - name: apache httpd is installed
    pkgng:
      name: apache24
      state: present
  - name: apache httpd is running and enabled
    service:
      name: apache24
      state: started
      enabled: yes

freebsd@dlp:~ $

ansible-playbook playbook_sample.yml --ask-become-pass

BECOME password:

PLAY [target_servers] ***********************************************************************

TASK [Gathering Facts] **********************************************************************
ok: [10.0.0.51]
ok: [10.0.0.52]

TASK [apache httpd is installed] ************************************************************
changed: [10.0.0.52]
changed: [10.0.0.51]

TASK [apache httpd is running and enabled] *******************************************************
changed: [10.0.0.51]
changed: [10.0.0.52]

PLAY RECAP **********************************************************************************
10.0.0.51                  : ok=3    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
10.0.0.52                  : ok=3    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

# 確認

freebsd@dlp:~ $

ansible target_servers -m shell -a "/usr/sbin/service apache24 status"

10.0.0.52 | CHANGED | rc=0 >>
apache24 is running as pid 1531.
10.0.0.51 | CHANGED | rc=0 >>
apache24 is running as pid 1738.