インフラのコード化

どのようなものか

インフラのコード化、Infrastructure as
Codeは、システムを動かすマシン、ネットワーク、ファイアウォール規則、
ロードバランサー、DNSレコードを、テキストファイルへ記述し、版管理
し、ツールに実環境を構築させる方法です。ファイルが正本です。インフラ
の変更は、ファイルの変更として始まり、アプリケーションコードと同じレ
ビューを通り、ツールが適用して初めて、稼働中のシステムへ届きます。
infrastructure-as-codeとハイフン付きで書き、IaCとも略します。

NISTの特別刊行物（Special
Publication）800-204Cは、マイクロサービスで作るアプリケーションの
DevSecOps指針です。アプリケーションを配置する資源を、「繰り返し可能
で、一貫した方法で」用意し、設定するコードと説明します。同じ指針は、
アプリ自身のソースと同じツールで、これらの定義を版管理すると記しま
す。再現性こそが目的です。ファイルから作れる環境は、最初の環境の隣で
も、災害の後でも、火曜の午後の試験用アカウントでも、再び作れます。

定義は、大きく二つに分かれます。宣言的な定義は、特定の大きさのサー
バーを、特定のネットワークへ置き、ポートを一つ開く、といった最終結果
を示し、何を作り、変え、触らずに置くかはツールへ任せます。命令的な定
義は、これを作り、それを接続し、その後ポートを開く、という手順一覧で
す。SP
800-204Cは、IaCを宣言的なコードに分類します。必要なものを書き、ツー
ルが稼働するインスタンスへ変えるためです。HashiCorpもTerraform言語
を、到達する手順ではなく、意図する目標の記述と説明します。違いは二回
目に現れます。手順一覧は、一度どう行ったかを記録しますが、宣言は、何
が存在するべきかを記録します。一部がすでに存在するとき、ツールに必要
なのは後者です。

一つの言語に決まっていません。SP
800-204Cは、ツールによって、Python、JavaScript、TypeScriptなどの汎用
スクリプト言語か、HashiCorpのHCLなどの独自設定言語で書き、後者がJSON
などの標準形式と互換かどうかは、それぞれだと記します。Terraformの言
語は後者で、`.tf`で終わるファイルに書きます。Azureは、JSONか、より短
いBicep言語のResource
Managerテンプレートを受け付けます。Ansibleは、YAMLでプレイブックを書
き、相手へエージェントを入れず、既存のOSの認証情報を使い、SSHで接続
します。

同じ名前に含まれる二つの仕事を、分けると分かりやすくなります。プロビ
ジョニングは、仮想マシン、ディスク、ネットワーク、ファイアウォールを
作ります。構成管理は、すでにあるマシンの中で動く、パッケージ、アカウ
ント、サービスファイルを整えます。どちらへ寄るかはツールによって異な
り、境界は厳密ではありません。どちらも、定義をリポジトリーへ置き、実
システムをツールで一致させることが、IaCの条件です。

作ったものの記憶方法も、ツールで違います。Terraformは、定義した資源
と作成した実オブジェクトを対応付ける状態ファイルを持ち、文書は、その
状態情報を、環境についての正本と説明します。Bicepには、Azure自身が配
置したものを記録するため、状態ファイルがありません。記録の場所で、二
人が同時実行したときや、記録を失ったときの結果が変わります。

なぜ重要なのか

IaC以前は、各環境を手で用意し、手で修正していました。ステージングだ
けへの修正、試験用に開いたままのポート、三台のうち一台だけ新しいパッ
ケージなどです。SP
800-204Cは、実際の設定が意図した運用状態を実現しなくなることを、構成
のずれと呼びます。よくある入口も、コードを通らないウェブコンソールや
コマンドラインの変更と記します。ステージングで動くリリースが本番で失
敗するとき、よくある原因です。

IaCは、正本を稼働中のシステムの外へ移します。チームが定義を変え、シ
ステムがそれに従います。ログインしてファイアウォール規則を変えるので
はなく、定義ファイルを変え、ツールに実行させます。そこから、三つのこ
とが生まれます。

