ブランチルール

GitLabは、個々のブランチを保護するための複数の方法を提供しています。これらの方法により、ブランチを作成してから削除するまで、監視と品質チェックを受けることができます:

• プロジェクトのデフォルトブランチに、強化されたセキュリティと保護を適用します。
• 保護ブランチを設定して以下を行います:
  • ブランチへのプッシュおよびマージを許可するユーザーを制限します。
  • ユーザーがブランチに強制プッシュできるかどうかを管理します。
  • CODEOWNERSファイルにリストされているファイルへの変更を、ブランチに直接プッシュできるかどうかを管理します。
• 承認ルールを設定してレビュー要件を管理し、セキュリティ関連の承認を実装します。
• サードパーティのステータスチェックと統合して、ブランチのコンテンツが定義された品質基準を満たしていることを確認します。

ブランチは以下で管理できます:

• GitLabのユーザーインターフェースを使用します。
• コマンドラインでGitを使用。
• Branches APIを使用。

ブランチルールを表示する

ブランチルール概要ページには、設定された保護と保護方法が設定されたすべてのブランチが表示されます:

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

ブランチルール概要リストを表示するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > リポジトリを選択します。
3. ブランチルールを展開して、保護されたすべてのブランチを表示します。

ブランチルールの詳細を表示

単一のブランチに対するブランチルールと保護を表示するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > リポジトリを選択します。
3. ブランチルールを展開して、保護されたすべてのブランチを表示します。
4. 目的のブランチを特定し、詳細を表示を選択します。

ブランチルールを作成する

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

ブランチルールを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > リポジトリを選択します。
3. ブランチルールを展開します。
4. ブランチルールの追加を選択します。
5. 次のいずれかのオプションを選択します:
   • 特定のブランチ名またはパターンを入力するには:
     1. ブランチ名またはパターンを選択します。
     2. ブランチルールの作成ドロップダウンリストから、ブランチ名を選択するか、*でワイルドカードを作成します。
   • プロジェクト内のすべてのブランチを保護するには:
     1. すべてのブランチを選択します。
     2. ルールの詳細ページのマージリクエストの承認で、ルールに必要な承認数を入力します。
   • すでに保護されていると指定されているプロジェクト内のすべてのブランチを保護するには:
     1. 全ての保護ブランチを選択します。
     2. ルールの詳細ページのマージリクエストの承認で、ルールに必要な承認数を入力します。

ブランチルール保護の追加

新しいブランチに保護を追加するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > リポジトリを選択します。
3. ブランチルールを展開します。
4. ブランチルールの追加を選択します。
5. 全ての保護ブランチまたはブランチ名またはパターンのいずれかを選択します。
6. ブランチルールの作成を選択します。

承認ルールを追加する

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

マージリクエスト承認ルールを追加するには:

1. ブランチルールの詳細ページから、マージリクエストの承認セクションに移動します。
2. 承認ルールセクションで、承認ルールを追加を選択します。
3. 右側のサイドバーで、次のフィールドに入力します:

   • ルール名を入力します。

   • 必要な承認数に、値を入力します（0-100）。

     0の値はルールをオプションにし、0より大きい数値を指定すると必須ルールが作成されます。必要な承認の最大数は100です。

   • 承認できるユーザーまたはグループを選択します。

     GitLabは、マージリクエストによって変更されたファイルの以前の作成者に基づいて承認者を提案します。

4. 変更を保存を選択します。

詳細については、承認ルールを参照してください。

コミットをスカッシュオプションの編集

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。
• GitLab Freeでは、ブランチルールがすべてのブランチを対象とする場合にのみ、この機能を使用できます。
• GitLab PremiumおよびGitLab Ultimateでは、この機能はすべてのブランチルールで使用できます。

スカッシュオプションを編集するには:

1. ブランチルールの詳細ページから、マージ時にコミットをスカッシュするセクションに移動します。

2. 編集を選択します。

3. 次のいずれかのオプションを選択します:

   • 許可しない: スカッシュは許可されず、チェックボックスは非表示になります。
   • 許可: チェックボックスが表示され、デフォルトで選択されていません。
   • 推奨: チェックボックスが表示され、デフォルトで選択されています。
   • 必須: スカッシュは常に実行されます。チェックボックスが表示されて選択され、ユーザーは変更できません。

4. 変更を保存を選択します。

ステータスチェックサービスを追加

ステータスチェックサービスを追加するには:

1. ブランチルールの詳細ページから、ステータスチェックセクションに移動します。

2. ステータスチェックの追加を選択します。

3. サービス名を入力します。

4. チェックするAPIフィールドに、URLを入力します。

   転送中のマージリクエストデータを保護するには、HTTPS URLを使用する必要があります。

詳細については、外部ステータスチェックを参照してください。

ブランチルールターゲットの編集

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

ブランチルールターゲットを編集するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > リポジトリを選択します。
3. ブランチルールを展開して、保護されたすべてのブランチを表示します。
4. 目的のブランチを特定し、詳細を表示を選択します。
5. ルールターゲットセクションで、編集を選択します。
6. 必要に応じて情報を編集します。
7. 更新を選択します。

ブランチルール保護の編集

ブランチ保護コントロールの詳細については、保護ブランチを参照してください。

ブランチルールを削除する

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

ブランチルールを削除するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > リポジトリを選択します。
3. ブランチルールを展開します。
4. 削除するルールの横にある詳細を表示を選択します。
5. 右上隅で、ブランチルールの削除を選択します。
6. 確認ダイアログで、ブランチルールの削除を選択します。

関連トピック

• デフォルトブランチ
• 保護ブランチ
• リポジトリを保護する
• ブランチ戦略
• マージリクエストの承認