テーマ別の解説テーマ:CI/CDの設計:検査から配信と回復まで
CI/CDの公開判定:必須テスト・承認・配信する版をそろえる
公開判定(release gate)は、指定した候補を指定環境へ配信してよい条件を確認する工程です。「承認済み」「CI成功」という表示だけでなく、どの版・成果物・宛先を判断したのかを対応させます。架空の変更Bを使い、止めるべき取り違えを読み解きます。
必要条件と判断者・対象を明示し、古い承認や別成果物の検査を候補へ流用しない公開判定を設計できる。
revisionはソースの版、成果物は配信するファイル、配信先は環境です。ここでのG1は学習用の公開規則で、実GitHub設定や当サイトの承認手続を変更するものではありません。
何に対する判断かを、最初に固定する
ソースB・成果物B・宛先prod。
実行済み検査・由来・適用条件。
対象に合う承認と、例外の扱い。
実際の版・設定・利用者の結果。
合格の条件を整理した概念図です。承認しただけで配信・動作確認まで完了するわけではありません。
コードレビューは変更の妥当性、テストは定義した条件、公開判定は配信する候補と環境の条件を確認します。レビューが終わっていても、古い成果物を配信してよいとは言えません。自動検査で判定できる項目と、人が要件や影響を判断する項目を分けます。
例G1:Bをprodへ出す条件を決める
| 条件 | 必要な記録 |
|---|---|
| 対象 | ソースB・成果物Bの識別・prodの指定。 |
| 検査 | Bの必要テストを実行済み。不一致・中断・未実行なし。 |
| 成果物 | 取得バイトと記録の一致、期待する由来。 |
| 影響 | 設定差分、DB互換性、反映後の確認と切戻し範囲。 |
| 判断 | このB/prodに対応した権限のある担当者の判断。 |
| 例外 | 必須条件を満たせない場合の権限・理由・範囲・期限を別に定義。 |
G1では人の判断を条件に含めましたが、すべての変更に同じ人数や手順を必須とする一般則ではありません。変更の影響に応じて公開規則を決めます。承認者の名前や人数を増やすだけでは、対象の取り違えや未実行検査は防げません。
古い承認・別の成果物を見つけたら止める
| 観測 | G1での判断 | 追加する確認 |
|---|---|---|
| 検査B・成果物B・判断B/prod | この記録の対応は一致 | 実反映と配信後の照合はまだ別。 |
| 検査B・成果物A・判断B/prod | 停止 | 成果物をBへ対応させ直す。 |
| 検査B・成果物B・以前の判断A/prod | 停止 | Bの変更と影響を改めて判断。 |
| 検査B・成果物B・判断B/staging | 停止 | prodの設定と影響を確認。 |
| 必須検査がskip、チェックは成功扱い | 停止 | 必要な検査の実行と結果を確認。 |
承認後にソース・成果物・重要設定・宛先が変わった場合、何を再検査し再判断するかを規則へ含めます。GitHubで古いPR承認を自動失効させるかは、保護ルールの設定次第です。画面に以前のApproveが残ることと、G1が現在の候補を許可することを混同しません。
jobのskipが成功扱いになる場合があるため、必須テストの実行有無も条件にします。診断ログ収集や通知だけが成功しても、配信候補の必須検査の代替にはなりません。
文書の規則と、実際に強制する設定をそろえる
GitHubのbranch保護は取り込みの条件、environmentの保護はその環境を参照するjobの条件として使います。PRレビューが必須でも、配信jobが期待するenvironmentを参照していなければ、その環境の規則で守られるとは限りません。設定とworkflowの参照先を合わせて確認します。
機能の存在と有効な強制は別です。プランと公開範囲で利用条件が異なり、required reviewers等はFree/Pro/Teamではpublicが対象です。管理者のbypass、自分が起動した実行の自己承認を防ぐ設定、配信可能なbranch/tag等も確認します。保護名を付けただけで強制済みとは扱いません。
公開を許可した後、実際の配信を照合する
- 対象の版・成果物・宛先を固定する。
- 必須検査の対象・実行・期待結果を確認する。
- 由来と取得したバイト、必要な権限を照合する。
- 変更の影響と、条件に合う判断を記録する。
- 指定先へ反映し、実際の版・設定・利用者の結果を確かめる。
- 異常なら配信を広げず、決めた切戻しとデータ回復の範囲で判断する。
例外を認める場合も、通常の成功へ書き換えません。満たせない条件、判断者、影響範囲、期限、追加確認を記録します。「緊急だから全部無効」では、後から判断や復旧を追えなくなります。この教材から実サービスの保護を解除する操作は行いません。
候補と判断の対応を確かめる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- G1の必須条件と判断者を説明する。
- G2の4つの停止理由を見分ける。
- 文書の規則と実際の強制設定を区別する。
- 公開条件・実反映・配信後の照合を分けて記録する。
理解を確かめる: 同じBのzipでも宛先がstagingからprodへ変わった。判断をそのまま流用する?
G1では流用しません。prodの設定・権限・データ・影響と必要な判断を確認し、B/prodへ対応させます。配信後には実際の版と動作も照合します。
対象はファイルだけでなく、使う環境とその条件を含みます。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件プラン・公開範囲と保護設定による必須検査・承認、古い承認の扱い。 公式資料の確認であり、実環境の検証ではありません。
確認した内容・条件jobのskippedは成功扱いになる。実行済み検査の証拠とは分ける。workflow全体の起動スキップとは同一視しない。 公式資料を確認。実GitHub/AWSの検証ではありません。
参照した本文古い承認・別の成果物を見つけたら止める
確認した内容・条件環境の保護・秘密へのアクセス前提、必須reviewer等のプラン/公開範囲、管理者bypassの設定差。 公式資料を確認。実GitHub/AWSの検証ではありません。
参照した本文文書の規則と、実際に強制する設定をそろえる