4. Ansible playbook の作成

# 4. Ansible playbook の作成

皆さんはここまでで既にansible を使ってホストの管理を行っていました。先ほどの演習で使ったansibleコマンドがそれであり、ほかにも様々なモジュールを用いることで例えばアプリケーションのインストールなども行うことができます。

しかし、Ansible のアドホックコマンドは単純なオペレーションには便利ですが、複雑な構成管理や作業の定型化などには適していません。 Ansible の真価を発揮するためには、Playbook の使用方法を学習し、一連のターゲットホストに対して複数の複雑なタスクを簡単に反復可能な方法で実行できるようにする必要があります。

# Playbook について

Playbook（プレイブック）は、管理対象に対してこうなってほしいという構成や手順を記述したファイルです。 playbook は先ほど実行していたアドホックコマンドを複数取り込み、複数の task のセットとして利用することができるようになります。

タスクは、特定の作業単位を実行するモジュールのアプリケーションです。つまり、Playbook とは、特定の順序で実行される 1 つ以上の task を含むテキストファイルです。

では、これまでアドホックに行っていた ansible ping を行う playbook を作成してみましょう。 PlaybookはYAMLと呼ばれる書式によって書く必要があります。

# [演習] Playbookの作成

Ansibleのplaybookを作成します。今回はplaybook.ymlとして作成してみます
- docker 上で作成する場合は以下の通りvi 等でテキストファイルを作成します
- 演習環境に沿って実施している人は ansible フォルダがそのままconsoleホストにマウントされているため、ansibleフォルダ配下にファイルを作成しvscodeで編集することが可能です
playbook.ymlの作成
- 以下のように記載します
```
---
- hosts: exercise
  tasks:
    - ping:
```
  1
  2
  3
  4

playbookの実行

Playbookの実行にはansible-plyabookというコマンドを使って実行します
```
ansible-playbook playbooks.yml
```
1

実行結果

SSH password:

PLAY [exercise] ***********************************************************************************************************

TASK [Gathering Facts] ****************************************************************************************************
ok: [host00]
ok: [host01]

TASK [ping] ***************************************************************************************************************
ok: [host01]
ok: [host00]

PLAY RECAP ****************************************************************************************************************
host00                     : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
host01                     : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   ```

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

上記の通り exercise グループに属している host00, host01, の 2 台に対し、ping モジュールが実行されOKが表示されれば成功です。

# 解説

1 行目: ---
- Playbook の始まりを意味します
- YAML における形式の区切りの意味も持つため Playbook を書く際には必ず入れましょう
2 行目 hosts: exercise
- この Playbook（Play）は、Inventory の中のexerciseグループに対して実行すると示します
4 行目 tasks:
- この行以下は、この Playbook（Play）で実行される task を定義します
- tasks 後の行は、インデント（行頭の空白による字下げ）が入ります
  - このインデントは、YAML の書式同様、以降の要素が tasks の子要素や孫要素となっていることを意味します
5 行目 ping
- ここでpingモジュールを用いて操作する事（task)を宣言します
  - モジュールによって様々なオプションを追加することがあります

# [発展] gather の停止

先ほどの実行結果で TASK[ping] の前に TASK[Gathering Facts]というものがあったことに気づいたでしょうか。 Ansible は通常、実行する際に実行対象となるホストから様々な情報の収集を行っています。これらはansible_factsと呼ばれる特殊な変数に格納され、続くtaskで活用したり、収集結果をファイルに出力するなどに活用することができます。

しかし一方でそういった情報を収集する必要が無い場合は、収集の分だけ実行時間が長引くことになってしまいます。従って収集する必要がない場合は明示的に情報収集を停止したり、設定ファイルを編集し、デフォルトの動作を切り替えることで収集を停止し、即座に記載したtaskを実行させることができます。

以下のいずれかを実施することで下記の通り直ぐにpingモジュールの実行に移ることができます。

ansible-playbook playbooks.yml
SSH password:

PLAY [exercise] ***********************************************************************************************************

TASK [ping] ***************************************************************************************************************
ok: [host01]
ok: [host00]

PLAY RECAP ****************************************************************************************************************
host00                     : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
host01                     : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

1
2
3
4
5
6
7
8
9
10
11
12

# playbook単位での停止

playbookに以下を宣言することで停止することができます
- 記載する場所どこでも構いませんがhosts等のセクションと同じレベル（同じインデントレベル）で宣言する必要があります。
```
gather_facts: false
```
1

# 設定ファイルでの停止

ansible.cfg に以下の通り記載することでこのplaybookに宣言しなくともgatherを停止することができます
- 宣言する箇所は[defaults]セクションに宣言してください
```
gathering = explicit
```
1