Criar uma solicitação pull

A criação de solicitações pull ajuda outros usuários a ver e revisar suas alterações de código antes de mesclá-las em outra ramificação. Primeiro, você cria uma ramificação para suas alterações de código. Ela é chamada de ramificação de origem para uma solicitação pull. Depois de confirmar e enviar alterações para o repositório, você pode criar uma solicitação pull que compara o conteúdo dessa ramificação (a ramificação de origem) com a ramificação em que deseja mesclar suas alterações após a solicitação pull ser fechada (a ramificação de destino).

Você pode usar o console do AWS CodeCommit ou o AWS CLI para criar solicitações de extração para o repositório.

Criar uma solicitação pull (console)

Você pode usar o console do CodeCommit para criar uma solicitação pull em um repositório do CodeCommit. Se o seu repositório estiver configurado com notificações, os usuários inscritos receberão um e-mail quando você criar uma solicitação pull.

1. Abra o console do CodeCommit em https://console.aws.amazon.com/codesuite/codecommit/home.

2. Em Repositories (Repositórios), escolha o nome do repositório onde você deseja criar uma solicitação pull.

3. No painel de navegação, escolha Pull Requests.

   dica

   Você também pode criar solicitações pull em Branches (Ramificações) e em Code (Código).

4. Escolha Create pull request.

   

5. Em Create pull request, em Source, escolha a ramificação que contém as alterações que deseja revisar.

6. Em Destination (Destino), escolha a ramificação na qual você pretende mesclar suas alterações de código quando a solicitação pull for fechada.

7. Escolha Compare. Uma comparação é executada nas duas ramificações, e as diferenças entre elas são exibidas. Uma análise também é realizada para determinar se as duas ramificações podem ser mescladas automaticamente quando a solicitação pull é fechada.

8. Analise os detalhes da comparação e as alterações para se certificar de que a solicitação pull contém as alterações e confirmações que você deseja analisar. Caso contrário, ajuste suas escolhas para as ramificações de origem e de destino e escolha Compare novamente.

9. Quando estiver satisfeito com os resultados da comparação para a solicitação pull, em Title (Título), forneça um título curto, mas descritivo, para essa revisão. Este é o título que aparece na lista de solicitações pull para o repositório.

10. (Opcional) Em Description (Descrição), insira os detalhes sobre essa análise e qualquer outra informação útil para os revisores.

11. Escolha Create (Criar).

    

Sua solicitação pull aparece na lista de solicitações pull para o repositório. Se você configurou notificações, os assinantes do tópico do Amazon SNS receberão um e-mail informando sobre a solicitação pull recém-criada.

Criar uma solicitação pull (AWS CLI)

Para usar comandos da AWS CLI com o CodeCommit, instale a AWS CLI. Para obter mais informações, consulte Referência da linha de comando.

Para usar a AWS CLI para criar solicitações pull em um repositório do CodeCommit

1. Execute o comando create-pull-request, especificando:

   • O nome da solicitação pull (com a opção --title).

   • A descrição da solicitação pull (com a opção --description).

   • Uma lista de destinos para o comando create-pull-request, incluindo:

     • O nome do repositório do CodeCommit em que a solicitação pull foi criada (com o atributo repositoryName).

     • O nome da ramificação que contém as alterações de código que você deseja analisar, também conhecida como ramificação de origem (com o atributo sourceReference).

     • Opcionalmente, o nome da ramificação na qual você pretende mesclar suas alterações de código, também conhecida como a ramificação de destino, se você não quiser mesclar a ramificação padrão (com o atributo destinationReference).

   • Um token de idempotência exclusivo gerado pelo cliente (com a opção --client-request-token).

   Este exemplo cria uma solicitação pull chamada Pronunciation difficulty analyzer (Analisador de dificuldade de pronúncia) com uma descrição Please review these changes by Tuesday (Revise essas alterações até terça-feira) que tem como destino a ramificação de origem jane-branch. A solicitação pull deve ser mesclada com a ramificação padrão principal em um repositório do CodeCommit chamado 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 houver êxito, o comando gerará uma saída semelhante à seguinte:

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