Criar uma solicitação pull - Amazon CodeCatalyst

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 as alterações para o repositório, você pode criar uma solicitação pull que compara o conteúdo da ramificação de origem com o conteúdo da ramificação de destino.

Você pode criar uma solicitação pull no console do Amazon CodeCatalyst a partir de uma ramificação específica, da página de solicitações pull ou da visão geral do projeto. A criação de uma solicitação pull a partir de uma ramificação específica fornece automaticamente o nome do repositório e a ramificação de origem na página de criação da solicitação pull. Ao criar uma solicitação pull, você receberá automaticamente e-mails sobre quaisquer atualizações na solicitação pull, bem como quando a solicitação pull for mesclada ou fechada.

nota

Enquanto você cria uma solicitação pull, a diferença exibida é a diferença entre a ponta da ramificação de origem e a ponta da ramificação de destino. Depois que a solicitação pull for criada, a diferença exibida será entre a revisão da solicitação pull escolhida e a confirmação que foi a ponta da ramificação de destino quando você criou a solicitação pull. Para ter mais informações sobre diferenças e bases de mesclagem no Git, consulte git-merge-base na documentação do Git.

Você pode usar o recurso Escrever descrição para mim ao criar solicitações pull para que o Amazon Q crie automaticamente uma descrição das alterações contidas em uma solicitação pull. Quando você escolhe essa opção, o Amazon Q analisa as diferenças entre a ramificação de origem que contém as alterações de código e a ramificação de destino na qual você deseja mesclar essas alterações. Em seguida, ele cria um resumo dessas alterações, bem como sua melhor interpretação da intenção e do efeito dessas alterações. Esse recurso está disponível somente na região do Oeste dos EUA (Oregon) para as solicitações pull do CodeCatalyst. O recurso Escrever descrição para mim não está disponível para solicitações pull em repositórios vinculados.

nota
nota

Tecnologia da Amazon Bedrock: a 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.

Para criar uma solicitação pull

  1. Navegue até o projeto.

  2. Execute um destes procedimentos:

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

    • Na página inicial do repositório, escolha Mais e, depois, selecione Criar solicitação pull.

    • Na página do projeto, selecione Criar solicitação pull.

  3. No Repositório de origem, certifique-se de que o repositório de origem especificado seja aquele que contém o código confirmado. Essa opção só aparece se você não criou a solicitação pull na página principal do repositório.

  4. Em Ramificação de destino, selecione a ramificação na qual mesclar o código depois que ele for revisado.

  5. Em Ramificação de origem, selecione a ramificação que contém o código confirmado.

  6. Em Título da solicitação pull, insira um título que ajude outros usuários a entender o que precisa ser revisado e por quê.

  7. (Opcional) Na Descrição da solicitação pull, forneça informações, como um link para problemas ou uma descrição das alterações.

    dica

    Você pode selecionar Escrever descrição para mim para que o CodeCatalyst gere automaticamente uma descrição das alterações contidas na solicitação pull. Você pode fazer alterações na descrição gerada automaticamente depois de adicioná-la à solicitação pull.

    Essa funcionalidade exige que os recursos de IA generativa estejam habilitados para o espaço e não estejam disponíveis para solicitações pull em repositórios vinculados. Para ter mais informações, consulte Gerenciar recursos de IA generativa.

  8. (Opcional) Em Problemas, selecione Vincular problemas e, depois, selecione um problema na lista ou insira seu ID. Para desvincular um problema, selecione o ícone de desvinculação.

  9. (Opcional) Em Revisores obrigatórios, selecione Adicionar revisores obrigatórios. Selecione na lista de membros do projeto para adicioná-los. Os revisores obrigatórios devem aprovar as alterações antes que a solicitação pull seja mesclada na ramificação de destino.

    nota

    Não é possível adicionar um revisor como revisor obrigatório e revisor opcional. Não é possível se adicionar como revisor.

  10. (Opcional) Em Revisores opcionais, selecione Adicionar revisores opcionais. Selecione na lista de membros do projeto para adicioná-los. Revisores opcionais não precisam aprovar as alterações como um requisito antes que a solicitação pull seja mesclada na ramificação de destino.

  11. Revise as diferenças entre as ramificações. A diferença exibida em uma solicitação pull são as alterações entre a revisão na ramificação de origem e a base de mesclagem, que é a confirmação principal da ramificação de destino no momento em que a solicitação pull foi criada. Se nenhuma alteração for exibida, as ramificações podem ser idênticas ou você pode ter escolhido a mesma ramificação para a origem e o destino.

  12. Quando a solicitação pull tiver o código e as alterações que você deseja revisar, selecione Criar.

    nota

    Depois que você criar a solicitação pull, poderá adicionar comentários. Os comentários podem ser adicionados à solicitação pull ou a linhas individuais em arquivos, bem como à solicitação pull geral. Você pode adicionar links para recursos, como arquivos, usando o sinal @ seguido pelo nome do arquivo.

Como criar uma solicitação pull a partir de uma ramificação

  1. Navegue até o projeto onde você deseja criar uma solicitação pull.

  2. No painel de navegação, selecione Repositórios de origem e, depois, escolha o repositório que contém a ramificação em que você tem alterações de código a serem revisadas.

  3. Escolha a seta suspensa ao lado do nome da ramificação padrão e, depois, escolha a ramificação desejada na lista. Para visualizar todas as ramificações de um repositório, selecione Visualizar tudo.

  4. Selecione Mais e, depois, Criar solicitação pull.

  5. O repositório e a ramificação de origem estão pré-selecionados. Em Ramificação de destino, escolha a ramificação na qual você mesclará o código depois que ele for revisado. Em Título da solicitação pull, insira um título que ajudará outros usuários do projeto a entender o que deve ser revisado e por quê. Se desejar, forneça mais informações na Descrição da solicitação pull, como colar um link para problemas relacionados no CodeCatalyst ou adicionar uma descrição das alterações feitas.

    nota

    Os fluxos de trabalho configurados para serem executados em eventos de criação de solicitação pull serão executados após a criação da solicitação pull, se a ramificação de destino da solicitação pull corresponder a uma das ramificações especificadas no fluxo de trabalho.

  6. Revise as diferenças entre as ramificações. Se nenhuma alteração for exibida, as ramificações podem ser idênticas ou você pode ter escolhido a mesma ramificação para a origem e o destino.

  7. (Opcional) Em Problemas, selecione Vincular problemas e, depois, selecione um problema na lista ou insira seu ID. Para desvincular um problema, selecione o ícone de desvinculação.

  8. (Opcional) Em Revisores obrigatórios, selecione Adicionar revisores obrigatórios. Selecione na lista de membros do projeto para adicioná-los. Os revisores obrigatórios devem aprovar as alterações antes que a solicitação pull seja mesclada na ramificação de destino.

    nota

    Você não pode adicionar um revisor tanto como obrigatório quanto opcional. Não é possível se adicionar como revisor.

  9. (Opcional) Em Revisores opcionais, selecione Adicionar revisores opcionais. Selecione na lista de membros do projeto para adicioná-los. Revisores opcionais não precisam aprovar as alterações antes que a solicitação pull seja mesclada na ramificação de destino.

  10. Quando a solicitação pull tiver as alterações que você deseja revisar e incluir os revisores obrigatórios, selecione Criar.

Se você tiver algum fluxo de trabalho configurado para execução em que a ramificação corresponda à ramificação de destino na solicitação pull, verá informações sobre essas execuções de fluxo de trabalho em Visão geral na área Detalhes da solicitação pull após a criação da solicitação pull. Para ter mais informações, consulte Adição de gatilhos aos fluxos de trabalho.