Creazione di una richiesta di pull

La creazione di richieste pull aiuta altri utenti a vedere ed esaminare le modifiche del codice prima di unirle in un altro ramo. In primo luogo, è necessario creare un ramo per le modifiche del codice che viene definito come il ramo di origine della richiesta pull. Dopo aver eseguito il commit e il push delle modifiche al repository, è possibile creare una richiesta pull che confronta il contenuto di quel ramo (ramo di origine) con il ramo in cui si desidera unire le modifiche dopo la chiusura della richiesta pull (ramo di destinazione).

È possibile utilizzare la AWS CodeCommit console o AWS CLI creare richieste pull per il repository.

Crea una pull request (console)

È possibile utilizzare la CodeCommit console per creare una richiesta pull in un CodeCommit repository. Se il repository viene configurato con le notifiche, gli utenti iscritti riceveranno un'e-mail quando crei una richiesta di pull.

1. Apri la CodeCommit console su https://console.aws.amazon.com/codesuite/codecommit/home.

2. In Repositories (Repository), selezionare il nome del repository in cui si desidera creare una richiesta pull.

3. Nel riquadro di navigazione, selezionare Pull Requests (Richieste pull).

   Suggerimento

   È anche possibile creare richieste pull da Branches (Rami) e Code (Codice).

4. Scegliere Create pull request (Crea richiesta pull).

   

5. In Create pull request (Crea richiesta di pull), in Source (Origine), scegliere il ramo che contiene le modifiche da far esaminare.

6. In Destinazione, scegli il ramo in cui intendi unire le modifiche al codice quando la pull request viene chiusa.

7. Scegliere Compare (Confronta). Viene eseguito un confronto sui due rami e vengono visualizzate le differenze. Viene inoltre eseguita un'analisi per determinare se i due rami possono essere uniti automaticamente quando viene chiusa la richiesta pull.

8. Esaminare i dettagli del confronto e le modifiche per essere sicuri che la richiesta pull contenga le modifiche e i commit desiderati. In caso contrario, modificare le opzioni per i rami di origine e di destinazione e scegliere di nuovo Compare (Confronta).

9. Quando i risultati del confronto per la richiesta pull sono soddisfacenti, immettere in Title (Titolo) un titolo breve ma descrittivo per questa revisione. Questo è il titolo che viene visualizzato nell'elenco di richieste pull per il repository.

10. (Facoltativo) In Description (Descrizione), immettere i dettagli su questa revisione ed eventuali altre informazioni utili per i revisori.

11. Scegli Create (Crea) .

    

La richiesta di pull viene visualizzata nell'elenco di richieste pull per il repository. Se hai configurato le notifiche, gli abbonati all'argomento Amazon SNS ricevono un'e-mail per informarli della richiesta pull appena creata.

Crea una pull request ()AWS CLI

Per utilizzare AWS CLI i comandi con CodeCommit, installa AWS CLI. Per ulteriori informazioni, consulta Guida di riferimento alla riga di comando.

Da utilizzare AWS CLI per creare una richiesta pull in un CodeCommit repository

1. Eseguire il comando create-pull-request specificando:

   • Il nome della richiesta pull (con l'opzione --title).

   • La descrizione della richiesta pull (con l'opzione --description).

   • Un elenco di destinazioni per il comando create-pull-request, tra cui:

     • Il nome del CodeCommit repository in cui viene creata la pull request (con l'repositoryNameattributo).

     • Il nome del ramo che contiene le modifiche del codice che si desidera esaminare, noto anche come ramo di origine (con l'attributo sourceReference).

     • (Facoltativo) Il nome del ramo in cui si intende unire le modifiche al codice, noto anche come il ramo di destinazione, se non si desidera unire al ramo predefinito (con l'attributo destinationReference).

   • Un token di idempotenza univoco generato dal client (con l'opzione --client-request-token).

   Questo esempio crea una pull request denominata Pronunciation difficulty analyzer con una descrizione Please review these changes by Tuesday che si rivolge al ramo di jane-branch origine. La pull request deve essere unita al ramo predefinito main in un CodeCommit repository denominato: 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. Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

   {
       "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
       }
   }