Créer une demande d'extraction

La création de demandes d'extraction permet aux autres utilisateurs de voir et de vérifier vos modifications de code avant de les fusionner dans une autre branche. Tout d'abord, vous devez créer une branche pour vos modifications de code. C'est ce que l'on appelle la branche source d'une demande d'extraction. Une fois que vous avez validé et envoyé ces modifications dans le référentiel, vous pouvez créer une demande d'extraction qui compare le contenu de cette branche (branche source) à la branche dans laquelle vous souhaitez fusionner vos modifications après la fermeture de la demande d'extraction (branche de destination).

Vous pouvez utiliser la console AWS CodeCommit ou l'AWS CLI pour créer les demandes d'extraction pour votre référentiel.

Créer une demande d'extraction (console)

Vous pouvez utiliser la console CodeCommit pour créer une pull request dans un référentiel CodeCommit. Si votre référentiel est configuré avec des notifications, les utilisateurs abonnés reçoivent un e-mail lorsque vous créez une demande d'extraction.

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

2. Dans Repositories (Référentiels), sélectionnez le nom du référentiel dans lequel vous voulez créer une demande d'extraction.

3. Dans le volet de navigation, choisissez Pull Requests.

   Astuce

   Vous pouvez également créer des demandes d'extractions depuis Branches et Code.

4. Choisissez Create pull request.

   

5. Dans la section Source de Create pull request, recherchez la branche qui contient les modifications que vous voulez faire vérifier.

6. Dans Destination, choisissez la branche dans laquelle vous prévoyez de fusionner vos modifications de code lorsque la demande d'extraction est fermée.

7. Choisissez Comparer. Une comparaison s'exécute sur les deux branches et les différences entre elles s'affichent. Une analyse est également effectuée pour déterminer si les deux branches peuvent être fusionnées automatiquement lors de la fermeture de la demande d'extraction.

8. Passez en revue les détails de la comparaison et les modifications pour vous assurer que la demande d'extraction contient les modifications et les validations que vous voulez faire vérifier. Si tel n'est pas le cas, ajustez vos choix pour les branches source et de destination, et choisissez Compare à nouveau.

9. Lorsque vous êtes satisfait des résultats de comparaison de la demande d'extraction, dans Titre, saisissez un titre court mais descriptif pour cette révision. Il s'agit du titre qui s'affiche dans la liste des demandes d'extraction pour le référentiel.

10. (Facultatif) Dans Description, saisissez les détails relatifs à la révision et toutes les autres informations utiles pour les réviseurs.

11. Sélectionnez Create (Créer) Application Load Balancer request count per target.

    

Votre demande d'extraction s'affiche dans la liste des demandes d'extraction du référentiel. Si vousnotifications configurées, les abonnés à la rubrique Amazon SNS reçoivent un e-mail les informant de la nouvelle demande d'extraction.

Créer une demande d'extraction (AWS CLI)

Pour utiliserAWS CLIavec CodeCommit, installez leAWS CLI. Pour plus d'informations, consultez Référence des commandes en ligne.

Pour utiliser le pluginAWS CLIpour créer une demande d'extraction dans un référentiel CodeCommit

1. Exécutez la commande create-pull-request en indiquant :

   • Le nom de la demande d'extraction (avec l'option --title).

   • La description de la demande d'extraction (avec l'option --description).

   • Une liste des cibles pour la commande create-pull-request, y compris :

     • Le nom du référentiel CodeCommit dans lequel la demande d'extraction est créée (avec lerepositoryNameattribut).

     • Le nom de la branche qui contient les modifications de code que vous voulez faire vérifier, également connue sous le nom de branche source (avec l'attribut sourceReference).

     • (Facultatif) Le nom de la branche dans laquelle vous prévoyez de fusionner vos modifications de code, également connue sous le nom de branche de destination, si vous ne souhaitez pas les fusionner dans la branche par défaut (avec l'attribut destinationReference).

   • Un jeton d'idempotence unique généré par le client (avec l'option --client-request-token).

   Cet exemple montre comment créer une demande d'extraction nommée Pronunciation difficulty analyzer avec la description Please review these changes by Tuesday qui cible la branche source jane-branch. La demande d'extraction doit être fusionnée dans la branche par défaut.principaldans un référentiel CodeCommit nomméMyDemoRepo :

   aws codecommit create-pull-request --title "Pronunciation difficulty analyzer" --description "Please review these changes by Tuesday" --client-request-token 123Example --targets repositoryName=MyDemoRepo,sourceReference=jane-branch 

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

   {
       "pullRequest": {
           "approvalRules": [
               {
                   "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
                   "approvalRuleId": "dd8b17fe-EXAMPLE",
                   "approvalRuleName": "2-approver-rule-for-main",
                   "creationDate": 1571356106.936,
                   "lastModifiedDate": 571356106.936,
                   "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
                   "originApprovalRuleTemplate": {
                       "approvalRuleTemplateId": "dd3d22fe-EXAMPLE",
                       "approvalRuleTemplateName": "2-approver-rule-for-main"
                   },
                   "ruleContentSha256": "4711b576EXAMPLE"
               }
           ],
           "authorArn": "arn:aws:iam::111111111111:user/Jane_Doe",
           "description": "Please review these changes by Tuesday",
           "title": "Pronunciation difficulty analyzer",
           "pullRequestTargets": [
               {
                   "destinationCommit": "5d036259EXAMPLE",
                   "destinationReference": "refs/heads/main",
                   "repositoryName": "MyDemoRepo",
                   "sourceCommit": "317f8570EXAMPLE",
                   "sourceReference": "refs/heads/jane-branch",
                   "mergeMetadata": {
                       "isMerged": false
                   }
               }
           ],
           "lastActivityDate": 1508962823.285,
           "pullRequestId": "42",
           "clientRequestToken": "123Example",
           "pullRequestStatus": "OPEN",
           "creationDate": 1508962823.285
       }
   }