リポジトリで定義するインフラ
12,065行のYAMLにわたる19本のAnsible プレイブックと34個のロールで自社インフラを構築し、すべてのプレイを冪等にして、稼働中のホストを宣言した状態へ収束させた。
実施時期: 8月 2026
プラットフォームの設定が適用されるまで
プロビジョニングの実装概要です。再構築には認証情報とプロバイダー側の前提条件が必要です。
宣言された設定
ホストの階層とグループ変数により、各マシンに適用すべき設定を指定します。
Ansibleロール
Ansibleロールが、選択したホストに宣言された設定を適用します。
サービス定義
systemdのユニットとサービス定義が、プロビジョニングされたサービスの実行方法を記述します。
19 稼働ホストを記述した状態へ収束させるプレイブック
状況. Engineer ApSは自社インフラをコードとして管理している。リポジトリは稼働中の公開サービスと、バックアップ・メール自動化を含むその他の構成を扱うが、それらを運用開始することは別の段階である。この範囲をコードに残すことで、記憶に依存せず調べられるようになる。
課題. 頭の中でなくリポジトリに全環境を記述し、ホストを説明するだけでなく、実際のホストを収束させる形式にする必要があった。
行動. 記録された実装は、12,065行のYAMLにわたる19のプレイブックと34のロールからなる。これらの数値は記録時点の段階を示し、現在のリポジトリ規模ではない。大きさ以上に構造が重要だった。構成はフラグでなくデータとし、ホストのtier group変数が実行ロールを宣言するため、引数なしの構築でも全ホストを宣言状態へ収束させる。冪等性を願望でなく契約とし、収束済みなら変更0件、そう言えないプレイは未完了とした。4つのコマンド名前空間で、ホストへ触れない品質ゲート、読むだけのレポート、宣言に合わせて変更する構築、意図して変更し判定する検証の責務を分けた。
結果. リポジトリには宣言した環境の再構築に使う設定があり、誰かが覚えていたから成立していた部分が、失敗する検証へ変わった。サーバーのファイルを直接編集するより毎変更は遅く、途中まで適用される実行は最初から拒否するより悪いという、実際の費用もあった。そのため後に事前検査を置いた。意図的な交換条件として選び、維持した。

写真: RitaE / Pixabay 
写真: Ri_Ya / Pixabay
次に読む: Ansibleチェックモードを実態に即した検証に. すべての実績はこちら: 実績紹介.
お客様には「リポジトリで定義するインフラ」という事例として紹介しています — 他の事例とあわせて見る.

