Gérer les modèles de règles d'approbation

Vous pouvez gérer les modèles de règles d'approbation de manièreRégion AWS à mieux comprendre comment ils sont utilisés et à quoi ils servent. Par exemple, vous pouvez modifier les noms et les descriptions des modèles de règles d'approbation pour aider les autres à comprendre leur rôle. Vous pouvez répertorier tous les modèles de règles d'approbation dans unRégion AWS et obtenir des informations sur le contenu et la structure d'un modèle. Vous pouvez rechercher quels sont les modèles associés à un référentiel et quels sont référentiels associés à un modèle.

Pour plus d'informations sur les politiques gérées et les autorisations pour les modèles de règles d'approbation, consultezAutorisations pour les actions sur les modèles de règles d'approbation etAWS politiques gérées pour CodeCommit.

Gérer les modèles de règles d'approbation (console)

Vous pouvez afficher et gérer vos modèles de règles d'approbation dans la console CodeCommit.

Pour gérer les modèles de règles d'approbation

1. Ouvrez laCodeCommit console à l'adresse https://console.aws.amazon.com/codesuite/codecommit/home.

2. Choisissez Modèles de règles d'approbation pour afficher la liste des modèles de règles d'approbation dansRégion AWS lequel vous êtes connecté.

   Note

   Les modèles de règle d'approbation sont uniquement disponibles dans laRégion AWS où ils ont été créés.

3. Si vous souhaitez apporter des modifications à un modèle, sélectionnez-le dans la liste, puis choisissez Edit (Modifier).

4. Effectuez les modifications, puis choisissez Enregistrer.

Gérer les modèles de règles d'approbation (AWS CLI)

Vous pouvez gérer vos modèles de règles d'approbation à l'aide des commandes suivantes de l'AWS CLI :

• list-approval-rule-templates, pour consulter la liste de tous les modèles de règle d'approbation dans une région pour unRégion AWS

• get-approval-rule-template, pour afficher le contenu d'un modèle de règle d'approbation

• update-approval-rule-template-content, pour modifier le contenu d'un modèle de règle d'approbation

• update-approval-rule-template-name, pour modifier le nom d'un modèle de règle d'approbation

• update-approval-rule-template-description, pour modifier la description d'un modèle de règle d'approbation

• list-repositories-for-approval-rule-template, pour afficher tous les référentiels associés à un modèle de règle d'approbation

• list-associated-approval-rule-templates-for-repository, pour afficher tous les modèles de règles d'approbation associés à un référentiel

Pour répertorier tous les modèles de règle d'approbation dans unRégion AWS

1. Depuis le terminal ou la ligne de commande, exécutez la commande list-approval-rule-templates. Par exemple, pour répertorier tous les modèles de règle d'approbation dans la région USA Est (Ohio) :

   aws codecommit list-approval-rule-templates --region us-east-2

2. Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   {
       "approvalRuleTemplateNames": [
           "2-approver-rule-for-main",
           "1-approver-rule-for-all-pull-requests"
       ]
   }

Pour obtenir le contenu d'un modèle de règle d'approbation

1. Sur le terminal ou la ligne de commande, exécutez la commande get-approval-rule-template en spécifiant le nom du modèle de règle d'approbation :

   aws codecommit get-approval-rule-template --approval-rule-template-name 1-approver-rule-for-all-pull-requests

2. Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   {
       "approvalRuleTemplate": {
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "ruleContentSha256": "621181bbEXAMPLE",
           "lastModifiedDate": 1571356106.936,
           "creationDate": 1571356106.936,
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan",
           "approvalRuleTemplateId": "a29abb15-EXAMPLE",
           "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team."
       }
   }

Pour mettre à jour le contenu d'un modèle de règle d'approbation

1. Sur le terminal ou l'invite de commandes, exécutez la commande update-approval-rule-template-content en spécifiant le nom du modèle et le contenu modifié. Par exemple, pour modifier le contenu d'un modèle de règle d'approbation nommé 1-approver-rule afin de redéfinir le groupe d'approbation et d'inclure des utilisateurs assumant le rôle CodeCommitReview :

   aws codecommit update-approval-rule-template-content --approval-rule-template-name 1-approver-rule --new-rule-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"

2. Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   {
       "approvalRuleTemplate": {
           "creationDate": 1571352720.773,
           "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool",
           "lastModifiedDate": 1571358728.41,
           "approvalRuleTemplateId": "41de97b7-EXAMPLE",
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "ruleContentSha256": "2f6c21a5EXAMPLE",
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan"
       }
   }

Pour mettre à jour le nom d'un modèle de règle d'approbation

1. Sur le terminal ou l'invite de commandes, exécutez la commande update-approval-rule-template-name en spécifiant le nom actuel et le nom par lequel vous souhaitez le remplacer. Par exemple, pour remplacer le nom du modèle de règle d'approbation 1-approver-rule par 1-approver-rule-for-all-pull-requests :

   aws codecommit update-approval-rule-template-name --old-approval-rule-template-name "1-approver-rule" --new-approval-rule-template-name "1-approver-rule-for-all-pull-requests"

2. Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   {
       "approvalRuleTemplate": {
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "lastModifiedDate": 1571358241.619,
           "approvalRuleTemplateId": "41de97b7-EXAMPLE",
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "creationDate": 1571352720.773,
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
           "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team.",
           "ruleContentSha256": "2f6c21a5cEXAMPLE"
       }
   }

Pour mettre à jour la description d'un modèle de règle d'approbation

1. Sur le terminal ou la ligne de commande, exécutez la commande update-approval-rule-template-description, en spécifiant le nom du modèle de règle d'approbation et la nouvelle description :

   aws codecommit update-approval-rule-template-description --approval-rule-template-name "1-approver-rule-for-all-pull-requests" --approval-rule-template-description "Requires 1 approval for all pull requests from the CodeCommitReview pool" 

2. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :

   {
       "approvalRuleTemplate": {
           "creationDate": 1571352720.773,
           "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool",
           "lastModifiedDate": 1571358728.41,
           "approvalRuleTemplateId": "41de97b7-EXAMPLE",
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "ruleContentSha256": "2f6c21a5EXAMPLE",
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan"
       }
   }

Pour répertorier tous les référentiels associés à un modèle

1. Sur la ligne de commande ou le terminal, exécutez la commande list-repositories-for-approval-rule-template en spécifiant le nom du modèle :

   aws codecommit list-repositories-for-approval-rule-template --approval-rule-template-name 2-approver-rule-for-main

2. Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   {
       "repositoryNames": [
           "MyDemoRepo",
           "MyClonedRepo"
       ]
   }

Pour répertorier tous les modèles associés à un référentiel

1. Sur la ligne de commande ou le terminal, exécutez la commande list-associated-approval-rule-templates-for-repository en spécifiant le nom du référentiel :

   aws codecommit list-associated-approval-rule-templates-for-repository --repository-name MyDemoRepo

2. Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   {
       "approvalRuleTemplateNames": [
           "2-approver-rule-for-main",
           "1-approver-rule-for-all-pull-requests"
       ]
   }