「初めてのAnsible」を読み進めながらのメモ
前掲
初めてのAnsible（1章：イントロダクション）
初めてのAnsible（2章：Playbook:始めてみよう）
初めてのAnsible（3章：インベントリ:サーバーの記述）
変数
playbook内での変数定義
playbook 中での変数定義はファイルに追い出すこともできる
- name : Configure webserver with nginx
hosts: vagrant
become: True
vars:
key_file: /etc/nginx/ssl/nginx.key
cert_file: /etc/nginx/ssl/nginx.crt
conf_file: /etc/nginx/sites-available/default
server_name: localhost
tasks:
- name: install nginx
apt: name=nginx update_cache=yes cache_valid_time=3600
というような playbook 内で定義している変数は vars_files を利用し分離可能
- name : Configure webserver with nginx
hosts: vagrant
become: True
vars_files:
- nginx.yml
tasks:
- name: install nginx
apt: name=nginx update_cache=yes cache_valid_time=3600
key_file: /etc/nginx/ssl/nginx.key
cert_file: /etc/nginx/ssl/nginx.crt
conf_file: /etc/nginx/sites-available/default
server_name: localhost
登録変数
-
register節を利用し、タスクの結果に応じて登録された変数
- name: capture output of whoami command
command: whoami
register: login
whoami の実行結果を変数 login に格納している
変数を確認したい場合には debug モジュールを利用して出力すればよい
- name: capture output of whoami command
command: whoami
register: login
- debug: var=login
このとき、register節を利用して登録した変数の型は以下のような辞書（マッピング）になる
ok: [vagrant1] => {
"login": {
"changed": true,
"cmd": [
"whoami"
],
"delta": "0:00:00.002230",
"end": "2016-11-13 05:49:52.211117",
"rc": 0,
"start": "2016-11-13 05:49:52.208887",
"stderr": "",
"stdout": "vagrant",
"stdout_lines": [
"vagrant"
],
"warnings": []
}
}
ここで注意しなければならないのは、register節を利用したモジュールによって返すキーは異なる、ということ
例えば...
次のような apt モジュールを利用した際の出力を変数に登録して確認する
- name : Install webserver with nginx
hosts: vagrant1
become: True
vars:
tasks:
- name: install nginx
apt: name=nginx update_cache=yes cache_valid_time=3600
register: install
- debug: var=install
初回実行時は未インストールであるため、以下のような出力となる
ok: [vagrant1] => {
"install": {
"cache_update_time": 1479016674,
"cache_updated": true,
"changed": true,
"diff": {},
"stderr": "",
"stdout": "Reading package lists...\nBuilding dependency tree... ...",
"stdout_lines": [
"Reading package lists...",
"Building dependency tree...",
"Reading state information...",
"The following extra packages will be installed:",
:
"Setting up nginx (1.4.6-1ubuntu3.7) ...",
"Processing triggers for libc-bin (2.19-0ubuntu6.9) ..."
]
}
}
しかし、2回目の実行時にはすでにインストールされているため、出力が以下のように変わる
ok: [vagrant1] => {
"install": {
"cache_update_time": 1479016674,
"cache_updated": false,
"changed": false
}
}
このように regster 節を利用するモジュールによって、出力されるキーが異なってくる場合もあるため注意が必要
特に...
登録変数の辞書のキーへアクセスする場合、playbook 実行に失敗する可能性がある
// ドット(.)を利用
{{ install.stdout }}
// 添え字([])を利用
{{ install['stdout'] }}
上記のような形式で登録変数のキーアクセスが可能
前述のようなホストの状態によって出力が変化するモジュールで登録した変数の場合、そのキーが存在しないにも関わらずアクセスしようとする場合が生じうる
ファクト
- ホストに関する以下のような情報を保存した変数
- CPUのアーキテクチャ
- OS
- IPアドレス ...
-
setupモジュールでファクトを収集できる- playbook中で明示しなくても自動的に呼んでくれている
ファクトの表示
ファクトを確認したい場合には前述のsetupモジュールを利用すればよい
ansible vagrant1 -m setup とすると結構な量の出力が得られるので眺めてみてもいいかも
見たい方はここを -> ansible-quickref/facts.rst
さらっと見て分かるのは、ファクトはすべて ansible_xxx みたいな形式になってるってこと
一部のファクトのみ得たい、という場合には ansible vagrant1 -m setup 'filter=ansible_all_ipv4_addresses' みたいな感じでフィルタリングすることも可能
組み込み変数
- playbook中でいつでも使えるように定義されている変数
一部を載せておくけど、それぞれ使って確認して見た方がいいかも
hostvars
- Ansible のホスト名をキーとして、変数名と値のマッピングを値とする辞書
あるホストから他のホストに定義された変数を利用する場合などに使える
{{ hostvars['db.example.com'].ansible_eth1.ipv4.address }}
組み込み変数 hostvars を利用することで、Ansibleの知っているホストに定義された変数を、ホスト名をキーとして取得することができる
※ Ansibleが知っている -> Ansibleがまだファクトを収集していないホストについてはむり
inventory_hostname
- Ansibleが知っている現在のホスト名
インベントリファイルでエイリアスが定義されている場合にはエイリアス名となる
hostvars[inventory_hostname]
hostvars と組み合わせることで、現在のホストに関連づけられた全ての変数を取得できる
groups
- Ansibleのグループ名をキーとして、そのグループのメンバーのホスト名のリストを値とする辞書
{% for host in groups.web %}
server {{ host.inventory_hostname }} {{ host.ansible_default_ipv4.address }}:80
{% endfor %}
上記のような設定ファイルでは、webというグループに含まれるホストに関して、そのホスト名とIPアドレスを取得している