第一は、レビューと履歴です。ネットワークの変更は、何かが起きる前に、
別の人が読むプルリクエストの差分になります。数か月後、誰がなぜポート
を開いたかは、記憶ではなく、コミットログが答えます。取り消しは、変更
を戻すコミットと、ツールの再実行です。

第二は、再現性です。適切な定義は冪等で、一致する環境へ適用しても変わ
らず、ずれた環境へ適用すれば戻します。二つの方法があります。今あるも
のを調整するか、捨てて、定義から作り直すかです。後者を規則とするの
が、イミュータブルインフラです。

第三は、低コストの環境です。SP
800-204Cは、ツールが、資源の用意から撤去まで、インフラの寿命全体を自
動化し、短命すぎて、保守する価値のないものもあると説明します。必要に
応じて複数の試験環境を作り、再び取り壊せます。コード自体も、何かへ触
れる前に検査できます。指針は、マージ前に、すべての部分に脆弱性検査を
行うよう求めます。ブランチに本番構成の短命なコピーを与え、承認前に、
レビュアーへ変更のプレビューを見せられます。

導入に伴う負担も、明確に述べる必要があります。プルリクエスト経由の
ファイアウォール規則変更は、ウェブコンソールより遅く、障害中には、そ
の時間が大きな負担に感じられます。ツールごとの言語と、状態のモデルを
学ぶ必要もあります。また、環境を作れるファイルは、消すこともできま
す。どちら向きにも同じだけ作用するため、プレビューは、その後の実行と
同じほど重要です。

実際の活用例

CIジョブがツールを実行し、プルリクエストへドライランの結果を投稿する
構成を例に、一つの編集が、稼働中のシステムへ届く流れを示します。

```text
1日目 09:10 ネットワーク定義を編集: 事務所からTCP 443を許可
      09:12 プルリクエスト作成。CIが試行実行（計画）
      09:14 計画をプルリクエストへ投稿: 規則一つ追加、削除なし
      10:30 レビュアーが計画と差分の両方を読み、承認
      10:31 マージ。CIがレビュー済みの計画を適用
      10:33 同じ定義の二回目の実行が、変更なしを報告
40日目      443の開放理由を問われ、コミットログで実行者と理由を確認
```

計画が、その役割を果たします。差分は、著者が変えるつもりだったものを
示し、計画は、削除しようとする資源など、著者の予想外も含め、ツールが
これから行うことを示します。Terraformは、`-out`で計画をファイルへ保
存でき、`terraform
apply`へ渡すと、その中の操作を実行します。そのため、10:31に実行する
のは、10:30に承認したものです。10:33の変更なしという二回目の結果は、
定義とシステムの一致を確認します。

このサイトのIaCサービスのページでは、誰かの記憶に頼るのではなく、
バージョン管理された設定を基に、再現可能な形でサーバーを構築する方法
を説明しています。

安全に到達するには、主に順序が重要です。2026年9月の事例が、その理由
を示します。別の事業者に二台目を追加します。一台目は、手で作り、後で
保護したため、しばらくの間、新規ホストが初期パスワードポリシーのま
ま、インターネットへ開いていました。今回は、リポジトリーから作り、マ
シンができる前に保護を用意しました。サーバーのプレイより先にファイア
ウォールのプレイを動かし、二つ目の事業者では、クラウドファイアウォー
ルより先にタグを割り当てます。タグ向けの規則は、タグがなければ対象を
持たないためです。作成ロールが既存マシンを引き継ぐため、再実行しても
害はありません。費用が発生する唯一のロールなので、専用の文書へ、リー
ジョン、種類と仕様、ユーロ建ての月額を記録します。事例は、試行で見え
ないものも明示します。両ファイアウォールは、汎用HTTPタスクから事業者
のREST
APIを呼んで設定し、そのタスクはチェックモードに対応しないため、試行
では省きます。本当の予行演習は、費用がかからず、取り消せる、ファイア
ウォールのプレイ単体の実行です。

