承認ルールテンプレートを作成する

https://console.aws.amazon.com/codesuite/codecommit/home で CodeCommit コンソールを開きます。

[Approval rule templates (承認ルールテンプレート)] を選択し、[Create template (テンプレートの作成)] を選択します。

[Approval rule template name (承認ルールのテンプレート名)] で、テンプレートにわかりやすい名前を付けます。例えば、プルリクエストをマージする前に、上級デベロッパーのうちの 1 人に対して、プルリクエストを承認するように求める場合は、ルール Require 1 approver from a senior developer に名前を付けることができます。

（オプション） [Description (説明)] に、このテンプレートの目的の説明を入力します。これは、このテンプレートがリポジトリに適しているかどうかを判断するのに役立ちます。

[Number of approvals needed (必要な承認の数)] に、必要な数値を入力します。デフォルトは 1 です。

（オプション）プルリクエストの承認を特定のユーザーグループからリクエストする場合は、[Approval rule members (承認ルールのメンバー)] で [Add (追加)] を選択します。[Approver type (承認者のタイプ)] で、次のいずれかを選択します。

承認者のタイプとして [IAM user name or assumed role] (IAM ユーザー名または引き受けたロール) を選択した場合は、[Value] (値) に、IAM ユーザーまたはロールの名前またはユーザーかロールの完全修飾 ARN を入力します。承認が必要な承認の数にカウントされるすべてのユーザーまたはロールを追加するまで、[Add (追加)] を再度選択してユーザーまたはロールを追加します。

どちらの承認者タイプでも、値にワイルドカード (*) を使用できます。例えば、[IAM user name or assumed role] (IAM ユーザー名または引き受けたロール) オプションを選択し、CodeCommitReview/* を指定した場合、CodeCommitReview のロールを引き受けるすべてのユーザーが承認プールにカウントされます。個々のロールセッション名は、必要な承認者数にカウントされます。このようにして、Mary_Major と Li_Juan は、サインインして CodeCommitReview のロールを引き受けるときに承認としてカウントされます。IAM ARN、ワイルドカード、および形式の詳細については、IAM 識別子を参照してください。

（オプション） [Branch filters (ブランチフィルター)] で、承認ルールの作成をフィルタリングするために使用する送信先ブランチ名を入力します。例えば、main を指定した場合、プルリクエストの送信先ブランチが main という名前のブランチである場合にのみ、関連付けられたリポジトリのプルリクエストに対して承認ルールが作成されます。ブランチ名にワイルドカード (*) を使用すると、ワイルドカードケースに一致するすべてのブランチ名に承認ルールを適用できます。ただし、ブランチ名の先頭にワイルドカードを使用することはできません。最大 100 のブランチ名を指定できます。フィルターを指定しない場合、テンプレートは関連付けられたリポジトリのすべてのブランチに適用されます。

(オプション) [Associated repositories (関連付けられたリポジトリ)] の [Repositories (リポジトリ)] リストで、この承認ルールに関連付けるこの AWS リージョン のリポジトリを選択します。

[Create] を選択します。

ターミナルまたはコマンドラインで、次を指定して、create-approval-rule-template コマンドを実行します。

承認ルールのコンテンツを作成するときに、次のいずれかの方法で、承認プールの承認者を指定できます。

IAM ARN、ワイルドカード、および形式の詳細については、IAM 識別子を参照してください。

次の例では、2-approver-rule-for-main という名前の承認ルールテンプレートと Requires two developers from the team to approve the pull request if the destination branch is main の説明を作成します。このテンプレートでは、CodeCommitReview のロールを引き受ける 2 人のユーザーがプルリクエストを main ブランチにマージする前に承認する必要があります。

aws codecommit create-approval-rule-template --approval-rule-template-name 2-approver-rule-for-main --approval-rule-template-description "Requires two developers from the team to approve the pull request if the destination branch is main" --approval-rule-template-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"

成功すると、このコマンドは以下のような出力を返します。

{
    "approvalRuleTemplate": {
        "approvalRuleTemplateName": "2-approver-rule-for-main",
        "creationDate": 1571356106.936,
        "approvalRuleTemplateId": "dd8b17fe-EXAMPLE",
        "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
        "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
        "approvalRuleTemplateDescription": "Requires two developers from the team to approve the pull request if the destination branch is main",
        "lastModifiedDate": 1571356106.936,
        "ruleContentSha256": "4711b576EXAMPLE"
    }
}