テーマ別の解説テーマ:GitHub Actionsの配信トラブル
段階配信をいつ止める?GitHub ActionsとLambdaの配信記録を照合する
新しい版にだけ失敗が集中していたら、次の配信割合へ進む前に対象と停止条件を確認します。 10%の試験配信を例に、GitHub Actionsの実行、アラーム、実際の配信状態を照合します。
試験配信で新旧の失敗割合を比較し、停止条件と切戻し確認を説明できる。
架空のGitHub ActionsがLambdaの版をCodeDeployへ渡す構成です。ログと数字だけを読みます。
どの版と配信先を、何時点で観測したかをそろえる
GitHubのデプロイ履歴を配信対象の環境・版と照合します。Lambdaを配信するCodeDeployでは、デプロイグループの設定に応じてアラームやロールバックが使えます。実際に停止や切戻しが行われたかは配信側の記録を確認します。
- Actionsの実行 → 試験配信同じ配信IDを追う
- 試験配信 → 停止条件新旧の観測を比較する
- 停止条件 → 回復を確認停止と復旧を区別する
- Actionsの実行
- 変更と対象環境を照合
- 試験配信
- 新しい版には一部の流入
- 停止条件
- 版別の失敗率を判定
- 回復を確認
- 配信状態と業務結果を追う
全体が軽微に見えても新しい版の影響を確認する
| 版 | 失敗 / 試行 | 失敗率 |
|---|---|---|
| 旧版 | 2 / 900 | 約0.22% |
| 新版 | 12 / 100 | 12% |
| 両版合算 | 14 / 1,000 | 1.4% |
新版が例の停止条件を満たします。残りの流入を切り替えず、配信状態を確認します。自動ロールバックを使う場合も、実際に成功したかを履歴と利用者の処理結果で確認します。
停止、切戻し、復旧を別の証拠で確認する
停止した時点の配信先を確認する。 配信ステータスと、受け付けた実行がどの版へ流れたかを別々に見ます。停止だけで、旧版へ戻ったとは判断できません。
処理中の状態を確認する。 新版の処理結果が保存されていたら、版を戻しても保存済みの結果は残り得ます。同じ依頼を返す条件や再処理の必要性を確認します。
配信の進行を判断する
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- Actionsの実行と実配信ID・環境をそろえる。
- 版別の分母・失敗率と停止条件を比較する。
- 停止後の版と利用者の結果を確認する。
理解を確かめる: 新旧合算では健康に見えます。試験配信を続ける前に何を確認しますか?
新しい版に割り当てられた件数と失敗率を、式と観測期間も含めて確認します。
少数の利用者だけに出た異常は、旧版の大量の成功で薄まります。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件Lambdaの版切替とデプロイグループのアラーム設定。
参照した本文どの版と配信先を、何時点で観測したかをそろえる 全体が軽微に見えても新しい版の影響を確認する 停止、切戻し、復旧を別の証拠で確認する
確認した内容・条件ロールバック設定・再デプロイと履歴の確認。
確認した内容・条件環境のデプロイと関連するワークフローログ。
参照した本文どの版と配信先を、何時点で観測したかをそろえる