Criação de 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 pull request que compara o conteúdo da ramificação de origem com o conteúdo da ramificação de destino.

Você pode criar uma pull request no CodeCatalyst console da Amazon a partir de uma ramificação específica, da página de pull requests ou da visão geral do projeto. A criação de uma pull request 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 pull request. Ao criar uma pull request, você receberá automaticamente e-mails sobre quaisquer atualizações na pull request, bem como quando a pull request for mesclada ou fechada.

nota

Enquanto você cria uma pull request, 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 pull request for criada, a diferença exibida será entre a revisão da pull request escolhida e o commit que foi a ponta da ramificação de destino quando você criou a pull request. Para obter mais informações sobre diferenças e bases de mesclagem no Git, git-merge-baseconsulte a documentação do Git.

Você pode usar o recurso Write description for me ao criar pull requests para que o Amazon Q crie automaticamente uma descrição das alterações contidas em um pull request. 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 filial de destino na qual você deseja mesclar essas alterações. Em seguida, ele cria um resumo do que são essas mudanças, bem como sua melhor interpretação da intenção e do efeito dessas mudanças. Esse recurso está disponível somente na região Oeste dos EUA (Oregon) para CodeCatalyst pull requests. O recurso Escrever descrição para mim não está disponível para pull requests em repositórios vinculados.

nota

Desenvolvido pelo Amazon Bedrock: AWS implementa a detecção automática de abusos. Como os recursos Write description for me e Create content summary foram criados no Amazon Bedrock, os usuários podem aproveitar ao máximo os controles implementados no Amazon Bedrock para reforçar a segurança e o uso responsável da inteligência artificial (IA).

Para criar uma pull request

1. Navegue até o projeto.

2. Execute um destes procedimentos:

   • No painel de navegação, escolha Código, escolha Pull requests e, em seguida, escolha Create pull request.

   • Na página inicial do repositório, escolha Mais e, em seguida, escolha Criar pull request.

   • Na página do projeto, escolha Criar pull request.

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 pull request na página principal do repositório.

4. Em Agência de destino, escolha a ramificação na qual mesclar o código depois que ele for revisado.

5. Na ramificação de origem, escolha a ramificação que contém o código confirmado.

6. Em Título do pull request, 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 pull request, forneça informações como um link para problemas ou uma descrição de suas alterações.

   dica

   Você pode escolher Escrever descrição para mim para gerar CodeCatalyst automaticamente uma descrição das alterações contidas na pull request. Você pode fazer alterações na descrição gerada automaticamente depois de adicioná-la ao pull request.

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

8. (Opcional) Em Problemas, escolha Vincular problemas e, em seguida, escolha um problema na lista ou insira sua ID. Para desvincular um problema, escolha o ícone de desvinculação.

9. (Opcional) Em Revisores obrigatórios, escolha Adicionar revisores obrigatórios. Escolha na lista de membros do projeto para adicioná-los. Os revisores obrigatórios devem aprovar as alterações antes que o pull request possa ser mesclado na ramificação de destino.

   nota

   Você não pode adicionar um revisor como revisor obrigatório e como revisor opcional. Você não pode se adicionar como revisor.

10. (Opcional) Em Revisores opcionais, escolha Adicionar revisores opcionais. Escolha na lista de membros do projeto para adicioná-los. Os revisores opcionais não precisam aprovar as alterações como um requisito para que a pull request possa ser incorporada à ramificação de destino.

11. Analise as diferenças entre as filiais. A diferença exibida em uma pull request 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 pull request 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 você estiver convencido de que a pull request contém o código e as alterações que você deseja revisar, escolha Criar.

    nota

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

Para criar uma pull request a partir de uma ramificação

1. Navegue até o projeto em que você deseja criar uma pull request.

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

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

4. Escolha Mais e, em seguida, escolha Criar pull request.

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

   nota

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

6. Analise as diferenças entre as filiais. 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, escolha Vincular problemas e, em seguida, escolha um problema na lista ou insira sua ID. Para desvincular um problema, escolha o ícone de desvinculação.

8. (Opcional) Em Revisores obrigatórios, escolha Adicionar revisores obrigatórios. Escolha na lista de membros do projeto para adicioná-los. Os revisores obrigatórios devem aprovar as alterações antes que o pull request possa ser mesclado na ramificação de destino.

   nota

   Você não pode adicionar um revisor tanto como obrigatório quanto opcional. Você não pode se adicionar como revisor.

9. (Opcional) Em Revisores opcionais, escolha Adicionar revisores opcionais. Escolha na lista de membros do projeto para adicioná-los. Os revisores opcionais não precisam aprovar as alterações antes que a pull request possa ser mesclada na ramificação de destino.

10. Quando você estiver convencido de que a pull request contém as alterações que você deseja revisar e inclui os revisores necessários, escolha Criar.

Se você tiver algum fluxo de trabalho configurado para execução em que a ramificação corresponda à ramificação de destino na pull request, você verá informações sobre essas execuções de fluxo de trabalho em Visão geral na área de detalhes da pull request após a criação da pull request. Para ter mais informações, consulte Adicionar um gatilho push, pull ou scheduler.