問題が起きるところ

インフラコードは、成功に見える形で失敗しがちです。ツールが正常終了
し、CIも成功し、ファイルと実環境が、黙って食い違います。

対応中の手修正が、次回の実行で戻されます。
午前二時にコンソールでポートを開き、障害が終わり、一週間後の定期実行
で、定義ファイルに変更を反映していないため、再び閉じます。反対に、再
び実行しないことで、ファイルが実態を表さなくなることもあります。緊急
変更は同日中にコードへ入れ、ファイルと稼働中のものを比較する定期検査
を行います。SP
800-204Cは、各デプロイの直後と運用中の一定間隔で、その比較を求めま
す。Terraformでは、planコマンドの詳しい終了コードで、毎晩実行する短
いジョブにできます。

```sh
terraform plan -detailed-exitcode
i# 終了コード0: 変更なし、1: エラー、2: 変更あり		engineer.company	70
```

すでに適用したブランチで、終了コード2なら、実環境がコードからずれた
ことを意味し、誰かが理由を調べるべきです。

ファイルから資源を消しても、削除されるとは限りません。 定義から資源
がなくなった場合の扱いは、ツールで異なります。Azure
Resource
Managerテンプレートについて、Microsoftのwhat-if文書は、存在するのに
テンプレートにない資源を、完全モードの場合だけ削除すると記します。そ
れ以外では、動き、課金され続けます。削除規則を調べてから頼り、恐れる
削除だけでなく、期待する削除もプレビューで読みます。

試行では、すべては見えません。
プレビューは、変更のモデルであり、保証ではありません。Microsoftの
what-if文書は、配置時にAzureが既定値を入れるだけでも、削除と報告する
プロパティーを挙げ、その結果をノイズと呼びます。`reference`関数で設
定したプロパティーは、毎回変更と出ます。前の事例は、もう一つの隙間を
示します。チェックモード非対応のタスクは、試行で省かれ、何も分かりま
せん。既知のノイズを理解し、見えないものは、低コストで取り消せる対象
での予行演習まで、未検証と扱います。

秘密情報が、リポジトリーや状態へ入ります。
定義ファイルのパスワードは、全クローンの履歴へ残ります。見落としやす
い点として、Terraformの文書は、状態に秘密情報が含まれる場合があり、
既定の保存先は`terraform.tfstate`というローカルファイルだと警告しま
す。秘密情報は専用の保管庫へ置いて名前で参照し、状態は、HashiCorpの
勧めどおり、ロックとアクセス制御を備えた遠隔ストレージへ置きます。状
態ファイルを手で編集してはなりません。必要な変更には、`terraform
state`があります。

スクリプトを、定義に見せかけます。
たとえば、サーバーを作るだけのシェルスクリプトをリポジトリーへ置け
ば、版管理はされていますが、冪等にはなりません。二回動かせば、二台に
なるか、途中でエラーになります。宣言的な資源か、前述の、既存マシンを
引き継ぐロールのように、動く前に確認する手順を使います。Ansibleの文
書は、基準を明確にします。システムが、すでにプレイブックの記述する状
態なら、再実行しても何も変わりません。

参考資料

  * サービスメッシュを使うマイクロサービスアプリケーションでの
DevSecOpsの実装（NIST SP 800-204C） —
宣言的で版管理するコードとしてのインフラ、構成のずれ、検査です。

  * Terraform言語の文書 — 宣言的な言語、資源、ブロックです。

  * planコマンド — 試行、保存した計画、詳しい終了コードです。

  * 状態 — Terraformが記録するもの、保存場所、機密性が高い理由です。

  * Ansibleの紹介 — SSHで行うエージェント不要の自動化、プレイブッ
ク、望む状態です。

  * テンプレート配置のwhat-if — Azureの配置プレビュー、変更の種類、
既知のノイズです。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/infrastructure-as-code/	engineer.company	70
