はじめに
チームはレポートストアの変更案をコミットしました。成功したプランは確認できる状態ですが、まだレビューも適用もされていません。デリバリーワークフローは、レビューされたその具体的な成果物を使用し、Terraform の現在の状態も尊重する必要があります。
未レビューの成果物を試し、その正確なコンテキストにレビューを結び付け、承認済みプランを適用して、2 つ目の保存済みプランが古くなる様子を観察します。その後、新しいプランを生成し、レビューして適用します。これは永続的な記録と、用意された実行エントリーポイントを使うローカルワークフローです。レビューによる実行可否の判定と状態の整合性を示すもので、管理者による改ざんへの耐性を保証するものではありません。
保存済みプラン成果物、モジュールテスト、Git リビジョンの選択、Terraform の状態ロック、独立した環境を理解していることを前提とします。この実験は、既存のレポートストアと準備済みのソース変更案を含む独立した環境で開始し、以前の VM を再利用しません。
認定試験との関連
| 認定資格 | 試験のタスク | 演習内容 |
|---|---|---|
| DevOps Engineer – Professional (DOP-C02) | Task 1.3 | 特定の保存済みプランをレビューして使用し、状態変更後に無効になった場合に対処する、成果物ライフサイクルの基礎演習です。 |

レビュー前に具体的な成果物を準備する
このステップでは、同じコミット済みの変更案から 2 つの保存済みプランを作成し、未レビューのプランが用意された適用エントリーポイントを通過できないことを確かめます。
準備済みのリポジトリに移動し、ツールを読み込みます。
cd /home/labex/project/report-release
source environment.sh
変更案、品質チェックのステージ、最近の履歴を読みます。
cat release.auto.tfvars.json pipeline.json
git log --oneline -2
準備済みの変更案は release-two と release two report を要求します。現在の preview と review のストアには、まだ release one report が入っています。状態ファイルは別々です。隣接する delivery-release-neighbor/keep.txt は、保持する必要がある無関係のデータです。用意されたモジュール、プロバイダー、ロック、テスト、実行プログラム、品質チェックのステージをそのまま保持してください。
リリースする完全なコミット ID を記録します。選択ファイルは未追跡のリクエスト情報です。後のコマンドは、移動する HEAD を追うのではなく、この内容を使用します。
git rev-parse HEAD > selected-revision.txt
最初の preview 成果物を生成します。コマンド置換は、選択したコミットを --revision に読み込みます。--environment preview は対象を明示的に選択します。
python3 delivery.py plan release-two --revision "$(cat selected-revision.txt)" --environment preview
fmt、validate、plan モードのテストが通過し、その後、更新 2 つで追加も削除もない Terraform 標準のプランになるはずです。Terraform 自体の plan の終了コード 2 は、変更の存在を意味します。delivery コマンドは、成果物を正常に生成したため 0 を返します。
同じソースと現在の状態に対し、2 つ目の成果物を生成します。別の名前は、他の承認済み実行が進む間、適用を遅らせるプランを表します。
python3 delivery.py plan delayed-two --revision "$(cat selected-revision.txt)" --environment preview
現時点では、両方のプランが同じリリースを提案します。それぞれに独自のバイナリプラン、読みやすい形式と JSON 形式の表示、記録されたコンテキストがあります。どちらも適用されていません。
レビューする前に、最初のプランを適用エントリーポイントで試します。このコマンドは意図的に終了コード 1 を返します。
python3 delivery.py apply release-two --revision "$(cat selected-revision.txt)" --environment preview
No matching review of this concrete artifact. と表示されるはずです。結果には native_exit: null と記録されます。Terraform の apply コマンドを実行する前に、受け入れ処理が停止したためです。これは Terraform 自体の失敗とは異なります。プランが存在しても、承認が与えられたことにはなりません。
現在の preview レポートを読みます。
aws s3 cp s3://delivery-release-preview/report.txt -
引き続き release one report と表示されなければなりません。両方のプランと拒否されたリクエストは、業務環境を変更していません。
具体的なプランをレビューして適用する
このステップでは、実際に提案された操作をレビューし、正確な成果物に対する承認を記録します。レビューは、個別の delivery コマンドの実行をまたいで保持されます。
最初のプランを確認します。
python3 delivery.py inspect release-two
保存済みプランが delivery-release-preview を対象とし、リリースタグとレポート内容を要求された値に更新し、追加も削除もないことを確認してください。リビジョンは selected-revision.txt と一致しなければなりません。ソース、ロック、バイナリプランのフィンガープリントが、具体的なレビュー対象を識別します。
同じ成果物、リビジョン、環境を使ってレビューを記録します。
python3 delivery.py review release-two --revision "$(cat selected-revision.txt)" --environment preview
review_recorded: true と表示されるはずです。これはローカルワークフローの判断を記録するもので、Terraform のリソース操作ではありません。別のソースリビジョンや環境、変更された成果物は、このレビューと一致しません。
遅延用の成果物を、別のレビュー対象として確認します。同じ要求リビジョン、preview 環境、意図した 2 つの更新を確認してください。
python3 delivery.py inspect delayed-two
この成果物独自のレビューを記録します。提案が一致していても、2 つの成果物の記録を相互に代用できるわけではありません。
python3 delivery.py review delayed-two --revision "$(cat selected-revision.txt)" --environment preview
最初の成果物だけを適用します。
python3 delivery.py apply release-two --revision "$(cat selected-revision.txt)" --environment preview
エントリーポイントは、選択したコンテキスト、正確な成果物のバイト列、一致する永続化済みレビューを再確認してから、保存済みバイナリプランに対して Terraform 自体を呼び出します。用意された書き込みロックは、このワークフローの書き込みを直列化し、バックエンドの状態ロックは Terraform が処理します。Terraform 自体の apply の終了コードは 0 で、リソースが 2 つ変更されるはずです。このコマンドは、別のプランを暗黙に生成せず、保存済みの変更案を使用します。
実際にデプロイされたレポートを読みます。
aws s3 cp s3://delivery-release-preview/report.txt -
今度は release two report と表示されるはずです。実際のバケットタグも確認します。
aws s3api get-bucket-tagging --bucket delivery-release-preview
Environment=preview と Release=release-two があるはずです。ストレージのデータとタグが、意図した環境が変わったことを示します。コマンドが成功しただけでは、その結果を確認したことにはなりません。
古いプランを拒否して新しいプランをレビューする
このステップでは、承認だけでは保存済みプランを最新にできない理由を観察します。両方のプランの生成後、最初の apply が preview の状態を進めました。遅延用プランは、ソースとレビューが一致していても、元の状態のスナップショットを保持しています。
レビュー済みの遅延用成果物の適用を試します。このコマンドは意図的に終了コード 1 を返します。
python3 delivery.py apply delayed-two --revision "$(cat selected-revision.txt)" --environment preview
Terraform の実際の診断 Saved plan is stale と、Terraform 自体の終了コード 1 が表示されるはずです。今回はワークフローが一致するレビュー済み成果物を受け入れましたが、Terraform 自体が古い状態のコンテキストを拒否しました。完了したリリースはそのまま保持する必要があります。この拒否を回避するために、状態を書き換えたり、状態ファイルを削除したりしてはいけません。
明示的に選択した同じソースと環境を保ったまま、現在の状態に対して新しい成果物を生成します。
python3 delivery.py plan release-current --revision "$(cat selected-revision.txt)" --environment preview
要求されたリリースはすでにデプロイ済みなので、Terraform 自体の plan が終了コード 0 を返す正常な成果物になるはずです。変更なしは有効な結果であり、実行エラーとは異なります。新しい成果物には、引き続き独自のレビューが必要です。
再生成された変更案とコンテキストを確認します。
python3 delivery.py inspect release-current
変更がなく、引き続き選択したリビジョンと preview 環境を示すことを確認してください。具体的なプランと生成記録は、古い遅延用成果物とは異なります。
この新しい成果物をレビューします。
python3 delivery.py review release-current --revision "$(cat selected-revision.txt)" --environment preview
同じエントリーポイントを通じて適用します。
python3 delivery.py apply release-current --revision "$(cat selected-revision.txt)" --environment preview
リソースの変更なしで、Terraform 自体の apply が終了コード 0 を返すはずです。レビューは成果物に結び付いており、後のどんなプランも適用してよいという一般的な許可ではありません。Terraform の stale-plan チェックは、記録された状態に関するもので、Terraform 外で何も変わっていないことを証明しません。次の実験では、別の観察ワークフローを紹介します。
現在の preview レポートが保持されていることを確認します。
aws s3 cp s3://delivery-release-preview/report.txt -
release two report と表示されるはずです。隣接する環境を確認します。
aws s3 cp s3://delivery-release-review/report.txt -
引き続き release one report と表示されなければなりません。最後に、無関係のデータを読みます。
aws s3 cp s3://delivery-release-neighbor/keep.txt -
preserve release neighbor と表示されるはずです。別のクラウドスタックを作成せずに、既存のストアを更新し、ローカル成果物を作成しました。評価のために、デプロイ済みリリース、既存の両方の状態ファイル、隣接リソースを保持してください。
まとめ
プラン作成、レビュー、適用を分け、未レビューのリクエストを拒否して、レビュー済みバイナリプランの使用後に、実際のレポートとタグの変更を確認しました。その後、状態が進んだことで、レビュー済みの 2 つ目のプランは Terraform 標準の stale-plan チェックに失敗しました。変更のない新しい成果物を生成、確認、レビューしてから正常に適用し、もう一方の環境と無関係のデータを保持しました。
このワークフローは、ローカルのレビューを正確な成果物のコンテキストに結び付け、状態の新鮮さの確認を Terraform 自体に委ねます。承認を、新しい成果物全般に対する権限に変えるものではありません。用意されたエントリーポイントが使う Terraform 操作については、公式の保存済みプラン適用のリファレンスを参照してください。



