# リポジトリで定義するインフラ

12,065行のYAMLにわたる19本のAnsible プレイブックと34個のロールで自社インフラを構築し、すべてのプレイを冪等にして、稼働中のホストを宣言した状態へ収束させた。

8月 2026

状況. Engineer ApSは自社インフラをコードとして管理している。リポジトリは稼働中の公開サービスと、バックアップ・メール自動化を含むその他の構成を扱うが、それらを運用開始することは別の段階である。この範囲をコードに残すことで、記憶に依存せず調べられるようになる。

課題. 頭の中でなくリポジトリに全環境を記述し、ホストを説明するだけでなく、実際のホストを収束させる形式にする必要があった。

行動. 記録された実装は、12,065行のYAMLにわたる19のプレイブックと34のロールからなる。これらの数値は記録時点の段階を示し、現在のリポジトリ規模ではない。大きさ以上に構造が重要だった。構成はフラグでなくデータとし、ホストのtier group変数が実行ロールを宣言するため、引数なしの構築でも全ホストを宣言状態へ収束させる。冪等性を願望でなく契約とし、収束済みなら変更0件、そう言えないプレイは未完了とした。4つのコマンド名前空間で、ホストへ触れない品質ゲート、読むだけのレポート、宣言に合わせて変更する構築、意図して変更し判定する検証の責務を分けた。

結果. リポジトリには宣言した環境の再構築に使う設定があり、誰かが覚えていたから成立していた部分が、失敗する検証へ変わった。サーバーのファイルを直接編集するより毎変更は遅く、途中まで適用される実行は最初から拒否するより悪いという、実際の費用もあった。そのため後に事前検査を置いた。意図的な交換条件として選び、維持した。

役割: インフラ自動化エンジニア
=> /ja/categories/platform-architecture/ カテゴリー: プラットフォーム設計
=> /ja/categories/devops/ カテゴリー: DevOps
=> /ja/categories/infrastructure/ カテゴリー: インフラ
=> /ja/categories/automation/ カテゴリー: 自動化・CI/CD
=> /ja/categories/reliability/ カテゴリー: 信頼性・バックアップ
=> /ja/categories/linux/ カテゴリー: Linux・サーバー
=> /ja/categories/system-administration/ カテゴリー: システム管理
=> /ja/categories/documentation/ カテゴリー: 文書作成
=> /ja/services/cloud-infrastructure/ サービス: クラウドインフラ・移行
=> /ja/services/infrastructure-as-code/ サービス: コードによるインフラ管理
=> /ja/services/devops-cicd/ サービス: DevOps・CI/CD自動化
=> /ja/services/system-administration/ サービス: システム管理

=> https://engineer.company/ja/portfolio/servers-you-can-rebuild-from-scratch/ このページのウェブ版
