こんにちは、KTです。

前回に引き続き、Ansibleの話題です。

タイトル通り、今回はAnsibleのPlaybookをどのようにまとめるかを備忘録がてらまとめていきたいと思います。

まずは前回もちょろっと書いた、Playbookについて。

このような形で、タスクを書けばAnsibleがそのタスクを実行してくれます。

タスクは縦にどんどん並べることができるので、例えば、Vimをインストールしたければ

このような感じになります。上から、それぞれ依存パッケージのインストールタスク、vimソースのcloneタスク、vimのインストールタスクとなっています。

では他にMySQLのインストールも追加しましょう。じゃあPHPも。っていう感じで、どんどんタスクを並べることも出来ますが、かなり長くなりそうですよね。パッと見も分かりづらいし。

 

AnsibleのRolesを使おう

そんな時はRolesというAnsibleの機能を使うことで、任意の単位でファイルごとに分割することが出来ます。

まずはansibleを利用するトップディレクトリ（main.ymlを置いていたディレクトリ）に、roles というディレクトリを作成し、その中に機能毎のディレクトリを作っていきまっしょい。

なお、機能毎のディレクトリ名は、tasksやvarsなど、Ansibleで使われる予約語は避けましょう。

 

お察しのとおり、各機能のタスク（これをロールと呼びます）はこのディレクトリの中に作っていくわけですが、まずは、Ansibleに「タスクをここに置いてるよ！」って伝える必要があります。そのために、まずはtasksというディレクトリを作成しましょう。これでAnsibleはtasksの中にあるファイルがタスクなんだって判断してくれるようになります。CoCっぽい感じですね。

tasksディレクトリの中に置くタスクのファイルは、main.ymlという名前にしましょう。それ以外は不可です（多分）

main.ymlに書く内容は、タスクを並べるだけでOKです。hostsとかtasksとかは不要です。

先ほどの例で、Vimのタスクを作る場合は

のようになります。

同じように、MySQL、PHPのタスクを書くと、以下のようなディレクトリ構成になります。

rolesディレクトリに各機能のディレクトリがあって、その中にtasks、さらにその中にmain.ymlという感じです。ちなみに、各機能のディレクトリは更に階層を持たせることが出来ます。

のような配置も可能です。要は、rolesの下にディレクトリがあって、その中にtasksがあればOKということです。

 

これで、各タスクをファイルに分割出来ましたね。

あとは、トップディレクトリのmain.ymlで、そのロールを使うよって宣言をすれば完了です。

はい。これだけです。tasks: 〜 と書いてあった部分を、roles: に変更して、使いたいロールの名称（ディレクトリ名）を並べるだけです。トップディレクトリのmain.ymlがかなりスッキリわかりやすくなりましたね。機能を追加したり、削除したりも非常に簡単になりました。

なお、ロールがディレクトリ階層を持つ場合は、/ 区切りで書きます。先ほど例で挙げた、editorsの下にvimとemacsがある場合は、

というふうに書きましょう。

 

変数を使いたい

さて、ここで先ほどのVimの例のタスクを見てみましょう。

うーん。まだ長い＆分かりづらいですね。まだまだ改善の余地はありそうです。

手始めに、後で変更する可能性のある requires install の with_items の中身を別ファイルに追い出してみましょう。

まずは、roles/vim の下に vars というディレクトリを作成しましょう。そうすることで Ansible が「ここに変数がある」って理解してくれます。もちろん、vars の下に置くファイルも、main.yml です。

こんなかんじですね。あとは、vars/main.yaml に使いたい変数を書くだけです。

このように、tasks側からは {{ 変数名 }} で呼び出すことが出来ます。with_itemsの場合は””で囲う必要がありますが、その辺はまだ良くわかってないです汗

 

最後に、install vim の設定オプションも変数に追い出しちゃいましょう。

これでタスクの記述がかなりスッキリしましたね！何をしているかが明確に分かるようになりました！

 

他にも・・・

tasks、vars ディレクトリを作ると、Ansibleが勝手に「タスクだ！」「変数だ！」って理解してくれるって話をしましたが、もちろん他にもAnsibleが理解してくれるディレクトリが幾つかあります。今回の例では使いませんでしたが、使ったことがあるディレクトリを紹介しておきます。

・files

タスク内で copy コマンドで使用するファイルを格納します。

・templates

タスク内で template コマンドで使用するファイルを格納します。

・meta

タスクの依存関係を定義します。

 

以上！でわでわ