テーマ別の解説テーマ:GitHub Actionsの配信トラブル
GitHub ActionsでTerraformのstate lockを取得できないときの確認順
state lockを取得できないときは、同じ状態を操作中の主体を探します。 GitHub Actionsの実行待ちと、Terraformバックエンドのロックを架空の事例で分けます。
同じstateの範囲とロックの所有者を照合し、作業中のロックと残留が疑われる状態を適切に扱える。
ロックをサポートするリモートバックエンドを想定します。実際のstateやロックの操作は行いません。
GitHubのスケジューリングとstateの保護を分けて読む
GitHub Actionsのconcurrency groupは同じリポジトリ内の実行を調整します。Terraformのバックエンドのロックは、同じstateに対する操作の競合を防ぎます。別リポジトリやローカル作業の有無も確認します。
- 配信ジョブ → stateを照合対象を特定する
- stateを照合 → 保有者を探す同じstateの実行を探す
- 保有者を探す → 次の判断書き込みの状態を確認
- 配信ジョブ
- 対象の環境名を控える
- stateを照合
- バックエンドと状態キー
- 保有者を探す
- CI・他リポジトリ・手作業
- 次の判断
- 作業終了を確認して再検査
同じstateを触る処理を洗い出す
| 見えた記録 | 読み方 | 判断 |
|---|---|---|
| リポジトリ内のAは待機中 | CIスケジューリングが待たせている | 同じグループで動く処理を確認。 |
| 別リポジトリのBは同じstateに適用中 | バックエンドを共有する実行がある | 作業終了と結果を待つ。 |
| Aが失敗。Bは終了表示だがstate lockが残る | 残留の可能性。終了表示だけでは確定できない | 他の書き手とサービス側の適用状態を照合。 |
ロックの時刻だけで残留と判断しません。実行の所有者、バックエンド、対象状態、クラウド側の反映を照合し、状態と実物が一致するかを確認します。
中断の影響を確かめ、再開時に差分を読み直す
稼働中のロックを保持する。 同じバックエンドを使う別の実行が続いている場合は、ロックを維持して作業結果を待ちます。残留が疑われても、操作の終了と担当の確認を先に行います。
同じ状態の運用を揃える。 リポジトリ内の競合回避にconcurrencyは使えますが、状態を共有する全ての実行を制御するものではありません。再開時は変更計画と承認の対象を照らし直します。
競合を防ぐための判断を選ぶ
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 対象バックエンドとstateを照合する。
- CIと他の実行元から保有者と状態を確かめる。
- 終了と適用結果を照合し、最新の変更計画を読み直す。
理解を確かめる: ジョブ終了後に古いplanをそのまま使えますか?
現在の状態と実際の差分を確認してから、計画と承認を取り直す必要があるか判断します。
他の処理が状態を変えた場合、以前の計画は今の差分を表していません。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
- State locking確認日:
確認した内容・条件バックエンドのロック、同時書き込み防止、ロック解除の制約。
参照した本文GitHubのスケジューリングとstateの保護を分けて読む 同じstateを触る処理を洗い出す 中断の影響を確かめ、再開時に差分を読み直す
確認した内容・条件concurrency groupによるリポジトリ内のジョブ・実行の制御。
参照した本文GitHubのスケジューリングとstateの保護を分けて読む 同じstateを触る処理を洗い出す 中断の影響を確かめ、再開時に差分を読み直す