Revisar uma solicitação pull - AWS CodeCommit
Revisar uma solicitação pull (console)Revisar solicitações pull (AWS CLI)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Revisar uma solicitação pull

Você pode usar o console do AWS CodeCommit para rever as alterações incluídas em uma solicitação de extração. Você pode adicionar comentários à solicitação, aos arquivos e a linhas de código individuais. Você também pode responder aos comentários feitos por outros usuários. Se o seu repositório estiver configurado com notificações, você receberá e-mails quando os usuários responderem aos seus comentários ou quando eles comentarem em uma solicitação pull.

Você pode usar o AWS CLI para comentar em uma solicitação pull e responder aos comentários. Para revisar as alterações, é necessário usar o console do CodeCommit, o comando git diff ou uma ferramenta diferente.

Revisar uma solicitação pull (console)

Você pode usar o console do CodeCommit para criar uma solicitação pull em um repositório do CodeCommit.

  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.

  3. No painel de navegação, escolha Pull Requests (Solicitações pull).

  4. Por padrão, é exibida uma lista de todas as solicitações de extração abertas. Escolha a solicitação pull aberta que você deseja analisar.

    Abrir solicitações pull exibidas no console do CodeCommit.
    nota

    É possível comentar sobre uma solicitação pull fechada ou mesclada, mas não mesclá-la ou reabri-la.

  5. Na solicitação pull, escolha Changes.

  6. Execute um destes procedimentos:

    • Para adicionar um comentário geral para toda a solicitação pull, em Comments on changes (Comentários sobre alterações), escolha New comment (Novo comentário), insira um comentário e escolha Save (Salvar). Você pode usar Markdown ou inserir seu comentário em texto simples.

      Um comentário geral sobre as alterações em uma solicitação pull.

    • Para adicionar um comentário a um arquivo na confirmação, em Changes, encontre o nome do arquivo. Escolha o ícone de comentário The comment bubble icon that that indicates that you can leave a comment on that line of code. que é exibido ao lado do nome do arquivo, insira um comentário e escolha Save (Salvar).

      Adicionar um comentário em um arquivo em uma solicitação pull.

    • Para adicionar um comentário a uma linha alterada na solicitação pull, em Changes, vá até a linha na qual deseja comentar. Escolha o ícone de comentário The comment bubble icon that that indicates that you can leave a comment on that line of code. que é exibido para essa linha, insira um comentário e escolha Save (Salvar).

      Adicionar um comentário em um linha em uma solicitação pull.

  7. Para responder a comentários em uma confirmação, em Changes ou Activity, escolha Reply. Você pode responder com texto e emojis.

    Adicionar respostas e reações de emoji a um comentário.

    Você pode ver os nomes das pessoas que responderam com uma reação de emoji específica selecionando essa reação. Para ver todas as reações de emojis e informações sobre quem respondeu com quais emojis, escolha Exibir todas as reações. Se você respondeu com um emoji a um comentário, sua resposta é mostrada no ícone do botão de reação de emoji.

    nota

    As contagens de reações exibidas no console são precisas no momento em que a página foi carregada. Para obter as informações mais atuais sobre a contagem de reações de emojis, atualize a página ou selecione Exibir todas as reações.

    Visualização de informações sobre usuários que responderam a um comentário com uma reação de emoji.

  8. (Opcional) Para responder a uma recomendação criada pelo Amazon CodeGuru Reviewer, incluindo fornecer feedback sobre a qualidade da recomendação, escolha Responder. Use os botões de reação para fornecer informações gerais sobre se você aprova ou não a recomendação. Use o campo de comentário para fornecer mais detalhes sobre sua reação.

    nota

    O Amazon CodeGuru Reviewer é um serviço automatizado de revisão de código que usa análise de programas e machine learning para detectar problemas comuns e recomendar correções em seu código Java ou Python.

    • Você só visualizará comentários do Amazon CodeGuru Reviewer se associou o repositório com o Amazon CodeGuru Reviewer, se a análise estiver concluída e se o código na solicitação pull for código Java ou Python. Para obter mais informações, consulte Associar ou desassociar um AWS CodeCommit repositório com o Amazon Reviewer CodeGuru .

    • Os comentários do Amazon CodeGuru Reviewer só aparecem na guia Alterações se tiverem sido feitos na revisão mais recente da solicitação pull. Eles sempre aparecem na guia Atividade.

    • Embora você possa responder às recomendações do Amazon CodeGuru Reviewer com qualquer uma das reações de emoji disponíveis, somente as reações de emoji com polegar para cima e para baixo são usadas para avaliar a utilidade da recomendação.

    Uma recomendação criada pelo Amazon CodeGuru Reviewer com um trabalho de revisão em andamento.

  9. Para aprovar as alterações feitas em uma solicitação pull, escolha Approve (Aprovar).

    nota

    Não é possível aprovar uma solicitação pull que você criou.

    É possível exibir aprovações, regras de aprovação e uma solicitação pull e regras de aprovação criadas por modelos de regra de aprovação em Approvals (Aprovações). Se você decidir que não deseja aprovar a solicitação pull, será possível escolher Revoke approval (Revogar aprovação).

    nota

    É possível aprovar ou revogar a aprovação somente em uma solicitação pull aberta. Não é possível aprovar ou revogar a aprovação em uma solicitação pull cujo status seja mesclado ou fechado.

    Aprovações e regras de aprovação em uma solicitação pull.

