A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

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

# Criar uma solicitação pull
<a name="pull-requests-create"></a>

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 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 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 obter mais informações sobre diferenças e bases de mesclagem no Git, [git-merge-base](https://git-scm.com/docs/git-merge-base)consulte a 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 Oeste dos EUA (Oregon) para CodeCatalyst pull requests. O recurso **Escrever descrição para mim** não está disponível para solicitações pull em repositórios vinculados.

**nota**  
**Desenvolvido pelo Amazon Bedrock**: AWS implementa a detecção [automática de abusos](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). 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.

1. 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**.

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

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

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

1. 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ê. 

1. (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 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 à 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](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 

1. (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.

1. (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. 

1. (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. 

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

1. 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. <a name="pull-requests-create-from-branch"></a>

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

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

1. 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**.

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

1. 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ê. 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 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.

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

1. (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.

1. (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.

1. (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. 

1. 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 obter mais informações, consulte [Adição de gatilhos aos fluxos de trabalho](workflows-add-trigger-add.md).