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

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

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

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

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

カテゴリー:
1プラットフォーム設計	/ja/categories/platform-architecture/	engineer.company	70
1DevOps	/ja/categories/devops/	engineer.company	70
1インフラ	/ja/categories/infrastructure/	engineer.company	70
1自動化・CI/CD	/ja/categories/automation/	engineer.company	70
1信頼性・バックアップ	/ja/categories/reliability/	engineer.company	70
1Linux・サーバー	/ja/categories/linux/	engineer.company	70
1システム管理	/ja/categories/system-administration/	engineer.company	70
1文書作成	/ja/categories/documentation/	engineer.company	70

サービス:
1クラウドインフラ・移行	/ja/services/cloud-infrastructure/	engineer.company	70
1コードによるインフラ管理	/ja/services/infrastructure-as-code/	engineer.company	70
1DevOps・CI/CD自動化	/ja/services/devops-cicd/	engineer.company	70
1システム管理	/ja/services/system-administration/	engineer.company	70

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