INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ:Terraform:変更の流れと機密情報

Terraformのplan・apply・stateの違い:変更の流れを図解

planは変更の計画、applyは計画に基づく適用、stateは構成と管理対象を結び付ける記録です。 「443に変える予定」と「実際に443で使える」は別の状態です。同じ設定変更を追いながら、ファイル・記録・現在の資源・適用結果を読み分けましょう。

この教材で学ぶこと

構成・state・現在の資源を区別し、planを読んだ後に何を確認してから適用・検証するか説明する。

先に知っておくこと

構成をコードで表す考え方を知っていると読みやすくなります。CDKの学習やAWSアカウントは不要です。このページでは固定例を読むだけで、Terraformは実行しません。

まず、書いた内容・記録・現在の資源を分ける

計画の前に区別する三つ
名前役割この例
構成(configuration)管理したい資源や値を記述する。許可するポートを443にしたい。
状態の記録(state)構成内の資源と実物の対応、取得した属性などを記録する。どのルールを管理しているかと、以前取得した値。
現在の資源対象のAPIなどを通して確認する実物。今のルールが許可しているポート。

stateは「実物を常に見ている画面」ではありません。前の記録後に、別の担当者が資源を変更することもあります。通常のplanでは対象を読み取り、構成と比較して変更を提案します。古い記録と、今読み取った値を同一視しないことが大切です。

planを読み、判断してapply、その後に動作を確かめる

変更の作業順を読む
変更の作業順を読む1: 構成を変更 — 計画を作る — planで確認. 2: planで確認 — 影響を確認 — applyで適用. 3: applyで適用 — 結果を読む — 結果と動作を確認123構成を変更planで確認applyで適用結果と動作を確認変更の作業順を読む1: 構成を変更 — 計画を作る — planで確認. 2: planで確認 — 影響を確認 — applyで適用. 3: applyで適用 — 結果を読む — 結果と動作を確認123構成を変更planで確認applyで適用結果と動作を確認
  1. 構成を変更 → planで確認計画を作る
  2. planで確認 → applyで適用影響を確認
  3. applyで適用 → 結果と動作を確認結果を読む
構成を変更
望む値と管理対象
planで確認
追加・変更・削除の提案
applyで適用
対象と承認した内容
結果と動作を確認
資源・通信・アプリ

図は作業の順番です。planが表示された時点では、提案した変更をapplyしたことにはなりません。applyが完了した後も、利用する通信やアプリの検証は別に行います。stateがあることだけで、その機能の正常性まで証明できるわけではありません。

固定例:記録は80、現在は8080、構成では443にしたい

一つの設定を、時点と役割で読む
見ているもの固定値ここから言えること
以前のstateの記録80前回の記録。この後も80のままとは限らない。
今回の対象読取り8080以前の記録後に差が生じている。理由は別途確認が必要。
構成ファイル443管理側が望む値。既に反映された値とは限らない。
今回の変更提案8080 → 443現在の値から構成へ近づける提案。通信成功の証明ではない。

8080への変更が、障害対応で必要だった可能性もあります。差を見つけたら、変更理由と管理者を確かめてから、構成を直すのか実物を変更するのかを判断します。コードに書いてあるから必ず今すぐ戻す、とは決めません。

画面で見たplanと、保存したplanを区別する

applyへ何を渡すかで、計画と確認の流れが変わる
操作の形意味注意すること
planだけを見る変更の見込みを確認する。時間が経てば対象や構成の条件が変わり得る。
保存planを渡さずapplyその場で新しい計画を作り、通常は確認後に適用する。以前見たプレビューと、今回の計画が同じとは限らない。
保存planを指定してapply保存された計画の操作を実行する。対話の承認プロンプトは出ない。渡す前のレビューと対象確認が必要。

保存planを使うときは、確認したファイルと適用に渡すファイルを対応させます。ただし、保存すれば必ず適用できるわけでも、外部変更をすべて防げるわけでもありません。対象、入力、構成の版、stateの条件や実行権限を合わせて確認します。

applyの失敗後は「何も変わらなかった」と決めつけない

固定例:二つの変更のうち、二つ目が失敗した
段階固定例の結果次に確かめること
変更A完了した。その資源の実際の状態と記録。
変更B権限不足で失敗した。エラーの原因、まだ変更されていない範囲。
全体の終了失敗として終わった。Aまで自動で元に戻ったとは扱わない。
  1. エラーと完了した操作を読み、実物とstateの状況を確認する。
  2. 管理対象と変更理由を保ち、必要な権限や入力などの原因を直す。
  3. 新しい計画を読み直し、残る操作と復旧条件を判断する。

チームでは、同じ対象の記録を共有し、同時書込みを防ぐ条件も必要です。stateの排他制御はbackendが対応している場合の仕組みです。remote保存なら自動で何でも安全、とは考えず、暗号化・閲覧権限・lock対応を分けて確認します。

計画・適用・記録を、固定例で判断する

選択すると、正誤と理由が表示されます。

planに「8080→443」が出た。現在の通信も443で成功済み?
答えと理由を読む

正解:いいえ。適用結果と通信確認は別に必要 · この表示は提案です。実行済みや、アプリが使える証拠にはなりません。

stateの以前の記録は80、現在の読取りは8080。何を先に確認する?
答えと理由を読む

正解:変更理由と管理対象を確認し、意図を判断する · 必要な緊急変更かもしれません。記録と実物の差を根拠なく上書きしません。

保存planを渡さずapplyする。以前のプレビューがそのまま必ず実行される?
答えと理由を読む

正解:いいえ。その場で新しい計画を確認する · 対象や入力の条件も含め、今回の計画を確認します。

保存planを指定したapplyなら、実行前に必ず承認プロンプトが出る?
答えと理由を読む

正解:いいえ。渡す前に計画と対象を審査する · 保存plan指定時は承認プロンプトが出ません。事前の審査が必要です。

Aは完了、Bは失敗。全体がエラーならAも自動で元に戻った?
答えと理由を読む

正解:いいえ。完了範囲と実物を確認する · 部分的に適用された変更が残り得ます。全体のエラーだけで巻戻しを断定しません。

保存planに値が伏せられて見える。機密値の保存は絶対ない?
答えと理由を読む

正解:いいえ。保存内容とアクセス範囲を確認する · 伏字でもstateや保存planに値が含まれる場合があります。

stateをremoteに置けば、backendに関係なく必ずlockされる?
答えと理由を読む

正解:いいえ。backendの対応と設定を確認する · 排他制御に対応しているかを確認して、同時操作を管理します。

確認して、自分の言葉で説明する

  1. 三つの役割を表で分ける。
  2. 80・8080・443の固定例を時点ごとに説明する。
  3. 保存planと部分失敗の設問で確認し、復習で適用前後の確認を説明する。
理解を確かめる: 「planは確認済み」と言われたら、applyの前後に何を確かめる?

対象と構成・入力・計画の対応、今回の適用方法と影響を確認する。適用後は完了/失敗した操作、stateと実物、使う機能を照合する。

以前のプレビュー、記録、実行結果、アプリの動作は、それぞれ異なる証拠だから。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。