テーマ別の解説テーマ:GitHub Actionsの配信トラブル
GitHub Actionsの成果物が承認時と違う|digestと来歴を照合する
同じ配信タグでも、取得したファイルが承認した成果物と一致するかを確かめます。 架空の画像受付サービスのコンテナを例に、digest、対象版、来歴、承認の役割を分けて確認します。
承認を結びつける成果物の特定方法を説明し、digestの不一致と来歴不足を区別して次の判断を選べる。
教材の名前と識別子は説明用に短縮した値です。実際の成果物の取得・検証・配信は行いません。
名前、内容、来歴、承認を対応付ける
GitHubの成果物アテステーションは、対象のファイルやコンテナがどこでどのように作られたかを確かめるために使えます。配信用の記録から、取得した成果物のバイト列、期待する来歴、承認対象を照合します。
- 承認記録 → 取得した候補承認時の識別子を取る
- 取得した候補 → digestを照合取得した内容を識別する
- digestを照合 → 配信を保留相違を記録する
- 承認記録
- 対象は成果物A
- 取得した候補
- 同じタグで成果物B
- digestを照合
- AとBが一致しない
- 配信を保留
- 来歴と承認を調べる
同じタグに見える二つの成果物を比べる
| 記録 | 承認時 | 配信直前 |
|---|---|---|
| 参照名 | release-next | release-next |
| 内容を表すdigest | A | B |
| 承認が参照する成果物 | A | A |
配信直前の内容は承認対象と一致しません。タグを見て承認済みと判断せず、承認の対象と実際に取得した成果物を確認します。Bに来歴があってもAの承認はBへ引き継がれません。
照合の失敗ごとに確認する情報を選ぶ
digest不一致。 取得した場所、選んだ版、配信予定の参照先を確認します。別物を配信する場合は、その内容を対象に新たな判断が必要です。
digest一致で来歴未確認。 内容の一致が分かった後、必要な来歴があるか、対象と許可した発行元に結び付くかを確認します。アテステーションの利用条件は、リポジトリや利用プランの公式資料を確認します。
照合の結果から配信判断を選ぶ
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 承認記録から対象環境と完全なdigestを読む。
- 取得物のdigestと必要な来歴を照合する。
- 差分を記録し、進行に必要な合格・承認を確認する。
理解を確かめる: digest一致で来歴が未確認です。どこまで確かめられましたか?
承認記録が示す内容と取得内容が一致することです。
どこで作ったかは来歴、進めてよいかは配信の承認条件から別に確認します。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件成果物の来歴、対象digest、検証の取得条件。
参照した本文名前、内容、来歴、承認を対応付ける 同じタグに見える二つの成果物を比べる 照合の失敗ごとに確認する情報を選ぶ