テーマ別の解説テーマ:Terraform:変更の流れと機密情報
Terraformのplan・apply・stateの違い:変更の流れを図解
planは変更の計画、applyは計画に基づく適用、stateは構成と管理対象を結び付ける記録です。 「443に変える予定」と「実際に443で使える」は別の状態です。同じ設定変更を追いながら、ファイル・記録・現在の資源・適用結果を読み分けましょう。
構成・state・現在の資源を区別し、planを読んだ後に何を確認してから適用・検証するか説明する。
構成をコードで表す考え方を知っていると読みやすくなります。CDKの学習やAWSアカウントは不要です。このページでは固定例を読むだけで、Terraformは実行しません。
まず、書いた内容・記録・現在の資源を分ける
| 名前 | 役割 | この例 |
|---|---|---|
| 構成(configuration) | 管理したい資源や値を記述する。 | 許可するポートを443にしたい。 |
| 状態の記録(state) | 構成内の資源と実物の対応、取得した属性などを記録する。 | どのルールを管理しているかと、以前取得した値。 |
| 現在の資源 | 対象のAPIなどを通して確認する実物。 | 今のルールが許可しているポート。 |
stateは「実物を常に見ている画面」ではありません。前の記録後に、別の担当者が資源を変更することもあります。通常のplanでは対象を読み取り、構成と比較して変更を提案します。古い記録と、今読み取った値を同一視しないことが大切です。
planを読み、判断してapply、その後に動作を確かめる
- 構成を変更 → planで確認計画を作る
- planで確認 → applyで適用影響を確認
- applyで適用 → 結果と動作を確認結果を読む
- 構成を変更
- 望む値と管理対象
- planで確認
- 追加・変更・削除の提案
- applyで適用
- 対象と承認した内容
- 結果と動作を確認
- 資源・通信・アプリ
図は作業の順番です。planが表示された時点では、提案した変更をapplyしたことにはなりません。applyが完了した後も、利用する通信やアプリの検証は別に行います。stateがあることだけで、その機能の正常性まで証明できるわけではありません。
固定例:記録は80、現在は8080、構成では443にしたい
| 見ているもの | 固定値 | ここから言えること |
|---|---|---|
| 以前のstateの記録 | 80 | 前回の記録。この後も80のままとは限らない。 |
| 今回の対象読取り | 8080 | 以前の記録後に差が生じている。理由は別途確認が必要。 |
| 構成ファイル | 443 | 管理側が望む値。既に反映された値とは限らない。 |
| 今回の変更提案 | 8080 → 443 | 現在の値から構成へ近づける提案。通信成功の証明ではない。 |
8080への変更が、障害対応で必要だった可能性もあります。差を見つけたら、変更理由と管理者を確かめてから、構成を直すのか実物を変更するのかを判断します。コードに書いてあるから必ず今すぐ戻す、とは決めません。
画面で見たplanと、保存したplanを区別する
| 操作の形 | 意味 | 注意すること |
|---|---|---|
| planだけを見る | 変更の見込みを確認する。 | 時間が経てば対象や構成の条件が変わり得る。 |
| 保存planを渡さずapply | その場で新しい計画を作り、通常は確認後に適用する。 | 以前見たプレビューと、今回の計画が同じとは限らない。 |
| 保存planを指定してapply | 保存された計画の操作を実行する。 | 対話の承認プロンプトは出ない。渡す前のレビューと対象確認が必要。 |
保存planを使うときは、確認したファイルと適用に渡すファイルを対応させます。ただし、保存すれば必ず適用できるわけでも、外部変更をすべて防げるわけでもありません。対象、入力、構成の版、stateの条件や実行権限を合わせて確認します。
applyの失敗後は「何も変わらなかった」と決めつけない
| 段階 | 固定例の結果 | 次に確かめること |
|---|---|---|
| 変更A | 完了した。 | その資源の実際の状態と記録。 |
| 変更B | 権限不足で失敗した。 | エラーの原因、まだ変更されていない範囲。 |
| 全体の終了 | 失敗として終わった。 | Aまで自動で元に戻ったとは扱わない。 |
- エラーと完了した操作を読み、実物とstateの状況を確認する。
- 管理対象と変更理由を保ち、必要な権限や入力などの原因を直す。
- 新しい計画を読み直し、残る操作と復旧条件を判断する。
チームでは、同じ対象の記録を共有し、同時書込みを防ぐ条件も必要です。stateの排他制御はbackendが対応している場合の仕組みです。remote保存なら自動で何でも安全、とは考えず、暗号化・閲覧権限・lock対応を分けて確認します。
計画・適用・記録を、固定例で判断する
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 三つの役割を表で分ける。
- 80・8080・443の固定例を時点ごとに説明する。
- 保存planと部分失敗の設問で確認し、復習で適用前後の確認を説明する。
理解を確かめる: 「planは確認済み」と言われたら、applyの前後に何を確かめる?
対象と構成・入力・計画の対応、今回の適用方法と影響を確認する。適用後は完了/失敗した操作、stateと実物、使う機能を照合する。
以前のプレビュー、記録、実行結果、アプリの動作は、それぞれ異なる証拠だから。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件構成内の資源と対象の対応・記録した属性を確認。stateを実環境の常時監視やデータ復元点とは扱わない。
参照した本文まず、書いた内容・記録・現在の資源を分ける planを読み、判断してapply、その後に動作を確かめる 固定例:記録は80、現在は8080、構成では443にしたい applyの失敗後は「何も変わらなかった」と決めつけない 計画・適用・記録を、固定例で判断する
確認した内容・条件構成・state・現在の資源から計画を読む流れ。手元やAWSで実行した検証ではない。
確認した内容・条件通常planの対象読取・変更提案、保存する場合の境界。計画と適用済みの結果を区別。
参照した本文まず、書いた内容・記録・現在の資源を分ける planを読み、判断してapply、その後に動作を確かめる 固定例:記録は80、現在は8080、構成では443にしたい 画面で見たplanと、保存したplanを区別する 計画・適用・記録を、固定例で判断する
確認した内容・条件保存planなしは再計画。保存plan指定時は確認プロンプトなし。部分失敗は自動全体rollbackではない。
参照した本文planを読み、判断してapply、その後に動作を確かめる 画面で見たplanと、保存したplanを区別する applyの失敗後は「何も変わらなかった」と決めつけない 計画・適用・記録を、固定例で判断する
確認した内容・条件sensitiveは表示の秘匿。保存planとstateの保存内容、ephemeralとwrite-onlyの条件は別に確認。
参照した本文画面で見たplanと、保存したplanを区別する applyの失敗後は「何も変わらなかった」と決めつけない 計画・適用・記録を、固定例で判断する
確認した内容・条件backend対応時の排他制御。remoteであるだけでlock対応とはしない。force-unlockを通常手順にしない。