ブランチルールを使用してブランチに対して許可されるアクションを管理する

ブランチを作成すると、そのロールのアクセス許可に基づいて、そのブランチに特定のアクションが許可されます。ブランチルールを設定することで、特定のブランチに許可されるアクションを変更できます。ブランチルールは、ユーザーがプロジェクトで持つロールに基づいています。ブランチへのコミットのプッシュなど、事前定義されたアクションを、プロジェクト内の特定のロールを持つユーザーに制限できます。これにより、特定のアクションを実行できるロールを制限することで、プロジェクト内の特定のブランチを保護することができます。例えば、プロジェクト管理者ロールを持つユーザーのみがそのブランチにマージまたはプッシュできるようにブランチルールを設定すると、プロジェクト内の他のロールを持つユーザーはそのブランチのコードを変更できなくなります。

ブランチのルールを作成することのすべての影響を慎重に検討する必要があります。例えば、ブランチへのプッシュをプロジェクト管理者ロールを持つユーザーに制限すると、コントリビューターロールを持つユーザーはそのブランチでワークフローを作成または編集できなくなります。これは、ワークフローYAMLがそのブランチに保存され、これらのユーザーは に変更をコミットおよびプッシュできないためですYAML。ベストプラクティスとして、ブランチルールを作成した後にテストして、意図した影響がないことを確認します。ブランチルールをプルリクエストの承認ルールと組み合わせて使用することもできます。詳細については、「プルリクエストを承認ルールとマージするための要件の管理」を参照してください。

ソースリポジトリのデフォルトのブランチに適用されるブランチルールは、他のブランチに適用されるブランチルールとは少し動作が異なります。デフォルトブランチに適用されるルールは、デフォルトブランチとして指定したブランチに自動的に適用されます。以前にデフォルトブランチとして設定されていたブランチは、削除に対する保護がなくなる点を除いて、ルールを引き続き適用します。この保護は、現在のデフォルトブランチにのみ適用されます。

ブランチルールには、標準 とカスタム の 2 つの状態があります。Standard は、ブランチで許可されるアクションが、ブランチアクションに対してユーザーが持つロール CodeCatalyst のアクセス許可と一致するアクションであることを示します。どのロールにどのアクセス許可があるかの詳細については、「」を参照してくださいユーザーロールによるアクセスの許可。カスタムは、1 つ以上のブランチアクションに、そのアクションを実行できるロールの特定のリストを持つアクションがあり、プロジェクト内のユーザーのロールによって付与されるデフォルトのアクセス許可とは異なることを示します。

次の表に、ブランチでこれらのアクションを実行できるロールのアクションとデフォルト設定を示します。

ブランチルールを削除することはできませんが、ブランチでこのアクションを実行することを許可するすべてのロールからのアクションを許可するように更新することで、ルールを効果的に削除できます。