インフラエンジニアの皆さん、こんにちは。
「サーバーの設定ファイルを手動で編集し、バックアップを取り、ミスに怯えて再起動する」……そんな非効率な日々とは今日でお別れです。
AnsibleにおけるJinja2テンプレートは、単なる「文字列の置き換え」ではありません。これは「インフラの望ましい状態をコードとして定義し、何度実行しても同じ結果を保証（冪等性）するための最強のエンジン」です。
今回は、Ansibleを使いこなす第一歩として、Jinja2テンプレートによる「設定ファイルの完全自動生成」の極意を伝授します。
—
1. なぜJinja2なのか？
Ansibleの`template`モジュールは、変数（Vars）をテンプレートファイル（`.j2`）に流し込み、目的のサーバー上に配置します。
手動設定と決定的に違うのは、「構成情報（データ）と設定ファイルの論理（ロジック）を完全に分離できる」点です。これにより、Nginxのバーチャルホストが増えても、HAProxyのバックエンドが増えても、コードを書き換えることなく「変数ファイルを更新するだけ」で対応が可能になります。
—
2. セットアップと「Hello World」の流儀
まずは最小構成で、Jinja2の力を体感しましょう。
インストール（Control Node）
Python環境があれば即座に入ります
pip install ansible
ディレクトリ構造
.
├── hosts.ini
├── site.yml
└── templates/
└── nginx.conf.j2
テンプレートの基礎 (`templates/nginx.conf.j2`)
{{ ansible_managed }} は自動生成された旨を明示する魔法の呪文
誰がいつ触ったか一目でわかります
{{ ansible_managed }}
server {
listen {{ nginx_port }};
server_name {{ server_name }};
root /var/www/html;
}
動作確認（`site.yml`）
- hosts: localhost
vars:
nginx_port: 80
server_name: “example.com”
tasks:
- name: テンプレートから設定ファイルを生成
template:
src: templates/nginx.conf.j2
dest: ./nginx.conf
`ansible-playbook site.yml` を実行すれば、直感的に設定ファイルが生成されるはずです。
—
3. 【深淵】高度なJinja2テクニック
ここからが現場で差がつくポイントです。
A. Smartな `when` 条件分岐
テンプレート内で「特定の環境のみ設定を追加したい」場合、`if`文は最強の武器です。
{% if env == ‘production’ %}
本番環境のみログレベルを厳格にする
error_log /var/log/nginx/error.log warn;
{% else %}
error_log /var/log/nginx/error.log debug;
{% endif %}
B. ジニアスなループ処理（`for`）
Nginxのアップストリーム設定など、リストから動的に生成する場合、`loop`を使いこなしましょう。
upstream backend_servers {
{% for server in backend_nodes %}
server {{ server.ip }}:{{ server.port }} weight={{ server.weight | default(1) }};
{% endfor %}
}
※ `| default(1)` のようにフィルターを噛ませるのが、堅牢なコードを書くコツです。
—
4. 禁断の秘技：カスタムフィルターの自作
標準のJinja2フィルター（`upper`, `default`など）だけでは、複雑なインフラの要求には応えられません。そんな時は「カスタムフィルター」を作りましょう。
例えば、「IPアドレスの第4オクテットだけ抽出する」という特殊な関数を自作する場合：
1. `filter_plugins/` ディレクトリを作成。
2. `my_filters.py` を配置。
filter_plugins/my_filters.py
def last_octet(ip):
return ip.split(‘.’)[-1]
class FilterModule(object):
def filters(self):
return {‘last_octet’: last_octet}
テンプレートではこう呼び出せます：
IP: 192.168.1.50 -> 50 が出力される
server_id: {{ server_ip | last_octet }}
これで、テンプレートがどれほど複雑になっても、ロジックをPython側に退避させることでメンテナンス性を維持できます。
—
最後に：エンジニアとしての心得
Ansibleでテンプレートを書く際、常に意識してほしいことが一つだけあります。それは「このテンプレートを半年後の自分が読んでも理解できるか？」という点です。
- 冪等性を信じる: 何度実行しても同じ設定になること。
- 変数は外部化する: テンプレート内にハードコーディングしない。
- コメントを惜しまない: なぜその設定が必要なのか、テンプレート内にも `#` で理由を書き残す。
これらをマスターすれば、あなたはもう「設定作業」から解放されます。空いた時間で、さらに高度な自動化やアーキテクチャの改善に挑戦してください。
インフラは自動化されるためにあります。さあ、最高のコードを書きましょう！