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

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

8月 2026

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

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

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

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

---

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

<https://engineer.company/ja/portfolio/servers-you-can-rebuild-from-scratch/>
