プロジェクトのブランチ制限を設定する

プロジェクト ブランチ制限は、管理者がプロジェクト内のすべてのリポジトリでブランチ権限を設定し、設定をマージする方法です。注: プロジェクト ブランチ制限の適用と管理は、リポジトリ ブランチ制限と何ら変わりありません。

管理者は、プロジェクト内でブランチ制限を設定して、プロジェクトのすべてのリポジトリで一貫したブランチ権限とマージ チェックを行うことをおすすめします。つまり、プロジェクト内で設定されたすべてのブランチ制限は、そのプロジェクトのすべてのリポジトリに適用されるため、リポジトリごとにブランチ制限を設定する必要はありません。

プロジェクト ブランチ制限にアクセスして制限を追加する

1. 上部のナビゲーション バーで [プロジェクト] を選択して、ワークスペース内のプロジェクトにアクセスします。

2. ブランチ制限を追加するプロジェクトを選択します。

3. 左側のナビゲーション サイドバーで [プロジェクト設定] を選択します。

4. 左側のナビゲーション サイドバーで [ブランチ制限] を選択します。

5. [Add a branch restriction (ブランチ制限を追加)] を選択します。

See the sections below for more specifics on using branch permissions, including branch types and branch patterns, and setting merge checks.

ブランチ権限を使用する

ブランチ権限は、特定のワークフローを強制してワークスペースの新しいメンバーがメイン ブランチを削除してしまうようなエラーを防ぐために役立ちます。

ブランチ制限では、次のことを実行できます。

• 任意のブランチに書き込みまたはマージできるユーザー/グループを厳密にコントロールします。

• 特定のブランチ タイプやパターンに対応する権限を作成します。たとえば、PROJECT-* は、PROJECT-1234 などの名前を持つすべてのブランチへのアクセスを制限します。

ブランチ権限の優先度に関するルール (施行される内容の要約版)

• ユーザーとグループのアクセスは他のものを上書きします (ここでは既存のコードが ALLOW しか使用しないため、ALLOW vs DENY は指定されません)

• DENY は ALLOW をオーバーライドします

• 非ブランチ固有のアクセスは、あらゆるものに上書きされます

• 競合が発生した場合、最も高い追加価値が優先されます (他のルールには干渉しません)

ブランチ タイプ

If you've got the branching model enabled, you can configure permissions for all branches of a specific type. This might be useful if you want to restrict merge access on all release branches, for example.

ブランチ パターン

タイプよりもさらに細かくする必要がある場合は、文字列のいずれかの端にワイルドカード文字 (*) を追加することで、特定のパターンのブランチ名 (PROJECT- など) に対する権限を設定することもできます。次に例を示します。

PROJECT-*: "PROJECT-*" という名前のブランチと一致します (名前空間を含む)。したがって、制限は次のようなブランチに適用されます。

• PROJECT-1234

• PROJECT-new

• PROJECT-1.1

ブランチ権限の重複

ブランチ権限が誤って重複する可能性があります。たとえば、ブランチ名 main に専用のブランチ権限を作成したが、ブランチ パターン * によって権限を作成した場合は、両権限 (main と *) がメイン ブランチに適用されます。

次の表に、権限定義が重複した場合の結果の例を示します。

マージ前にチェックを提案または要求する

マージ チェックでは、個別のブランチやブランチ パターンのマージについて、特定の条件を推奨または要求することができます。マージ チェックはブランチ権限と連携して機能し、柔軟性と開発ワークフローの制御機能をワークスペースのメンバーに提供します。

マージ チェックの目的

依存関係のマージ

• ユーザーが成功したビルドのみを使用して変更をマージするようにします。

• マージを行う前に成功すべきビルドの数を選択します。

• Use with Bitbucket Pipelines, a build tool integration, or our commit status REST API.

コードレビューの完了

• マージをコードレビューに関連付けます。

• 同僚が協力してプル リクエストに取り組むようにします。

• マージを行うために必要な作業を開発者が把握できるよう、ワークフローに一貫性を持たせます。

タスクの完了

• プルリクエストでタスクを作成し、必要な変更をマークします。

• プルリクエストが承認に進行するまで管理します。

• マージの前にプルリクエストのすべてのタスクが完了していることを確認します。

マージ チェック

マージ チェックを使用して、マージ前に次の条件を推奨または要求できます。

When you select any of these options (and don't have the Premium plan), we'll warn users when they have unresolved merge checks, but they'll still be able to merge. To prevent users from merging, upgrade to Premium and select Prevent a merge with unresolved merge checks. Learn more about Premium

プレミアム プランの場合、次の設定にもアクセスできます。