Ansibleで「冪等性」を神格化せよ：エラーゼロで突き抜ける現場の極意
いいか、Ansibleを「ただのスクリプト実行ツール」だと思っているなら、今すぐその考えを捨てろ。
Ansibleの本質は「状態の定義」だ。「こうあってほしい」という理想の状態を宣言し、現在の状態との差分を埋める。この「差分を埋める（Diff）」というプロセスにおいて、何度叩いても結果が変わらない「冪等性（Idempotency）」こそが、インフラ自動化の生命線だ。
今回は、現場で泥沼にハマる「非冪等なPlaybook」を撲滅し、CI/CDパイプラインを止めることのない、プロの設計思想を叩き込む。
—
1. commandモジュールの乱用は「恥」と思え
初心者はすぐ `shell` や `command` に逃げる。だが、これらはAnsibleの魂である「状態管理」を放棄する行為だ。`command` は実行結果を記録しない。だから何度でも実行される。
究極の防御術：creates / removes を活用せよ
どうしてもシェルコマンドが必要な場合でも、`creates` 引数を使って「そのファイルがあれば実行しない」という条件を明示しろ。
- name: コンパイル済みのバイナリがあればスキップする
command: /usr/local/bin/build_service.sh
args:
# このファイルが存在すれば、このタスクは「OK」として終了し実行されない
creates: /usr/local/bin/my_service_binary
chdir: /opt/src/my_service
これだけで、再実行時に無駄な処理が走るのを防げる。これが冪等性の第一歩だ。
—
2. チーム開発の生産性を爆速にする「神設定」
個人の好みに任せた設定は、チームの生産性を殺す。以下の設定を `ansible.cfg` に強制適用し、開発体験（DX）を底上げしろ。
[defaults]
実行時間を計測し、どのタスクがボトルネックか可視化する
callback_whitelist = profile_tasks
ログ出力の視認性を高める（標準の出力は読みづらすぎる）
stdout_callback = yaml
未定義の変数が使われたら即座にエラーにする（事故防止）
error_on_undefined_vars = True
[ssh_connection]
SSH接続のオーバーヘッドを極限まで削る（SSHパイプライン化）
pipelining = True
プロの小技: `profile_tasks` を入れろ。全タスクの実行時間がミリ秒単位で表示される。CI/CDパイプラインのチューニングにおいて、これなしで作業するのは目隠しで高速道路を走るようなものだ。
—
3. 設定ファイル（YAML）のベストプラクティス
複雑な構成をすべて1つのファイルに押し込むな。論理的な構造で分割しろ。
roles/
web_server/
tasks/
main.yml # エントリポイント
install.yml # パッケージ管理
configure.yml # 設定ファイル配置
service.yml # サービスの起動・監視
templates/ # Jinja2テンプレートはここに隔離
vars/
main.yml # 変更頻度の低いデフォルト値
極意: `vars` と `defaults` を使い分けろ。`defaults/main.yml` には「いつでも上書き可能なデフォルト値」を置き、ホスト固有の設定は `group_vars` で管理する。この階層構造を徹底しないと、大規模環境では破綻する。
—
4. 開発効率を劇的に変える「神プラグイン・ツール」
- Ansible Lint: 規約違反を許すな。CIのステージに必ず入れろ。
- Molecule: これを使わずに「テストコードを書きました」と名乗るな。コンテナを使って、ローカルで本番環境と同等のテストを自動化しろ。
- VS Code拡張機能: `Ansible` (Red Hat公式) を入れろ。YAMLのスキーマ補完が効くようになる。これがないと、変数名のタイプミスで数時間のデバッグ地獄を見る羽目になる。
—
5. テックリードからの提言： 「冪等性」はテスト駆動で勝ち取れ
私が現場で最も重視するのは、「同じPlaybookを3回連続で実行し、2回目と3回目に『changed=0』になること」だ。
もし1つでも `changed` が出るなら、それはまだ「状態」が確定していない証拠だ。
1. 宣言的であること: 「何をしたいか」を書け。「どうやって」実行するかはモジュールに任せろ。
2. 冪等であること: 実行結果を予測可能にしろ。
3. 冪等性をテストすること: Moleculeを使い、CI上で「冪等性テスト」をパスさせる。
インフラをコード化するとは、単にコマンドを羅列することではない。「何度叩いても、システムが常に期待した状態に収束する」という信頼そのものを作る作業だ。
君たちのPlaybookが、明日の深夜にアラートを鳴らさないための「完璧な防壁」になることを期待している。健闘を祈る。