Revisar solicitações 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.

Você pode revisar as solicitações pull com os seguintes comandos da AWS CLI:

Você também pode usar emojis com comentários em uma solicitação pull com os seguintes comandos:

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

  1. Para adicionar um comentário a uma solicitação pull em um repositório, execute o comando post-comment-for-pull-request, especificando:

    • O ID da solicitação pull (com a opção --pull-request-id).

    • O nome do repositório que contém a solicitação pull (com a opção --repository-name).

    • O ID de confirmação completo da confirmação na ramificação de destino onde a solicitação de extração é mesclada (com a opção --before-commit-id).

    • O ID de confirmação completo da confirmação na ramificação de origem que é a ponta atual da ramificação atual para a solicitação pull quando você publica o comentário (com a opção --after-commit-id).

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

    • O conteúdo do seu comentário (com a opção --content).

    • Uma lista de informações de localização sobre onde colocar o comentário, incluindo:

      • O nome do arquivo que está sendo comparado, incluindo sua extensão e subdiretório, se houver (com o atributo filePath).

      • O número da linha da alteração em um arquivo comparado (com o atributo filePosition).

      • Se o comentário sobre a alteração estiver "antes" ou "depois" na comparação entre as ramificações de origem e destino (com o atributo relativeFileVersion).

    Por exemplo, use esse comando para adicionar o comentário "Não parecem ser usados em nenhum outro lugar. Podemos removê-los?" na alteração no arquivo ahs_count.py em uma solicitação pull com o ID 47 em um repositório denominado MyDemoRepo.

    aws codecommit post-comment-for-pull-request --pull-request-id "47" --repository-name MyDemoRepo --before-commit-id 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE --client-request-token 123Example --content "These don't appear to be used anywhere. Can we remove them?" --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER

    Se houver êxito, o comando gerará uma saída semelhante à seguinte.

    { 
         "afterBlobId": "1f330709EXAMPLE",
         "afterCommitId": "5d036259EXAMPLE",
         "beforeBlobId": "80906a4cEXAMPLE",
         "beforeCommitId": "317f8570EXAMPLE",
         "comment": {
               "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar",
               "clientRequestToken": "123Example",
               "commentId": "abcd1234EXAMPLEb5678efgh",
               "content": "These don't appear to be used anywhere. Can we remove them?",
               "creationDate": 1508369622.123,
               "deleted": false,
               "lastModifiedDate": 1508369622.123,
               "callerReactions": [],
               "reactionCounts": []
            }
             "location": { 
               "filePath": "ahs_count.py",
               "filePosition": 367,
               "relativeFileVersion": "AFTER"
             },
         "repositoryName": "MyDemoRepo",
         "pullRequestId": "47"
 }

  2. Para exibir comentários de uma solicitação de pull, execute o comando get-comments-for-pull-request, especificando:

    • O nome do repositório do CodeCommit (com a opção --repository-name).

    • O ID gerado pelo sistema da solicitação pull (com a opção --pull-request-id).

    • (Opcional) Um token de enumeração para retornar o lote seguintes de resultados (com a opção --next-token).

    • (Opcional) Um inteiro não negativo no número de resultados retornados (com a opção --max-results).

    Por exemplo, use esse comando para visualizar comentários de uma solicitação pull com um ID 42.

    aws codecommit get-comments-for-pull-request --pull-request-id 42

    Se houver êxito, o comando gerará uma saída semelhante à seguinte.

    {
   "commentsForPullRequestData": [ 
      { 
         "afterBlobId": "1f330709EXAMPLE",
         "afterCommitId": "5d036259EXAMPLE",
         "beforeBlobId": "80906a4cEXAMPLE",
         "beforeCommitId": "317f8570EXAMPLE",
         "comments": [ 
            { 
               "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar",
               "clientRequestToken": "",
               "commentId": "abcd1234EXAMPLEb5678efgh",
               "content": "These don't appear to be used anywhere. Can we remove them?",
               "creationDate": 1508369622.123,
               "deleted": false,
               "lastModifiedDate": 1508369622.123,
               "callerReactions": [],
               "reactionCounts": 
                {
                  "THUMBSUP" : 6,
                  "CONFUSED" : 1
                }
            },
            {
               "authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
               "clientRequestToken": "",
               "commentId": "442b498bEXAMPLE5756813",
               "content": "Good catch. I'll remove them.",
               "creationDate": 1508369829.104,
               "deleted": false,
               "lastModifiedDate": 150836912.273,
               "callerReactions": ["THUMBSUP"]
               "reactionCounts": 
                {
                  "THUMBSUP" : 14
                }
             }
         ],
         "location": { 
            "filePath": "ahs_count.py",
            "filePosition": 367,
            "relativeFileVersion": "AFTER"
         },
         "repositoryName": "MyDemoRepo",
         "pullRequestId": "42"
      }
   ],
   "nextToken": "exampleToken"
}

  3. Para aprovar ou revogar a aprovação de uma solicitação pull, execute o comando update-pull-request-approval-state, especificando:

    • O ID da solicitação pull (usando a opção --pull-request-id).

    • O ID de revisão da solicitação pull (usando a --revision-id option). É possível obter o ID de revisão atual para uma solicitação pull usando o comando get-pull-request.

    • O estado de aprovação que você deseja aplicar (usando a opção --approval-state). Os estados de aprovação válidos incluem APPROVE e REVOKE.

    Por exemplo, use esse comando para aprovar uma solicitação pull com o ID 27 e um ID de revisão 9f29d167EXAMPLE.

    aws codecommit update-pull-request-approval-state --pull-request-id 27 --revision-id 9f29d167EXAMPLE --approval-state "APPROVE"

    Se houver êxito, o comando não retornará nada.

  4. Para enviar uma resposta a um comentário em uma solicitação pull, execute o comando post-comment-reply, especificando:

    • O ID gerado pelo sistema do comentário ao qual você deseja responder (com a opção --in-reply-to).

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

    • O conteúdo do sua resposta (com a opção --content).

    Por exemplo, use esse comando para adicionar a resposta "Boa observação. Serão removidos." ao comentário com o ID gerado pelo sistema abcd1234EXAMPLEb5678efgh. 

    aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example

    Se houver êxito, o comando gerará uma saída semelhante à seguinte.

    { 
    "comment": {
        "authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
        "clientRequestToken": "123Example",
        "commentId": "442b498bEXAMPLE5756813",
        "content": "Good catch. I'll remove them.",
        "creationDate": 1508369829.136,
        "deleted": false,
        "lastModifiedDate": 150836912.221,
        "callerReactions": [],
        "reactionCounts": []
    }
 }