コードとしてのインフラとGitOps
コードとしてのインフラは、サーバー、ネットワーク、クラウドリソースを、ツールが適用する、レビューされたテキストファイルで定義します。GitOpsは、リポジトリが稼働中のシステムを変更する唯一の方法であり、コントローラーが現実をそれに合わせ続けるというルールを加え、バージョン管理を、変更の記録であり、復旧の手段にします。
なぜ重要か
長い間、インフラは手作業で構築されてきました。エンジニアがサーバーにログインし、パッケージをインストールし、構成を編集して、次に進みます。サーバーは独自の存在になり、その履歴はエンジニアの記憶と数枚のメモの中にありました。故障したときは、記憶から再構築されました。二台目が必要になったときは、誰も列挙できない小さな点で異なるコピーでした。トラブルシューティングとは、二つの「同一の」システムがなぜ異なる振る舞いをするようになったかを突き止めることを意味しました。
コードとしてのインフラ(IaC)は、これをテキストに置き換えます。インフラの望ましい状態がファイルに書かれ、バージョン管理に保たれ、ソフトウェアのようにレビューされ、ツールによって適用されます。環境の再構築はコマンドひとつになります。二つ目のコピーは、異なる値を持つ同じファイルです。変更は、レビュアー、テスト、記録を伴うプルリクエストです。Wikipediaは、コードとしてのインフラを、対話的な構成ではなく、機械可読な定義ファイルによるインフラの管理とプロビジョニングと説明しています。
GitOpsは、この考え方をさらに一歩進めます。リポジトリが望ましい状態の信頼できる唯一の情報源と宣言され、ソフトウェアがそれと稼働中のシステムの両方を見守り、システムをそれに合わせます。誰も本番を手作業で変えず、リポジトリを変更します。これはサービスマネジメントに多くをもたらします。あらゆる変更の監査証跡、素早い復旧、環境間の一貫性、変更承認の自然な置き場。同時に、リポジトリ内の秘密や、あらゆる場所に一度に適用される間違いのような新しいリスクも持ち込みます。このトピックは、考え方と、それを慎重に採用する方法を説明します。構成管理(トピック 4.4 — 構成管理)、継続的デリバリー(トピック 2.2 — 継続的デリバリー)、変更実現(トピック 3.4 — 変更実現)を土台とし、パイプライン(トピック 6.4 — パイプラインと自動化された変更)につながります。
中核となる概念
コードとしてのインフラ(IaC)。 ツールが読み、適用する、コードや構成ファイルでインフラを定義することです。サーバー、ネットワーク、ストレージ、データベース、アクセスルール、プラットフォームの設定を対象とします。Wikipediaがそのアプローチと歴史を説明しています。ファイルは、仕組みであると同時に、ドキュメントでもあります。
宣言的と命令的。 宣言的な定義は、最終状態がどうあるべきか(「このロードバランサーの背後にこの種類のサーバーが三台ある」)を述べ、ツールがどう到達するかを導きます。命令的な定義は、取るべきステップを述べます。Wikipediaが宣言型プログラミングと命令型プログラミングを説明しています。宣言的なツールは、推論しやすく、安全に繰り返しやすい傾向があり、命令的なスクリプトは、変わったタスクにより多くの制御を提供します。多くのチームが両方を使います。
ツール。 例には、クラウドリソースをプロビジョニングするTerraform、システムを構成するAnsible、宣言されたマニフェストに従ってコンテナを動かすKubernetesがあります。Wikipediaがそれぞれを説明しています。ツールの状況は急速に変わります。適合性、サポート、手元のスキルで選び、定義を現実的な範囲でポータブルに保ちます。
望ましい状態、実際の状態、ドリフト。 望ましい状態はコードが言うもの、実際の状態は稼働しているものです。ドリフトはその差で、通常は手作業の変更や失敗から生じます。ドリフトを検知して直すことは、IaCの中核の便益です。トピック 4.4 — 構成管理を参照してください。
冪等性。 同じ定義を繰り返し適用しても、同じ結果になります。Wikipediaが冪等性を説明しています。ドリフトを直すために適用を再実行しても安全になるのは、これによります。
ステートファイル。 一部のツールは、管理するリソースの記録を保ち、定義と比較します。慎重に扱ってください。機微なデータを含みうるし、手で編集してはならず、二人が同時に適用しないようロックが必要です。
イミュータブルインフラ。 稼働中のサーバーを変更する代わりに、既知のイメージから新しいものを構築して古いものと置き換えます。これによりドリフトを避け、ロールバックを単純にします。切り戻せばよいのです。Wikipediaが説明する仮想マシンとコンテナ、および丁寧に作られたイメージとの組み合わせで最もよく機能します。
バージョン管理とレビュー。 定義は、Wikipediaが分散バージョン管理システムと説明するGitのようなバージョン管理に置かれます。変更は、プルリクエストとコードレビューとして説明されるブランチとレビューを通ります。履歴は、誰が、いつ、何を、なぜ変更したかを示し、監査と学習を支えます。トピック 3.4 — 変更実現を参照してください。
GitOps。 Gitのリポジトリが望ましい状態を保持し、自動化されたエージェントが稼働中のシステムをそれに合わせ続ける運用のアプローチです。変更はリポジトリの変更によってのみ行われ、エージェントがそれを取得して適用し、手作業の変更を元に戻します。WikipediaはDevOpsの項でGitOpsに触れています。プル型の設計は、本番システムが自分の構成を取得することを意味するため、本番の認証情報がビルドシステムに置かれる必要がありません。アプローチの詳細は、プロジェクト自身のドキュメントを確認してください。
リコンシリエーションループ。 望ましい状態と実際の状態を繰り返し比較し、ギャップを埋めるために行動するコントローラーです。この考え方は、Wikipediaが説明する制御理論に由来し、KubernetesとGitOpsのツールの仕組みの基礎にあります。ループは回復力がありますが、悪い変更も素早く繰り返しえます。
環境と昇格。 同じ定義に異なる値を与えて、開発、テスト、本番の環境を作ります。変更はそれらを通じて昇格されます。環境を一貫して保てば、テストはより意味のあるものになります。トピック 3.5 — リリースとデプロイメント管理を参照してください。
コードとしてのポリシー。 「公開ストレージは禁止」「すべてのリソースにタグが必須」のような、何が許されるかのルールを、コードとして書き、変更が適用される前に自動的にチェックします。これにより、統制が変更の行われる場所に置かれ、証拠が生まれます。トピック 6.4 — パイプラインと自動化された変更を参照してください。
秘密。 パスワード、鍵、トークンは、リポジトリに平文で保管してはいけません。秘密管理ツールか暗号化を使い、自動化には最小限の短期間のアクセスを与えます。トピック 3.13 — 情報セキュリティ管理を参照してください。
モジュールと再利用。 標準的なネットワークやデータベースのような一般的なパターンのための、共有されテストされたモジュールは、仕事を速め、標準を強制します。オーナー、バージョン、リリースノートが必要です。
影響範囲。 共有の定義での間違いは、多くのシステムに一度に影響しえます。ステートをより小さな単位に分け、段階的なロールアウトを使い、共有モジュールにはレビューを求めることで、これを制限します。
インフラのコードのテスト。 方法には、構文とポリシーのチェック、適用前の変更の計画やプレビュー、使い捨ての環境でのテスト、適用後のチェックがあります。Wikipediaがテスト自動化の項で関連する考え方を説明しています。トピック 2.2 — 継続的デリバリーを参照してください。
レンズはどう当てはまるか。 IaCとGitOpsは、アジャイルな運用の工学的な土台です。小さく、レビューされ、元に戻せる変更。AIは、レビューのもとで、定義の下書きと計画の説明ができます。自動化がそれらを適用します。アナリティクスは、履歴から変更の頻度と失敗を読み取ります。
ベストプラクティス
- すべての変更をコードに置く。 重要なシステムへの変更の経路をリポジトリにし、定義された緊急時を除いて手作業の変更を禁じます。緊急の変更は記録し、コードに戻します。
- レビューと小さな変更を使う。 すべての変更に第二の人によるレビューを求め、理解できる程度に小さく保ちます。何が変わるかのプレビューを示します。
- 宣言的な定義と冪等なステップを好む。 繰り返しやすく、ドリフトを確認しやすくなります。命令的なスクリプトは、それが必要なタスクに、注意して使います。
- ドリフトを検知して直す。 実際の状態を望ましい状態と、スケジュールまたは継続的に比べます。ドリフトの種類ごとに、自動で元に戻すか、アラートを出すかを決めます。
- 秘密をコードの外に置く。 秘密管理ツールを使い、必要なところで暗号化し、自動化に短期の認証情報を与え、リポジトリをスキャンして漏れた秘密を探します。
- ステートとリポジトリを守る。 本番の定義とステートを変更できる人を制限し、ブランチ保護を強制し、リポジトリとステートをバックアップします。
- 適用前にテストする。 ポリシーのチェック、プレビュー、使い捨ての環境でのテストを実行します。予期しない削除がないか、計画をレビューします。
- 影響範囲を制限する。 定義を、独立して失敗できる単位に分け、段階的にロールアウトし、重要なリソースを誤った削除から守ります。
- オーナーのいる、テスト済みのモジュールを再利用する。 標準的なパターンのために、ドキュメントとリリースノートを備えたバージョン付きのモジュールを公開し、古いバージョンを廃止します。
- 復旧を計画する。 データの復元を含め、コードから環境を再構築することをリハーサルし、時間を測ります。リポジトリとツールを継続性の計画に含めます。トピック 3.12 — サービス継続性管理を参照してください。
チームで話し合うための問い
今日、コードから再構築できるシステムはどれで、記憶からしか再構築できないものはどれか。 一覧にします。ひとりに依存するものが多いと予想できます。さらに掘り下げるために、システムをひとつ選び、コードで定義します。
最後に誰かが本番を手作業で変更したのはいつで、どうやって知ったか。 話を求めてください。誰も追跡していないと予想できます。さらに掘り下げるために、ひとつの環境にドリフトの検知を加え、差異があったときに何が起きるかを合意します。
秘密が、リポジトリやステートファイルの中に置かれている可能性があるのはどこか。 一緒に探してください。驚きが予想されます。さらに掘り下げるために、リポジトリをスキャンし、見つかったものを秘密管理ツールに移します。
一回の適用が行える最大の変更は何で、それをどう制限するか。 共有モジュールとモノリシックなステートを考えます。居心地の悪い答えが予想されます。さらに掘り下げるために、大きなステートをひとつ、より小さなものに分割します。
インフラの変更をどうレビューしていて、レビュアーは実際に何を見ているか。 最近のレビューを求めてください。素早い承認が予想されます。さらに掘り下げるために、計画の出力やセキュリティへの影響など、レビュアーが確認しなければならないことを合意します。
インフラのコードを書いたりレビューしたりするのにAIはどこで役立ち、どう確認するか。 AIは定義を下書きし、計画を説明できます。安全でない既定値や誤ったリソース設定を生むこともあります。誰がレビューし、どんなチェックが走るかを尋ねてください。さらに掘り下げるために、AIが下書きしたコードを、他のものと同じポリシーのチェックに通します。
実践:サービスマネジメントの例
ある国立図書館のデジタルチームは、パブリッククラウド上で目録検索サービスを運用しています。環境は数年かけて手作業で構築されました。テスト環境は、誰も列挙できない点で本番と異なり、最近の障害は、以前のインシデントの際に手作業で行われ、記録されなかったセキュリティグループの変更に行き着きました。
プラットフォームリードは、パイロットとして、ひとつの環境をコードで定義することを選びます。宣言的なツールを使って、チームはテスト環境のネットワーク、コンピュート、データベース、アクセスルールを記述し、既存のリソースをインポートし、ブランチ保護と必須のレビューを伴うリポジトリにコードを置きます。パイプラインが、公開ストレージの禁止や必須のタグなどのポリシーのチェックを実行し、各プルリクエストに計画を示します。秘密は、クラウドプロバイダーの秘密管理ツールに移ります。
次に、ドリフトの検知を加えます。夜間のジョブが、コードとクラウドの実際の状態を比較し、差異をチームのチャンネルに投稿します。最初の週に、11件の手作業の変更が見つかります。八件は無害、二件は古いテストリソース、一件はデータベースのポートに開いたファイアウォールのルールです。ルールを直し、リソースを削除します。
三か月後、本番もコードになり、コンテナプラットフォームのGitOps型のコントローラーが、承認された変更をリポジトリから適用します。テスト環境をゼロから再構築するのに40分かかります。チームは、データの復元を含め、別のアカウントで本番を再構築することを半日でリハーサルします。
何が変わったか。変更の履歴はリポジトリにあり、レビューは本物になり、二つの環境は一致しています。何がまだ難しいか。古いデータベースサーバーはツールでの対応が十分でなく、一部が手作業のままです。ステートファイルには、以前のインポートからの平文のパスワードが一度含まれており、チームはそれを更新しなければなりませんでした。あるエンジニアが、異なるバージョンのツールを持つノートPCから変更を適用し、予期しない差異が生じました。リードは、パイプラインでのツールのバージョンの固定、適用はパイプラインからのみというルール、ステートの秘密のスキャンを加えました。
四つの視点
プロダクトとデリバリーのチーム
サービスのインフラを、アプリケーションの隣のコードで定義し、レビューし、使い捨ての環境でテストしましょう。手作業の変更は避けます。タグ、オーナーシップ、セキュリティ設定を定義に含めてください。
サービスと運用のチーム
リポジトリを変更の記録として使い、ドリフトを検知しましょう。計画を慎重にレビューし、ステートと秘密を守り、再構築をリハーサルします。緊急の変更はまれにし、コードに戻してください。
リーダーシップとガバナンス
会議ではなく、リポジトリとパイプラインからの証拠を求めましょう。ツール、研修、リハーサルに資金を出します。本番への手作業の変更は、記録されなければならない例外であることを明確にしてください。
顧客とユーザー
同じように振る舞う環境と、より速い復旧から恩恵を受けます。変更の後の驚きが減り、重要な変更の明確な事前通知を受けられるはずです。
アジャイル、AI、自動化、アナリティクス
アジャイル
素早いフィードバックを伴う、小さく、レビューされ、元に戻せるインフラの変更は、継続的デリバリーの運用の形です。最も痛みのある環境から始めて、定義を段階的に築きます。注意:すべてのシステムを一度にコードに移す大規模な移行はリスクがあります。一度にひとつずつ移してください。
AI
AIは、人があらゆる変更をレビューする形で、定義の下書き、計画の説明、ポリシールールの提案ができます。それぞれの使用にオーナーを指名してください。注意:生成されたインフラのコードは、既定で安全でなかったり、リソースを削除したりしえます。同じポリシーのチェックを適用し、計画を読んでください。トピック 5.4 — インシデント、ナレッジ、変更のための生成AIを参照してください。
自動化
IaCとGitOpsは、インフラ自体の自動化です。すべてを変更できるため、コントローラーとパイプラインは、最小権限、記録、保護された状態に保ちます。注意:自動のリコンシリエーションは、間違いをあらゆる場所に再適用しえます。ロールアウトを段階化し、一時停止する手段を保ってください。トピック 6.4 — パイプラインと自動化された変更を参照してください。
アナリティクス
変更の頻度、失敗率、再構築にかかる時間、ドリフトの件数、手作業の変更を検知するまでの時間、ポリシー違反を見ます。注意:コミットの数を数えると活動に報い、少ないドリフトの件数は、検出器が弱いことを反映しているかもしれません。既知の変更で検知をテストしてください。『サービスマネジメント指標』とトピック 7.3 — 測定とレポートを参照してください。
よくある失敗パターン
- ハイブリッドの現実。 一部の変更はコードに、一部は手作業で行われます。ドリフトが増えます。コードを唯一の経路にして、ドリフトを検知しましょう。
- リポジトリ内の秘密。 認証情報が漏れます。秘密管理ツールを使い、スキャンしましょう。
- 巨大な共有ステート。 ひとつの変更がすべてに影響します。より小さな単位に分割しましょう。
- レビューされていない変更。 間違いが本番に届きます。レビューを求め、計画を示しましょう。
- 固定されていないツールとモジュール。 振る舞いが予期せず変わります。バージョンを固定しましょう。
- 一度も再構築されない。 必要なときに復旧が失敗します。再構築をリハーサルしましょう。
- スーパーユーザーとしてのパイプライン。 侵害されたパイプラインが本番を所有します。権限を制限し、保護しましょう。
成熟度モデル
| 観点 | 開始 | 発展 | 標準化 | 管理 | オーケストレーション |
|---|---|---|---|---|---|
| カバレッジ | 手作業 | 一部のリソースがコードになっている | 最も重要なシステムがコードで定義されている | カバレッジと例外が追跡される | 全体がコードとして定義され、統治される |
| 統制 | レビューなし | ピアレビュー | すべての変更にレビュー、計画のプレビュー、ポリシーのチェックがある | ドリフトが検知され、対応される | 環境をまたいで、人の監督を伴うリコンシリエーションがある |
| セキュリティ | コード内の秘密 | 認識されている | 秘密が管理されスキャンされ、自動化は最小権限 | 指摘が完了まで追跡される | セキュリティとポリシーが共有モジュールに組み込まれる |
| 復旧 | 記憶による再構築 | 文書化されている | 再構築がリハーサルされ、時間が測られる | 復旧時間が測定され、改善される | 復旧が環境とリージョンをまたいで自動化される |
チェックリスト
- 重要なシステムが、バージョン管理のコードで定義されている。
- すべての変更がレビューされ、計画のプレビューを示す。
- 記録された緊急時を除き、本番への手作業の変更は禁止されている。
- ドリフトがスケジュールで検知され、ルールで扱われる。
- 秘密が管理ツールにあり、リポジトリとステートがスキャンされる。
- ツールとモジュールが固定され、オーナーがいる。
- 影響範囲を制限するよう、定義が分割されている。
- 環境の再構築をリハーサルし、時間を記録している。
AIプロンプト
計画の出力をレビューする。
Here is the plan output from an infrastructure change: [paste].
List resources to be created, changed, and destroyed, highlight any deletion or replacement of a data store or network component, and list questions a reviewer should ask. Do not approve or reject.
List what you are unsure of.
要件からポリシールールを下書きする。
Our requirements: [list, such as no public storage, tags required, encryption at rest]. Our tool: [name, or "undecided"].
Write each requirement as a plain-language rule with one example of a violation, and describe how to test the rule. Do not write code unless I name the tool.
List what you are unsure of.
ドリフトの発見事項を要約する。
Here is a drift report listing differences between code and the running environment: [paste].
Group the differences by type (extra resource, changed setting, missing resource), flag any that touch access, network, or encryption, and write one question per group for the team. Do not recommend fixes.
List what you are unsure of.
AIスキル
- configuration-management: コードの定義を、それが支えるサービスに結び付けるときに使います。
- change-request: レビューのために、インフラの変更を明確に記述するときに使います。
- security-testing: インフラのコードと秘密のチェックを計画するときに使います。
- disaster-recovery-testing: コードからの再構築をリハーサルするときに使います。
- runbook: 残る緊急時の手作業の手順を文書化するときに使います。
主要な情報源
- Kief Morris, Infrastructure as Code (2nd edition, 2020): インフラを定義し管理するための実践的な手引き。
- Jez Humble and David Farley, Continuous Delivery (2010): 再現可能な環境とパイプラインの基礎。
- The documentation of the tools you use, such as Terraform, Ansible, and Kubernetes: その振る舞いについての権威ある情報源。
- Wikipedia, "Infrastructure as code": アプローチの概観。
参考文献
- Infrastructure as code — Wikipedia — https://en.wikipedia.org/wiki/Infrastructure_as_code
- DevOps — Wikipedia — https://en.wikipedia.org/wiki/DevOps
- Declarative programming — Wikipedia — https://en.wikipedia.org/wiki/Declarative_programming
- Imperative programming — Wikipedia — https://en.wikipedia.org/wiki/Imperative_programming
- Idempotence — Wikipedia — https://en.wikipedia.org/wiki/Idempotence
- Git — Wikipedia — https://en.wikipedia.org/wiki/Git
- Version control — Wikipedia — https://en.wikipedia.org/wiki/Version_control
- Code review — Wikipedia — https://en.wikipedia.org/wiki/Code_review
- Containerization (computing) — Wikipedia — https://en.wikipedia.org/wiki/Containerization_(computing)
- Control theory — Wikipedia — https://en.wikipedia.org/wiki/Control_theory
- Kubernetes — Wikipedia — https://en.wikipedia.org/wiki/Kubernetes
- Terraform (software) — Wikipedia — https://en.wikipedia.org/wiki/Terraform_(software)