Ansible Playbook ベストプラクティスチェックリスト

# 実践的なインフラエンジニアのAnsible Playbookの味 - 作業を明確なデフォルトを持つロールに整理し、Playbookは薄く保ち、主にホストグループに適用するロールのリストにする。信頼度: 0.90 - すべてのタスクでansible.builtin.copyのような完全修飾コレクション名を使用し、モジュールが曖昧にならないようにする。信頼度: 0.85 - requirements.ymlファイルでコレクションとロールのバージョンを固定し、CIではそのファイルからのみインストールする。信頼度: 0.90 - すべてのタスクを冪等に書き、収束したホストで2回目の実行がゼロ変更を報告するようにする。信頼度: 0.95 - shellやcommandよりも目的に特化したモジュールを優先し、shellが避けられない場合はcreates、removes、またはchanged_whenを明示的に設定する。信頼度: 0.90 - すべてのタスクに明確で人間が読める名前を付け、実行するコマンドではなく保証する状態を示す。信頼度: 0.80 - 変数をgroup_varsとhost_varsに保持し、同じ変数を2箇所以上で設定しないようにする。信頼度: 0.85 - ロール変数にはnginx_worker_processesのようにロール名をプレフィックスし、ロール間の衝突を避ける。信頼度: 0.85 - シークレットはAnsible Vaultまたは外部シークレットマネージャーのルックアップに保存し、平文でコミットしない。信頼度: 0.95 - サービス再起動にはハンドラーを使用し、設定が実際に変更された場合のみ、最後に一度だけ再起動するようにする。信頼度: 0.90 - Jinja2で設定ファイルをテンプレート化し、サービスがサポートする場合はvalidateオプションを使用して置き換える前に検証する。信頼度: 0.85 - すべてのプルリクエストでCIでansible-lintとyamllintを実行する。信頼度: 0.85 - サポートされている各オペレーティングシステムに対して、使い捨てのコンテナまたはVMでMoleculeを使用してロールをテストする。信頼度: 0.75 - 本番環境に変更を適用する前に--checkと--diffを使用し、コード変更のように差分をレビューする。信頼度: 0.85 - 本番環境への展開はserialバッチとmax_fail_percentageを使用して、悪い変更がすべてのホストに到達する前に停止するようにする。信頼度: 0.85 - 手編集のホストリストではなく、クラウドプロバイダーまたはCMDBからの動的インベントリを維持する。信頼度: 0.75 - タグは控えめかつ一貫して使用し、主に1つのロールまたは1つの関心事を実行するために使用し、隠れた実行パスを構築しない。信頼度: 0.70 - ignore_errorsを避け、失敗が予想される場合は正確な条件を持つfailed_whenまたはrescue付きのblockを使用する。信頼度: 0.85 - becomeはPlay全体ではなく、rootが必要なタスクにのみ設定する。信頼度: 0.75 - SSHパイプラインを有効にしてforksを調整して実行時間を短縮し、さらに最適化する前にprofile_tasksコールバックで測定する。信頼度: 0.70 - 個人的なラップトップではなく、CIまたはAWXなどの制御されたランナーからPlaybookを実行し、すべての変更が記録されるようにする。信頼度: 0.80