Revisão de uma solicitação pull - Amazon CodeCatalyst

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á.

Revisão de uma solicitação pull

Você pode usar o CodeCatalyst console da Amazon para analisar e comentar de forma colaborativa as alterações incluídas em uma pull request. Você pode adicionar comentários a linhas individuais de código na diferença entre as ramificações de origem e de destino ou na diferença entre as revisões da solicitação pull. Você pode optar por criar um resumo dos comentários deixados sobre as alterações de código na solicitação pull para entender rapidamente os comentários deixados por outros usuários. Você também pode optar por criar um Ambiente de Desenvolvimento para trabalhar com o código.

nota
nota

Desenvolvido pelo Amazon Bedrock: AWS implementa a detecção automática de abusos. Como os recursos Escrever descrição para mim, Criar resumo do conteúdo, Recomendar tarefas, Usar o Amazon Q para criar ou adicionar recursos a um projeto e Atribuir problemas ao Amazon Q com os recursos do agente do Amazon Q Developer para desenvolvimento de software são baseados no Amazon Bedrock, os usuários podem aproveitar ao máximo os controles implementados no Amazon Bedrock para reforçar a segurança, a proteção e o uso responsável de inteligência artificial.

dica

Você pode configurar quais eventos de solicitação pull receberá e-mails como parte do seu perfil. Para obter mais informações, consulte Envio de notificações do Slack e por e-mail do CodeCatalyst.

As solicitações pull mostram qual será a diferença entre a revisão da solicitação pull e a confirmação que foi a ponta da ramificação de destino quando você criou a solicitação pull. Isso é chamado de base de mesclagem. Para obter mais informações sobre diferenças e bases de mesclagem no Git, git-merge-baseconsulte a documentação do Git.

dica

Ao trabalhar no console, especialmente se você tiver uma solicitação pull aberta há algum tempo, considere atualizar seu navegador para garantir que tenha a revisão mais recente disponível para uma solicitação pull antes de começar a revisá-la.

Para revisar uma pull request no CodeCatalyst console
  1. Navegue até o projeto.

  2. Navegue até as solicitações pull realizando uma das seguintes etapas:

    • Se a solicitação pull estiver listada na página do projeto, selecione-a na lista.

    • Se a solicitação pull não estiver listada na página do projeto, escolha Exibir tudo. Use os filtros e classifique para encontrar a solicitação pull e, depois, escolha-a na lista.

    • No painel de navegação, selecione Código e Solicitações pull.

  3. Escolha a solicitação pull que você deseja revisar na lista. Você pode filtrar a lista de solicitações pull digitando parte do nome na barra de filtro.

  4. Em Visão geral, você pode revisar o nome e o título da solicitação pull. Você pode criar e visualizar os comentários deixados na própria solicitação pull. Você também pode visualizar os detalhes da solicitação pull, incluindo informações sobre execuções de fluxo de trabalho, problemas vinculados, revisores, o autor da solicitação pull e estratégias de mesclagem viáveis.

    nota

    Os comentários deixados em linhas de código específicas aparecem em Alterações.

  5. (Opcional) Para adicionar um comentário que se aplique a toda a solicitação pull, expanda Comentários na solicitação pull e selecione Criar comentário.

  6. (Opcional) Para ver um resumo de todos os comentários deixados sobre as alterações nas revisões dessa solicitação pull, selecione Criar resumo de comentários.

    nota

    Essa funcionalidade exige que os recursos de IA generativa estejam habilitados para o espaço e só estejam disponíveis na região Oeste dos EUA (Oregon). Para ter mais informações, consulte Gerenciar recursos de IA generativa.

  7. Em Alterações, você pode ver as diferenças entre a ramificação de destino e a revisão mais recente da solicitação pull. Se houver mais de uma revisão, você poderá alterar quais revisões são comparadas na diferença entre elas. Para ter mais informações sobre revisões, consulte Revisões.

    dica

    Em Arquivos alterados, você pode ver rapidamente quantos arquivos têm alterações na solicitação pull e quais arquivos na solicitação pull têm comentários sobre eles. O número de comentários mostrados ao lado de uma pasta indica o número de comentários nos arquivos dessa pasta. Expanda a pasta para ver o número de comentários de cada arquivo na pasta.

  8. Para alterar a forma como as diferenças são exibidas, escolha entre Unificado e Dividido.

  9. Para adicionar um comentário a uma linha na solicitação pull, vá até a linha na qual deseja comentar. Escolha o ícone de comentário que é exibido para essa linha, insira um comentário e escolha Salvar.

  10. Para visualizar as alterações entre as revisões em uma solicitação pull ou entre suas ramificações de origem e destino, escolha entre as opções disponíveis em Comparação. Os comentários sobre as linhas nas revisões são preservados nessas revisões.

  11. Se você configurou seu fluxo de trabalho para gerar um relatório de cobertura de código sobre gatilhos de solicitação pull, você pode ver as descobertas de cobertura de linha e ramificação na solicitação pull relevante. Para ocultar as descobertas de cobertura de código, selecione Ocultar cobertura de código. Para obter mais informações, consulte Relatórios de cobertura de código.

  12. Se quiser fazer alterações no código da solicitação pull, você pode criar um Ambiente de Desenvolvimento a partir da solicitação pull. Escolha Criar ambiente de desenvolvimento. Se desejar, adicione um nome para o Ambiente de Desenvolvimento ou edite a configuração e selecione Criar.

  13. Em Relatórios, você pode visualizar os relatórios de qualidade nessa solicitação pull. Se houver mais de uma revisão, você poderá alterar quais revisões são comparadas na diferença entre elas. Você pode filtrar os relatórios por nome, status, fluxo de trabalho, ação e tipo.

    nota

    Um fluxo de trabalho deve ser configurado para gerar relatórios para que eles apareçam nas solicitações pull. Para obter mais informações, consulte Configuração de relatórios de qualidade em uma ação.

  14. Para ver um relatório específico, escolha-o na lista. Para obter mais informações, consulte Teste com fluxos de trabalho.

  15. Se você estiver listado como revisor dessa solicitação pull e quiser aprovar as alterações, verifique se está visualizando a revisão mais recente e selecione Aprovar.

    nota

    Todos os revisores obrigatórios devem aprovar uma solicitação pull antes que ela possa ser mesclada.