AnsibleのJinja2フィルター設計入門｜変数変換・デフォルト値・リスト操作でPlaybookの柔軟性を高めるパターン集

この記事のポイント

・defaultフィルターで未定義変数を安全な既定値で処理できる
・int・bool・stringフィルターで型の不一致エラーを防げる
・select・map・combineでリスト・辞書を動的に変換する設計ができる
・ternaryフィルターで条件分岐をインラインに書きPlaybookを短くできる

---
- name: ポート設定の確認
  hosts: localhost
  vars:
    port: "8080"    # INI形式インベントリから文字列として渡される
  tasks:
    - debug:
        msg: "次のポート番号: {{ port + 1 }}"
# エラー: TypeError: can only concatenate str (not "int") to str

# roles/webapp/tasks/main.yml
---
- name: アプリのポートを確認
  debug:
    msg: "使用ポート: {{ webapp_port | default(8080) }}"

# webapp_portを指定した場合
$ ansible-playbook -i hosts site.yml -e 'webapp_port=9000'
TASK [アプリのポートを確認]
ok: [web01] => {
    "msg": "使用ポート: 9000"
}

# webapp_portを指定しなかった場合
$ ansible-playbook -i hosts site.yml
TASK [アプリのポートを確認]
ok: [web01] => {
    "msg": "使用ポート: 8080"
}

# 未定義・空文字・falseのいずれでもデフォルト値8080を使う
{{ webapp_port | default(8080, true) }}

# hosts（INI形式インベントリ）
[webservers]
web01   app_workers=4   webapp_port=8080   use_ssl=yes

# tasks/main.yml
---
- name: ワーカー数の計算
  debug:
    msg: "総接続数上限: {{ app_workers | int * 100 }}"

- name: SSL設定の判定
  debug:
    msg: "SSL: {{ 'enabled' if use_ssl | bool else 'disabled' }}"

TASK [ワーカー数の計算]
ok: [web01] => {
    "msg": "総接続数上限: 400"
}
TASK [SSL設定の判定]
ok: [web01] => {
    "msg": "SSL: enabled"
}

---
- name: ログディレクトリのパスを生成
  vars:
    app_name: "MyWebApp"
    environment: "Production"
  debug:
    msg: "ログ先: /var/log/{{ app_name | lower }}/{{ environment | lower }}"
# 出力: "ログ先: /var/log/mywebapp/production"

# "prod"・"production"・"PROD" をすべて "production" に統一
{{ env_name | lower | regex_replace('^prod(uction)?$', 'production') }}

$ ansible -i hosts localhost -m debug \
    -a "msg={{ 'prod' | lower | regex_replace('^prod(uction)?$', 'production') }}"
ok: [localhost] => {
    "msg": "production"
}

$ ansible -i hosts localhost -m debug \
    -a "msg={{ 'PROD' | lower | regex_replace('^prod(uction)?$', 'production') }}"
ok: [localhost] => {
    "msg": "production"
}

$ ansible -i hosts localhost -m debug \
    -a "msg={{ 'staging' | lower | regex_replace('^prod(uction)?$', 'production') }}"
ok: [localhost] => {
    "msg": "staging"
}

---
- name: 1000以上のポートのみ取得
  vars:
    all_ports: [80, 443, 8080, 8443, 22, 3306]
  debug:
    msg: "{{ all_ports | select('ge', 1000) | list }}"
# 出力: "[8080, 8443]"

---
- name: サーバー名にドメインを付ける
  vars:
    servers: ["web01", "web02", "db01"]
  debug:
    msg: "{{ servers | map('regex_replace', '$', '.example.com') | list }}"
# 出力: "['web01.example.com', 'web02.example.com', 'db01.example.com']"

---
- name: デフォルト設定とユーザー設定をマージ
  vars:
    default_config:
      port: 80
      timeout: 30
      debug: false
    user_config:
      port: 8080
      debug: true
  debug:
    msg: "{{ default_config | combine(user_config) }}"
# 出力: "{'port': 8080, 'timeout': 30, 'debug': True}"
# user_configで上書きされたport・debugだけが変わり、timeoutはデフォルト値が維持される

---
- name: パッケージをバージョン指定でインストール
  vars:
    packages:
      nginx: "latest"
      php-fpm: "8.2"
      mariadb: "10.11"
  ansible.builtin.dnf:
    name: "{{ item.key }}"
    state: "{{ item.value }}"
  loop: "{{ packages | dict2items }}"

---
- name: ログレベルを環境別に設定
  vars:
    is_production: true
  debug:
    msg: "ログレベル: {{ is_production | bool | ternary('warn', 'debug') }}"
# 出力: "ログレベル: warn"（is_production が true なので）

# templates/nginx.conf.j2
worker_processes  {{ ansible_processor_vcpus | default(1) }};
error_log  /var/log/nginx/error.log {{ nginx_log_level | lower | default('warn') }};
gzip  {{ nginx_enable_gzip | default(true) | bool | ternary('on', 'off') }};

---
# backup_enabledが未定義か false なら when を満たさずスキップ
- name: バックアップ先を確認
  debug:
    msg: "バックアップ先: {{ backup_path | default('/var/backup') }}"
  when: backup_enabled | default(false) | bool

roles/
  nginx/
    defaults/
      main.yml       # デフォルト変数の宣言（型も明示）
    tasks/
      main.yml       # フィルターを使った処理
    templates/
      nginx.conf.j2  # テンプレート内フィルター

# roles/nginx/defaults/main.yml
---
nginx_port: 80              # int
nginx_worker_processes: 2   # int
nginx_enable_gzip: true     # bool
nginx_log_level: "warn"     # string: debug/info/notice/warn/error/crit
nginx_allowed_ips: []       # list（空=制限なし）
nginx_server_name: "localhost"  # string

# roles/nginx/tasks/main.yml
---
- name: ポートをファイアウォールに登録
  ansible.builtin.firewalld:
    port: "{{ nginx_port | int }}/tcp"
    permanent: true
    state: enabled

- name: ワーカー数を物理コア数上限に調整
  ansible.builtin.set_fact:
    nginx_workers_actual: "{{ [nginx_worker_processes | int, ansible_processor_vcpus | int] | min }}"

- name: Nginx設定ファイルを展開
  ansible.builtin.template:
    src: nginx.conf.j2
    dest: /etc/nginx/nginx.conf
    owner: root
    group: root
    mode: '0644'
  notify: reload nginx

worker_processes  {{ nginx_workers_actual | int }};
pid               /run/nginx.pid;

error_log  /var/log/nginx/error.log {{ nginx_log_level | lower }};

events {
    worker_connections  {{ nginx_worker_processes | int * 1024 }};
}

http {
    gzip  {{ nginx_enable_gzip | bool | ternary('on', 'off') }};

    server {
        listen {{ nginx_port | int }};
        server_name {{ nginx_server_name }};

{% if nginx_allowed_ips | length > 0 %}
{% for ip in nginx_allowed_ips %}
        allow {{ ip }};
{% endfor %}
        deny all;
{% endif %}
    }
}