内部リリース
内部リリースポリシー
[!IMPORTANT] すべての内部リリースには、宣言されたインシデント とリリース後のインシデントレビューが必要です。これらは任意ではありません。
重大なバグ修正に対処する内部リリースには、影響を受ける領域のエンジニアリングチームによって駆動される Feature Change Lock (FCL)がさらに必要です。
内部リリースは、パッチリリースと同じポリシー要件に従います: 重大なバグ修正とセキュリティパッチのみに限定されます。内部リリースには新機能、フィーチャーフラグの変更、 未完成の作業は含まれず、テスト目的に使用することもできません。
オーナーシップ、例外プロセス、エスカレーションパスを含む一般的なリリースポリシーのフレームワークについては、リリースポリシーのセクションを参照してください。
内部リリースがセキュリティインシデントまたは他のすでに宣言されたインシデントの結果でない場合は、インシデントを宣言しなければなりません。
内部リリースの概要
内部リリースは、私たちのシングルテナント SaaS インスタンス向けのプライベート GitLab リリースです。Dedicated インスタンス上の 高重大度の Issue（S1 または S2）を是正します:
- GitLab.com と同じくらい迅速かつ効率的に （SLA 駆動）
- 公開パッチリリースの前に脆弱性を開示することなく
- 公開パッケージにバージョンギャップを導入することなく
内部リリースは、特定の基準に従って実行されます:
- GitLab Dedicated の可用性に影響する S1 または S2 の Issue（バグまたはセキュリティ脆弱性）に対処します。重大度の低い Issue は、パッチリリースを通じて対処すべきです。
- 現在のバージョンマイナス 1（N-1）および現在のバージョンマイナス 2（N-2）の GitLab バージョンを対象とします。
- 公開開示の前に、プライベートチャンネルを通じて修正を提供します。
Dedicated インスタンス上の高重大度の Issue を修正したい場合は、内部リリースをリクエストし、GitLab エンジニア向け内部リリース runbookの手順に従ってください。
他のリリースタイプとの関係
内部リリースはパッチリリースと同じプロセスに従いますが、異なる目的を果たします:
- どちらもマンスリーリリース中に作成されたステーブルブランチを使用します
- 内部リリースは、公開パッチリリースの 前に GitLab Dedicated に修正を提供します
- 内部リリースの後、同じ修正がすべてのセルフマネージド顧客向けの次回スケジュールされたパッチリリースに含まれます
タイムライン
内部リリースには、異なる時間的特性を持つ 2 つのフェーズがあります:
| フェーズ | 期間 | 備考 |
|---|---|---|
| リクエストと承認 | 可変 | Issue の重大度の検証、ステークホルダーの可用性、修正の準備状況に依存します |
| 実行 | 約 8 時間 | 内部リリースリクエストが承認されると、リリースマネージャーはリリースプロセスを完了できます |
リクエストフェーズには以下が含まれます:
- Issue の検出と Dedicated の重大度評価
- ステークホルダーへの通知と整合
- GitLab.com 上での修正の開発と検証
- パイプラインが通過するバックポートの準備
これらの前提条件が満たされて初めて、リリースマネージャーは約 8 時間の実行フェーズを開始できます。
リクエストプロセス
[!IMPORTANT] 重大なバグ修正のために承認されたすべての内部リリースには、Feature Change Lock (FCL)とリリース後のインシデントレビューが必要です。これらは任意ではありません。 重大なセキュリティ脆弱性のために承認されたすべての内部リリースでは、リリース後の SIRT/PSIRT の振り返りへの参加が強く推奨されます。また、脆弱性が製品機能に関連する場合は、根本原因分析（RCA）が必須です。これには、GitLab の判断や遅延が脆弱性への露出の一因となった場合の、アップストリームのサードパーティコードの脆弱性も含まれます。RCA 要件が適用される場合、例外はありません。
内部リリースは、Dedicated の可用性に影響し、次回の予定パッチリリースまで待てない高重大度のバグまたはセキュリティ脆弱性に限定されます。
リリースマネージャーは、これらの基準を満たさないリクエストを却下する権限を持ちます。 Customer Success、Sales、その他のチームからのプレッシャーは、内部リリースの承認を意味しません。
対象バージョンが N-1 または N-2 の範囲外である場合、または重大度が S3 以下である場合、リクエストは自動的に却下されます。
内部リリースが必要な場合:
- 依頼者 は 内部リリースリクエスト Issue を開き、Dedicated への影響評価を文書化し、必要なすべての手順を完了します。
- 依頼者 は、影響を受ける領域の Engineering Manager に連絡し、その人を Issue にアサインし、バグ修正について Feature Change Lock (FCL) プロセスを開始してもらうことを確認します（必須）。
- Dedicated Engineering Manager（スポンサー）が Issue 上で書面による承認を提供します。
- Software Delivery Engineering Leadership（またはそれ以上）が書面による承認を提供します。
- 依頼者 は、上記のすべてが完了した後、最終レビューと実行のために active Release Managers を Issue にアサインします。
- バグ修正のリリース後: リリース前に検出を逃れた理由を調査するため、インシデントレビューを実施します（必須）。
- セキュリティ脆弱性のリリース後: SIRT/PSIRT の振り返り Issue への参加が強く推奨されます。脆弱性が製品機能に関連する場合、その脆弱性を導入した責任を負うチームが根本原因分析（RCA）を完了しなければなりません。この要件に例外はありません。
- アップストリームのサードパーティコードの脆弱性の場合、利用可能な修正を適用しなかった、サポートが終了した依存関係に頼っていたなど、GitLab の判断や遅延が脆弱性への露出の一因となった場合にのみ RCA が必須です。それ以外の場合、RCA は任意です。
このプロセス外で承認された内部リリースは、リリース安定性と GitLab Dedicated の信頼性を損なう前例を作ります。
内部リリースのプロセス
内部リリースは、初期の特定からデプロイまで、6 つのフェーズを通って進みます。
- リクエスト: 高重大度の Issue が特定され、リクエストプロセスが開始されます。トリガーは Issue のタイプによって異なります:
- セキュリティ脆弱性: SIRT チームが調査し、その Issue が S1 または S2 であることを確認します。
- 重大なバグ: Dedicated チームが、可用性の低下を引き起こす高重大度の Issue を報告します。
- 準備: リクエストが承認されると、初期実装ステップが始まり、 GitLab Dedicated Groupに通知されます。
- GitLab.com の是正: 脆弱性またはバグを担当するチームが、修正を準備して適切な GitLab リポジトリにマージし、
それが GitLab.com にデプロイされることを確認します。
セキュリティ脆弱性の場合:
- リリースマネージャーのみが security リポジトリにマージできます。
- PSIRT チームが、先に進む前に GitLab.com 上で修正を検証します。
- バックポート: 担当チームが N-1 および N-2 のステーブルブランチを対象とするマージリクエストを準備します。
- エンジニアは、バックポートがレビューされ、グリーンのパイプラインで承認されることを確認します
- エンジニアは、準備ができたらバックポートをステーブルブランチにマージします。
- セキュリティ脆弱性の場合、リリースマネージャーのみが security リポジトリにマージできます。
- リリース: 内部 CNG イメージと Omnibus パッケージがビルドされ、プレリリースチャンネルにアップロードされます。
- 最終ステップ: 内部リリースパッケージを GitLab シングルテナント SaaS インスタンスにロールアウトします。
- GitLab Dedicated Group に通知されます。
- Dedicated の緊急メンテナンスプロセスが始まります。
5d840611)