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

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

LEARNINGEN準備中

テーマ別の解説テーマ:GitHub Actionsの配信トラブル

GitHub ActionsでTerraformのstate lockを取得できないときの確認順

state lockを取得できないときは、同じ状態を操作中の主体を探します。 GitHub Actionsの実行待ちと、Terraformバックエンドのロックを架空の事例で分けます。

この教材で学ぶこと

同じstateの範囲とロックの所有者を照合し、作業中のロックと残留が疑われる状態を適切に扱える。

先に知っておくこと

ロックをサポートするリモートバックエンドを想定します。実際のstateやロックの操作は行いません。

GitHubのスケジューリングとstateの保護を分けて読む

GitHub Actionsのconcurrency groupは同じリポジトリ内の実行を調整します。Terraformのバックエンドのロックは、同じstateに対する操作の競合を防ぎます。別リポジトリやローカル作業の有無も確認します。

候補ジョブがロックで止まった例
候補ジョブがロックで止まった例1: 配信ジョブ — 対象を特定する — stateを照合. 2: stateを照合 — 同じstateの実行を探す — 保有者を探す. 3: 保有者を探す — 書き込みの状態を確認 — 次の判断123配信ジョブstateを照合保有者を探す次の判断候補ジョブがロックで止まった例1: 配信ジョブ — 対象を特定する — stateを照合. 2: stateを照合 — 同じstateの実行を探す — 保有者を探す. 3: 保有者を探す — 書き込みの状態を確認 — 次の判断123配信ジョブstateを照合保有者を探す次の判断
  1. 配信ジョブ → stateを照合対象を特定する
  2. stateを照合 → 保有者を探す同じstateの実行を探す
  3. 保有者を探す → 次の判断書き込みの状態を確認
配信ジョブ
対象の環境名を控える
stateを照合
バックエンドと状態キー
保有者を探す
CI・他リポジトリ・手作業
次の判断
作業終了を確認して再検査

同じstateを触る処理を洗い出す

合成例。A・Bはいずれも検証環境の同じstateを対象とする
見えた記録読み方判断
リポジトリ内のAは待機中CIスケジューリングが待たせている同じグループで動く処理を確認。
別リポジトリのBは同じstateに適用中バックエンドを共有する実行がある作業終了と結果を待つ。
Aが失敗。Bは終了表示だがstate lockが残る残留の可能性。終了表示だけでは確定できない他の書き手とサービス側の適用状態を照合。

ロックの時刻だけで残留と判断しません。実行の所有者、バックエンド、対象状態、クラウド側の反映を照合し、状態と実物が一致するかを確認します。

中断の影響を確かめ、再開時に差分を読み直す

稼働中のロックを保持する。 同じバックエンドを使う別の実行が続いている場合は、ロックを維持して作業結果を待ちます。残留が疑われても、操作の終了と担当の確認を先に行います。

同じ状態の運用を揃える。 リポジトリ内の競合回避にconcurrencyは使えますが、状態を共有する全ての実行を制御するものではありません。再開時は変更計画と承認の対象を照らし直します。

競合を防ぐための判断を選ぶ

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

別リポジトリBが同じstateを適用中です。Aの対応は?
答えと理由を読む

正解:Bの作業と適用結果を待ち、対象を再確認 · 同じ状態への並行操作を防ぐロックを維持します。

先のジョブはキャンセル表示ですが、ロックが残ります。最初に何を確認?
答えと理由を読む

正解:保有者と作業実行、実際の反映状況 · 終了表示だけでは作業やクラウド側反映が済んだか不明です。

Actionsのグループを統一すれば別リポジトリも保護されますか?
答えと理由を読む

正解:state共有の範囲でバックエンドと運用による対策も必要 · Actionsの制御の範囲とバックエンドは別です。

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

  1. 対象バックエンドとstateを照合する。
  2. CIと他の実行元から保有者と状態を確かめる。
  3. 終了と適用結果を照合し、最新の変更計画を読み直す。
理解を確かめる: ジョブ終了後に古いplanをそのまま使えますか?

現在の状態と実際の差分を確認してから、計画と承認を取り直す必要があるか判断します。

他の処理が状態を変えた場合、以前の計画は今の差分を表していません。

出典と確認した条件

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