各開発ステージの機能のサポート
GitLabは、実験的機能やベータ版など、さまざまな開発ステージで機能をリリースする場合があります。ユーザーはオプトインすれば、新しいユーザーエクスペリエンスをテストできます。これらの機能リリースの理由としては、次のようなものがあります:
- 設計されたあらゆるユースケースにおいて、現在の状態の機能のスケール、サポート、メンテナンス負担のエッジケースを検証するため。
- MVCと見なせるほど完成していない機能を、開発プロセスの一環としてコードベースに追加するため。
一部の機能は、これらの推奨事項が整備される前に開発された場合や、チームが代替の実装アプローチが必要であると判断した場合には、これらの推奨事項に沿っていないことがあります。
その他すべての機能は、一般提供されているものと見なされます。
実験
実験的機能:
- 本番環境での使用には適していません。
- サポートは提供されません。このような機能に関するイシューは、GitLabイシュートラッカーで提起する必要があります。
- 不安定である可能性があります。
- いつでも削除される可能性があります。
- 一般提供に至らない可能性があります。
- データ損失のリスクがある可能性があります。
- ドキュメントがない場合や、情報がGitLabイシューまたはブログのみに限られている可能性があります。
- 最終的なユーザーエクスペリエンスが確立されていない場合があり、クイックアクションまたはAPIリクエストからのみアクセスできる場合があります。
ベータ版
ベータ版機能:
- 本番環境での使用には適していない可能性があります。
- 商業的に合理的な努力の範囲でサポートされます。ただし、問題のトラブルシューティングには、開発チームによる追加の時間と支援が必要になることが想定されます。
- 不安定である可能性があります。
- 変更される可能性が低い設定と依存関係があります。
- 変更される可能性が低い機能があります。ただし、メジャーリリース以外で、または一般提供されている機能よりも短い通知期間で、破壊的な変更が発生する可能性があります。
- データ損失のリスクは低いです。
- ユーザーエクスペリエンスは完成しているか、ほぼ完成しています。
- パートナーの「Publicプレビュー」ステージと同等である場合があります。
公開提供
公開リリースには次の2種類があります:
- 限定提供
- 一般提供
どちらの種類も本番環境に対応していますが、スコープが異なります。
限定提供
限定提供機能は一般提供機能と同じセキュリティ要件に従いますが、初期のロールアウト時は、一部のプラットフォームのみにデプロイされる場合や、スケールに制限がある場合があります。
限定提供機能:
- 縮小されたスケールで本番環境に使用できます。
- 最初は、1つ以上のGitLabプラットフォーム(GitLab.com、GitLab Self-Managed、GitLab Dedicated)で利用できる場合があります。
- 最初は無料で提供され、一般提供時に有料になる場合があります。
- 一般提供の前に割引が提供される場合があります。
- 一般提供時に新規契約の商用条件が変更される場合があります。
- 完全にサポートされており、文書化されています。
- GitLabデザイン標準に準拠した完全なユーザーエクスペリエンスを備えています。
一般提供
一般提供機能:
- 任意のスケールで本番環境に使用できます。
- 完全にサポートされており、文書化されています。
- GitLabデザイン標準に準拠した完全なユーザーエクスペリエンスを備えています。
- すべてのGitLab提供製品(GitLab.com、GitLab.com Cells、GitLab Self-Managed、GitLab Dedicated、GitLab Dedicated for Government)で利用可能である必要があります。
機能リリース要件
ユーザーが機能を利用できるようにする前に、その機能を開発しているGitLabチームは、上記のステータスガイダンスと、各開発ステージの要件を考慮する必要があります。
用語
明確にするため、これらのガイドラインでは次の定義を使用します:
- 明示的なオプトイン: 機能はデフォルトで無効になっており、権限のあるユーザー(機能のスコープに応じて、インスタンス管理者、グループオーナー、個々のユーザーなど)による意図的な有効化アクションが必要です。有効化は可能であるものの、アクティブ化されるまでは無効のままになっている機能は、明示的なオプトインを必要とするものと見なされます。
- デフォルトで有効: オプトインアクションを必要とせずに、ユーザーまたはインスタンスに対して機能が有効になっている状態です。実験的機能またはベータステージでは、機能をデフォルトで有効にしてはいけません。
- 本番環境での使用: 以下の両方を指します:
- 顧客の本番環境ワークロード(ユーザーが業務運用で依存する機能)
- GitLab.com、GitLab Dedicated、およびDedicated for Federalをサポートする、GitLab管理の本番環境インフラストラクチャ(プラットフォームの信頼性またはセキュリティに影響する共有サービス)
- 内部テスト: 検証目的でGitLabチームメンバーがGA前の機能を使用すること。カスタマーゼロとも呼ばれます。
機能の成熟度移行の原則
機能が次の成熟度ステージに進む準備ができているかどうかを評価する際は、インシデント対応テストを適用してください:
「この機能がすでに目標の成熟度レベルにあったとして、このリスクが顕在化した場合、インシデントを宣言して緊急修正を適用することになるだろうか?」
機能は、GA後に発生した場合にインシデント対応を引き起こすようなリスクを抱えた状態でGAに移行すべきではありません。次のようなリスクが該当します:
- 重大な(S1/S2)セキュリティ脆弱性
- SLAのコミットメントに違反するパフォーマンス低下
- 顧客への通知が必要なデータ整合性の問題
- プラットフォームの安定性を損なう可用性への影響
この原則は、将来のインシデント発生が予見される状態での公開を避け、適切なリスク対策により、機能が本番環境の成熟度に達することを保証するものです。
実験的機能
- デフォルトで無効にし、明示的なオプトインを必須にする必要があります。顧客のアクションなしに、ユーザーまたはインスタンスに対して自動的に有効にすることはできません。
- マルチテナントプラットフォームでは、オプトインしたユーザーが他のテナントにリスクをもたらさないように、テナントの分離を維持する必要があります。
- リリース成熟度の現状によっては、セキュリティ修正が標準的な手順、つまり通常の公開プロセスでリリースされる場合があります。脆弱性修正に関する標準のサービスレベル目標は、実験的機能には適用されません。
- 明記されたベータ版要件を満たさずにベータ版に移行する例外には、VPの承認が必要です。
内部テスト(カスタマーゼロ)では、エンジニアリング面の検証を目的として実験的機能を使用する場合があります。全社的な業務プロセス(オンボーディング、アクセス管理、コンプライアンスワークフローなど)に影響する機能については、エンジニアリングおよびセキュリティ部門の責任者がリスクを受容したことを記録しておく必要があります。
ベータ版機能
- デフォルトで無効にし、明示的なオプトインを必須にする必要があります。顧客のアクションなしに、ユーザーまたはインスタンスに対して自動的に有効にすることはできません。
- マルチテナントプラットフォームでは、オプトインしたユーザーが他のテナントにリスクをもたらさないように、テナントの分離を維持する必要があります。
- 一般提供前に、セキュリティリリースプロセスを確立する計画を文書化し、利害関係者と合意しておく必要があります。このプロセスでは、脆弱性の特定、追跡、優先順位付け、修正、および協調的な開示を通じた通知方法を含め、時期尚早な公開は避けつつ、安全な脆弱性修正を実現しなければなりません。
- リリース成熟度の現状によっては、セキュリティ修正が標準的な手順、つまり通常の公開プロセスでリリースされる場合があります。脆弱性修正に関する標準のサービスレベル目標は、ベータ版機能には適用されません。
- 一般提供前に、監査ログを実装する計画を文書化し、利害関係者と合意しておく必要があります。この計画では、記録されるイベント、ログ形式と保持期間、セキュリティチームによるログへのアクセス方法、既存の監査システムとの統合ポイントを明記する必要があります。
- 明記されたGA要件を満たさずにGAに移行する例外には、eグループの承認が必要です。
限定提供機能
- 時期尚早な公開を避けつつ安全な脆弱性修正を可能にする、運用中のセキュリティリリースプロセスが必要です。
- セキュリティチーム(社内および顧客)が異常な動作を検出し、セキュリティインシデントを調査し、誰が、何を、どこで、いつ行ったのかという基本的な質問に答えられるようにする、運用中の監査ログが必要です。監査ログに洗練されたUIエクスペリエンスは必要ありませんが、セキュリティ関連イベントへのプログラムによるアクセスを提供する必要があります。
- 運用手順書が必要です。
一般提供機能
- GAに移行する前に、セキュリティレビューが完了している必要があります。セキュリティレビューのスコープは、機能特性(顧客向け機能、インフラストラクチャへの影響、データアクセスパターン)によって決まります。セキュリティレビューが一部未完了の状態でGAに移行する機能には、Eグループの承認が必要です。
- 脆弱性修正に関するサービスレベル目標を遵守し、Eグループがリスクを受容したことが文書化されていない限り、S1/S2脆弱性を含む状態でリリースしてはいけません。インシデント対応テストの適用: GA後に発見された場合に、パッチの緊急配布が必要になるリスクが解消されていない機能は、出荷してはいけません。
- 時期尚早な公開を避けつつ安全な脆弱性修正を可能にする、運用中のセキュリティリリースプロセスが必要です。
- セキュリティチーム(社内および顧客)が異常な動作を検出し、セキュリティインシデントを調査し、誰が、何を、どこで、いつ行ったのかという基本的な質問に答えられるようにする、運用中の監査ログが必要です。監査ログに洗練されたUIエクスペリエンスは必要ありませんが、セキュリティ関連イベントへのプログラムによるアクセスを提供する必要があります。
例外ガバナンス
ビジネス上の必要性によりこれらの要件から逸脱する必要がある例外的な状況では、GitLabは役員承認とリスク受容を経た、文書化された例外プロセスに従います。