承認ルールを使用してプルリクエストをマージするための要件を管理する - Amazon CodeCatalyst

承認ルールを使用してプルリクエストをマージするための要件を管理する

プルリクエストを作成するときに、個々のプルリクエストに必須またはオプションのレビュアーを追加できます。ただし、特定の送信先ブランチにマージする際に、すべてのプルリクエストが満たすべき要件を作成することもできます。これらの要件は承認ルールと呼ばれます。承認ルールは、リポジトリ内のブランチに対して設定されます。ターゲットブランチに承認ルールが設定されているプルリクエストを作成する場合、プルリクエストをそのブランチにマージする前に、必須のレビュアーの承認に加えて、そのルールの要件も満たす必要があります。承認ルールを作成すると、デフォルトブランチなどのブランチへのマージの品質基準を維持するのに役立ちます。

ソースリポジトリのデフォルトブランチに適用される承認ルールは、他のブランチに適用される承認ルールとは少し動作が異なります。デフォルトブランチに適用されるルールは、デフォルトブランチとして指定したブランチに自動的に適用されます。以前にデフォルトブランチとして設定されたブランチは、それに適用されるルールを保持します。

承認ルールを作成するときは、現在と今後のプロジェクトユーザーがそのルールをどのように満たすかを考慮する必要があります。例えば、プロジェクトに 6 人のユーザーがいて、送信先ブランチにマージする前に 5 つの承認を必要とする承認ルールを作成する場合、マージする前に、プルリクエストの作成者以外のすべてのユーザーがそのプルリクエストを承認する必要があるルールを効果的に作成します。

注記

CodeCatalyst プロジェクトで承認ルールを作成および管理するには、Project administrator ロールが必要です。リンクされたリポジトリの承認ルールは作成できません。

承認ルールは削除できませんが、更新して承認をなかったことにすると効率的にルールを削除できます。

プルリクエストの送信先ブランチの承認ルールを表示および編集する
  1. リポジトリが存在するプロジェクトに移動します。

  2. プロジェクトのソースリポジトリのリストからリポジトリ名を選択します。または、ナビゲーションペインで [コード] > [ソースリポジトリ] の順に選択します。

    承認ルールを表示するリポジトリを選択します。

  3. リポジトリの [概要] ページで、[ブランチ] を選択します。

  4. [承認ルール] 列で、[表示] を選択して、リポジトリの各ブランチのルールの状態を表示します。

    [承認最小数] に、プルリクエストがそのブランチにマージされるまでに必要な承認数に対応する数値を入力します。

  5. 承認ルールを変更するには、[設定を管理] を選択します。ソースリポジトリの [設定] ページにある [承認ルール][編集] を選択します。

    注記

    承認ルールを編集するには、Project administrator ロールが必要です。

  6. [ブランチ] のドロップダウンリストで、承認ルールを設定するブランチの名前を選択します。[承認最小数] に数値を入力し、[保存] を選択します。