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

# Análise de código com pull requests na Amazon CodeCatalyst
<a name="source-pull-requests"></a>

Uma solicitação pull é a principal maneira para você e outros membros do projeto revisarem, comentarem e mesclarem alterações de código de uma ramificação para outra. Você pode usar solicitações pull para revisar alterações de código de maneira colaborativa em caso de alterações ou correções relativamente pequenas, adições significativas de recursos ou novas versões do seu software lançado. Se você usar problemas para rastrear o trabalho em seu projeto, poderá vincular problemas específicos a solicitações pull para ajudar a rastrear quais problemas estão sendo resolvidos pelas alterações de código na solicitação pull. Quando você cria, atualiza, comenta, mescla ou fecha uma solicitação pull, um e-mail é enviado automaticamente para o autor da solicitação pull, bem como para todos os revisores obrigatórios ou opcionais da solicitação pull.

**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](notifications-manage.md).

As solicitações pull exigem duas ramificações em um repositório de origem: uma ramificação de origem que contém o código que você deseja revisar e uma ramificação de destino, onde você deseja mesclar o código revisado. A ramificação de origem contém a confirmação AFTER, que é a confirmação que contém as alterações que você deseja mesclar na ramificação de destino. A ramificação de destino contém a confirmação BEFORE, que representa o estado do código (antes de a ramificação da solicitação pull ser mesclada à ramificação de destino). 

**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 de criar a solicitação pull, 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.

Enquanto uma solicitação pull é criada para um repositório de origem e ramificações específicas, você pode criá-las, visualizá-las, revisá-las e fechá-las como parte do trabalho com seu projeto. Você não precisa visualizar o repositório de origem para visualizar e trabalhar com solicitações pull. Um estado de solicitação pull é definido como **Aberto** ao criá-lo. **A pull request permanece aberta até que você a mescle no CodeCatalyst console, o que muda o estado para **Mesclado**, ou a feche, o que altera o estado para Fechado.**

Quando seu código for revisado, você poderá alterar o estado da solicitação pull de várias maneiras: 
+ Mescle o pull request no CodeCatalyst console. O código na ramificação de origem da solicitação pull será mesclado na ramificação de destino. O status da solicitação pull mudará para **Mesclado**. Ele não pode ser alterado de volta para **Aberto**.
+ Mescle as ramificações localmente, envie suas alterações e, em seguida, feche a pull request no CodeCatalyst console.
+ Use o CodeCatalyst console para fechar a pull request sem mesclar. Isso mudará o status para **Fechado** e não mesclará o código da ramificação de origem com a ramificação de destino.

Antes de criar uma solicitação pull:
+ Confirme e envie as alterações de código que você deseja revisar para uma ramificação (a ramificação de origem).
+ Configure notificações para seu projeto para que outros usuários possam ser notificados sobre quaisquer fluxos de trabalho executados quando você cria uma solicitação pull. (Esta etapa é opcional, mas recomendada.)

**Topics**
+ [Criar uma solicitação pull](pull-requests-create.md)
+ [Visualizar solicitações pull](pull-requests-view.md)
+ [Gerenciamento de requisitos para mesclar uma solicitação pull com regras de aprovação](source-pull-requests-approval-rules.md)
+ [Revisão de uma solicitação pull](pull-requests-review.md)
+ [Atualizar uma solicitação pull](pull-requests-update.md)
+ [Mesclar uma solicitação pull](pull-requests-merge.md)
+ [Encerrar uma solicitação pull](pull-requests-close.md)

# 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).

# Visualizar solicitações pull
<a name="pull-requests-view"></a>

Você pode visualizar pull requests para um projeto no CodeCatalyst console da Amazon. A página de resumo do projeto exibe todas as solicitações pull abertas para um projeto. Para ver todas as solicitações pull, independentemente do estado, navegue até a página de solicitações pull do projeto. Ao visualizar uma solicitação pull, você pode optar por ter um resumo de todos os comentários deixados sobre as alterações na solicitação pull criada para você.

**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.<a name="pull-requests-view-open-project"></a>

**Para visualizar solicitações pull abertas**

1. Navegue até o projeto em que deseja visualizar solicitações pull.

1. Na página do projeto, as solicitações pull abertas são exibidas, incluindo informações sobre quem criou a solicitação pull, qual repositório contém as ramificações da solicitação pull e a data em que a solicitação pull foi criada. Você pode filtrar a visualização da solicitação pull aberta por repositório de origem.

1. Para ver todas as solicitações pull, selecione **Exibir tudo**. Você pode usar os seletores para escolher entre as opções. Por exemplo, para ver todas as solicitações pull, selecione **Qualquer status** e **Qualquer autor**. 

   Como alternativa, no painel de navegação, selecione **Código** e **Solicitações pull** e use os seletores para refinar a visualização.

1. Na página **Solicitações pull**, você pode classificar as solicitações pull por ID, título, status e muito mais. Para personalizar quais informações e quantas informações são exibidas na página de solicitações pull, escolha o ícone de roda dentada. 

1. Para ver uma solicitação pull específica, escolha-a na lista.

1. Para visualizar o status das execuções de fluxos de trabalho associadas a essa solicitação pull, se houver, selecione **Visão geral** e revise as informações na área **Detalhes da solicitação pull** em **Execuções de fluxo de trabalho**. 

   A execução do fluxo de trabalho ocorrerá se o fluxo de trabalho estiver configurado com eventos de criação ou revisão de solicitação pull e se os requisitos da ramificação de destino no fluxo de trabalho corresponderem à ramificação de destino especificada na solicitação pull. Para obter mais informações, consulte [Adição de gatilhos aos fluxos de trabalho](workflows-add-trigger-add.md).

1. Para visualizar problemas vinculados, se houver, selecione **Visão geral** e revise as informações em **Detalhes da solicitação pull** em **Problemas**. Se você quiser ver um problema vinculado, escolha o ID na lista.

1. (Opcional) Para criar um resumo dos comentários deixados nas alterações de código nas revisões da solicitação pull, selecione **Criar resumo do conteúdo**. O resumo não incluirá nenhum comentário deixado na solicitação pull geral.
**nota**  
Essa funcionalidade exige que os recursos de IA generativa estejam habilitados para o espaço, não estejam disponíveis para repositórios vinculados e estejam disponíveis somente na região Oeste dos EUA (Oregon). 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. Para ver as alterações de código na solicitação pull, selecione **Alterações**. 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. Você também pode ver os comentários deixados em linhas de código específicas.

   
**nota**  
Nem todas as alterações em uma solicitação pull podem ser exibidas no console. Por exemplo, você não pode visualizar os submódulos do Git no console, portanto, não pode ver as diferenças em um submódulo em uma solicitação pull. Algumas diferenças podem ser muito grandes para serem exibidas. Para obter mais informações, consulte [Cotas para repositórios de origem em CodeCatalyst](source-quotas.md) e [Visualizar um arquivoVisualizar o histórico de alterações em um arquivo](source-files-view.md).

1. Para visualizar os relatórios de qualidade dessa solicitação pull, selecione **Relatórios**. 
**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 [Teste com fluxos de trabalhoTeste com fluxos de trabalho](test-workflow-actions.md). 

# Gerenciamento de requisitos para mesclar uma solicitação pull com regras de aprovação
<a name="source-pull-requests-approval-rules"></a>

Ao criar uma solicitação pull, você pode optar por adicionar revisores obrigatórios ou opcionais a essa solicitação pull individual. No entanto, você também pode criar requisitos que todas as solicitações pull devem atender ao mesclar com uma ramificação de destino específica. Esses requisitos são chamados de regras de aprovação. As regras de aprovação são configuradas para ramificações em um repositório. Quando você cria uma solicitação pull cuja ramificação de destino tem uma regra de aprovação configurada para ela, os requisitos dessa regra devem ser atendidos, além das aprovações de todos os revisores necessários, antes que você possa mesclar a solicitação pull com essa ramificação. A criação de regras de aprovação pode ajudá-lo a manter os padrões de qualidade para mesclagens em ramificações, como sua ramificação padrão.

As regras de aprovação aplicadas à ramificação padrão do seu repositório de origem se comportarão de maneira um pouco diferente das regras de aprovação aplicadas a outras ramificações. Qualquer regra aplicada à ramificação padrão será aplicada automaticamente a qualquer ramificação que você especificar como ramificação padrão. A ramificação anteriormente definida como a ramificação padrão ainda manterá as regras aplicadas a ela.

Ao criar regras de aprovação, considere como essa regra será cumprida pelos usuários do seu projeto no presente e no futuro. Por exemplo, se você tem seis usuários em seu projeto e cria uma regra de aprovação que exige cinco aprovações antes que ela seja mesclada na ramificação de destino, você efetivamente criou uma regra que exige que todos, exceto a pessoa que criou as solicitações pull, aprovem essa solicitação pull antes que ela possa ser mesclada. 

**nota**  
Você deve ter a função de administrador do projeto para criar e gerenciar regras de aprovação em CodeCatalyst projetos. Você não pode criar regras de aprovação para repositórios vinculados.

 Você não pode excluir as regras de aprovação, mas pode atualizá-las para que não exijam nenhuma aprovação, o que efetivamente remove a regra.<a name="view-edit-approval-rules"></a>

**Como visualizar e editar regras de aprovação para ramificações de destino para solicitações pull**

1. Acesse o projeto no qual reside seu repositório.

1. Selecione o nome do repositório na lista de repositórios de origem do projeto. No painel de navegação, também é possível selecionar **Código** e escolher **Repositórios de origem**.

   Selecione o repositório onde você deseja visualizar regras de aprovação.

1. Na página de visão geral do repositório, selecione **Ramificações**.

1. Na coluna **Regras de aprovação**, selecione **Visualizar** para ver o status de quaisquer regras para cada ramificação do repositório. 

   Em **Número mínimo de aprovações**, o número corresponde ao número de aprovações necessárias antes que uma solicitação pull seja mesclada a essa ramificação.

1. Para criar ou alterar uma regra de aprovação, selecione **Gerenciar configurações**. Na página de configurações do repositório de origem, em **Regras de aprovação**, selecione **Editar**.
**nota**  
Você deve ter o perfil de **administrador do projeto** para editar as regras de aprovação.

1. Em **Ramificação**, selecione o nome da ramificação para a qual você deseja configurar uma regra de aprovação na lista suspensa. Em **Número mínimo de aprovações**, insira um número e selecione **Salvar**.

# Revisão de uma solicitação pull
<a name="pull-requests-review"></a>

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

**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](notifications-manage.md).<a name="merge-base"></a>

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-base](https://git-scm.com/docs/git-merge-base)consulte 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.

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

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

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

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

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

1. 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](source-concepts.md#revision-concept).
**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.

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

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

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

1. 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](test-workflow-actions.md#test-code-coverage-reports).

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

1. 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](test-config-action.md).

1. Para ver um relatório específico, escolha-o na lista. Para obter mais informações, consulte [Teste com fluxos de trabalhoTeste com fluxos de trabalho](test-workflow-actions.md).

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

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

Você pode facilitar a revisão do código por outros membros do projeto atualizando a solicitação pull. Você pode atualizar uma solicitação pull para alterar os revisores, os links para problemas, o título da solicitação pull ou a descrição. Por exemplo, você talvez queira alterar os revisores obrigatórios de uma solicitação pull para remover alguém que está de férias e adicionar outra pessoa. Você também pode atualizar uma solicitação pull com mais alterações no código enviando confirmações para a ramificação de origem de uma solicitação pull aberta. Cada envio para a ramificação de origem de uma pull request no repositório de CodeCatalyst origem cria uma revisão. Os membros do projeto podem ver as diferenças entre as revisões em uma solicitação pull.<a name="pull-requests-update-reviewers"></a>

**Para atualizar os revisores de uma solicitação pull**

1. Navegue até o projeto em que deseja atualizar os revisores de uma solicitação pull.

1. Na página do projeto, em **Abrir solicitações pull**, escolha a solicitação pull em que você deseja atualizar os revisores. Como alternativa, no painel de navegação, selecione **Código**, selecione **Solicitações pull** e, depois, escolha a solicitação pull que você deseja atualizar. 

1. (Opcional) Em **Visão geral**, na área **Detalhes da solicitação pull**, escolha o sinal de adição para adicionar revisores obrigatórios ou opcionais. Escolha o **X** ao lado de um revisor para removê-lo como revisor opcional ou obrigatório.

   

1. (Opcional) Em **Visão geral**, na área **Detalhes da solicitação pull**, selecione **Vincular problemas** para vincular um problema à solicitação pull e, depois, escolha um problema na lista ou insira o ID. Para desvincular um problema, escolha o ícone de desvinculação ao lado do problema que você deseja desvincular. <a name="pull-requests-update-code"></a>

**Para atualizar arquivos e códigos na ramificação de origem de uma solicitação pull**

1. Para atualizar vários arquivos, [crie um Ambiente de Desenvolvimento](devenvironment-create.md) ou clone o repositório e a ramificação de origem e use um cliente Git ou um Ambiente de Desenvolvimento integrado (IDE) para fazer alterações nos arquivos na ramificação de origem. Confirme e envie as alterações para a ramificação de CodeCatalyst origem no repositório de origem para atualizar automaticamente a pull request com as alterações. Para obter mais informações, consulte [Clonar um repositório de origem](source-repositories-clone.md) e [Entendendo as mudanças no código-fonte com confirmações na Amazon CodeCatalyst](source-commits.md).

1. Para atualizar um arquivo individual em uma ramificação de origem, você pode usar um cliente Git ou IDE da mesma forma que faria com vários arquivos. Você também pode editá-lo diretamente no CodeCatalyst console. Para obter mais informações, consulte [Edição de um arquivo](source-files-edit.md).<a name="pull-requests-update-pull-request"></a>

**Para atualizar o título e a descrição de uma solicitação pull**

1. Navegue até o projeto em que deseja atualizar o título ou a descrição de uma solicitação pull.

1. A página do projeto exibe solicitações pull abertas, incluindo informações sobre quem criou a solicitação pull, qual repositório contém as ramificações da solicitação pull e quando a solicitação pull foi criada. Você pode filtrar a visualização da solicitação pull aberta por repositório de origem. Selecione na lista a solicitação pull que você deseja alterar.

1. Para ver todas as solicitações pull, selecione **Exibir tudo**. Como alternativa, no painel de navegação, selecione **Código** e **Solicitações pull**. Use a caixa de filtro ou as funções de classificação para localizar a solicitação pull que você deseja alterar e escolha essa solicitação.

1.  Em **Visão geral**, selecione **Editar**.

1. Altere o título ou a descrição e selecione **Salvar**.

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

Depois que seu código for revisado e todos os revisores necessários o aprovarem, você poderá mesclar uma pull request no CodeCatalyst console usando uma estratégia de mesclagem compatível, como o fast-forward. Nem todas as estratégias de mesclagem suportadas no CodeCatalyst console estão disponíveis como opções para todas as pull requests. CodeCatalyst avalia a mesclagem e só permite que você escolha entre as estratégias de mesclagem que estão disponíveis no console e são capazes de mesclar a ramificação de origem com a ramificação de destino. Você também pode mesclar uma solicitação pull com sua escolha de estratégias de mesclagem do Git executando o comando **git merge** no computador local ou em um Ambiente de Desenvolvimento para mesclar a ramificação de origem com a ramificação de destino. Em seguida, você pode enviar essas alterações na ramificação de destino para o repositório de origem em CodeCatalyst. 

**nota**  
Mesclar a ramificação e enviar as alterações no Git não fecha automaticamente a solicitação pull.

Se você tiver o perfil de administrador do projeto, também poderá optar por mesclar uma solicitação pull que ainda não satisfez todos os requisitos de aprovações e regras de aprovação. 

## Mescla de uma solicitação pull (console)
<a name="pull-requests-merge-console"></a>

Você pode mesclar uma pull request no CodeCatalyst console se não houver conflitos de mesclagem entre as ramificações de origem e de destino e se todos os revisores necessários tiverem aprovado a pull request. Se houver conflitos ou se a mesclagem não puder ser concluída, o botão de mesclagem ficará inativo e um rótulo **Não mesclável** será exibido. Nesse caso, você deve ter a aprovação de todos os aprovadores necessários, resolver conflitos localmente, se necessário, e enviar essas alterações antes de poder mesclar. Mesclar uma solicitação pull enviará automaticamente um e-mail para o criador da solicitação pull, bem como para quaisquer revisores obrigatórios ou opcionais. Isso não fechará ou alterará automaticamente o status de nenhum problema vinculado à solicitação pull.

**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](notifications-manage.md).<a name="pull-requests-merge-console"></a>

**Para mesclar uma solicitação pull**

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

1. Na página do projeto, em **Abrir solicitações pull**, escolha a solicitação pull que você deseja mesclar. Se você não vir a solicitação pull, selecione **Visualizar todas as solicitações pull** e, depois, escolha-a na lista. Como alternativa, no painel de navegação, selecione **Código**, selecione **Solicitações pull** e, depois, escolha a solicitação pull que você deseja mesclar. Escolha **Merge (Mesclar)**.

1. Selecione entre as estratégias de mesclagem disponíveis para a solicitação pull. Também é possível selecionar ou desmarcar a opção de excluir a ramificação de origem depois de mesclar a solicitação pull e, depois, selecionar **Mesclar**.
**nota**  
Se o botão **Mesclar** estiver inativo ou você ver o rótulo **Não mesclável**, os revisores obrigatórios ainda não aprovaram a pull request ou a pull request não pode ser mesclada no console. CodeCatalyst Um revisor que não aprovou uma solicitação pull é indicado por um ícone de relógio na área **Detalhes da solicitação pull** em **Visão geral**. Se todos os revisores obrigatórios aprovaram a solicitação pull, mas o botão **Mesclar** ainda estiver inativo, você pode ter um conflito de mesclagem. Escolha o rótulo sublinhado **Não mesclável** para ver mais detalhes sobre por que a solicitação pull não pode ser mesclada. Você pode resolver conflitos de mesclagem para a ramificação de destino em um ambiente de desenvolvimento ou no CodeCatalyst console e, em seguida, mesclar a pull request, ou pode resolver conflitos e mesclar localmente e, em seguida, enviar a confirmação que contém a mesclagem para a ramificação de origem em. CodeCatalyst Para ter mais informações, consulte [Mescla de uma solicitação pull (Git)](#pull-requests-merge-git) e a documentação do Git.

## Ignorar requisitos de mescla
<a name="pull-requests-merge-override"></a>

Se você tiver o perfil de **Administrador do projeto**, poderá optar por mesclar uma solicitação pull que ainda não satisfez todos os requisitos das aprovações e regras de aprovação necessárias. Isso se chama ignorar os requisitos de uma solicitação pull. Você pode optar por fazer isso se um revisor obrigatório não estiver disponível ou se surgir uma necessidade urgente de mesclar uma solicitação pull específica em uma ramificação que tenha regras de aprovação que não possam ser atendidas rapidamente. <a name="pull-requests-merge-console"></a>

**Para mesclar uma solicitação pull**

1. Na solicitação pull em que você deseja ignorar os requisitos e mesclar, escolha a seta suspensa ao lado do botão **Mesclar**. Selecione **Ignorar requisitos de aprovação**.

1. Em **Motivo para ignorar**, forneça detalhes do motivo pelo qual você está mesclando essa solicitação pull sem que ela atenda às regras de aprovação e aos requisitos do revisor obrigatório. Embora seja opcional, isso é altamente recomendado. 

1. Se desejar, escolha uma estratégia de mesclagem ou aceite o padrão. Você também pode optar por atualizar a mensagem de confirmação gerada automaticamente com mais detalhes.

1. Selecione ou desmarque a opção para excluir a ramificação de origem na mesclagem. Recomendamos que você retenha a ramificação de origem ao ignorar os requisitos para mesclar uma solicitação pull até ter a chance de revisar a decisão com outros membros da equipe.

1. Escolha **Merge (Mesclar)**.

## Mescla de uma solicitação pull (Git)
<a name="pull-requests-merge-git"></a>

O Git suporta muitas opções para mesclar e gerenciar ramificações. Os comandos a seguir são algumas das opções que você pode usar. Para ter mais informações, consulte a documentação disponível no [site do Git](https://git-scm.com/doc). Depois de mesclar e enviar as alterações, feche manualmente a solicitação pull. Para obter mais informações, consulte [Encerrar uma solicitação pull](pull-requests-close.md).


**Comandos comuns do Git para mesclar ramificações**  

|  |  | 
| --- |--- |
|  Mescla alterações da ramificação de origem no repositório local à ramificação de destino no repositório local.  |  `git checkout destination-branch-name` `git merge source-branch-name`  | 
|  Mescla a ramificação de origem com a ramificação de destino, especificando uma mesclagem fast-forward. Isso mescla as ramificações e move o ponteiro da ramificação de destino até a ponta da ramificação de origem.  |  `git checkout destination-branch-name` `git merge --ff-only source-branch-name`  | 
|  Mescla a ramificação de origem com a ramificação de destino, especificando uma mesclagem squash. Isso combina todas as confirmações da ramificação de origem em uma única confirmação de mesclagem na ramificação de destino.  |  `git checkout destination-branch-name` `git merge --squash source-branch-name`  | 
|  Mescla a ramificação de origem com a ramificação de destino, especificando uma mesclagem tripla. Isso cria uma confirmação de mesclagem e adiciona as confirmações individuais da ramificação de origem à ramificação de destino.  |  `git checkout destination-branch-name` `git merge --no-ff source-branch-name`  | 
|  Exclui a ramificação de origem no repositório local. Isso é útil para limpar o repositório local depois de mesclar com a ramificação de destino e enviar as alterações para o repositório de origem.  |  `git branch -d source-branch-name`  | 
|  Exclui a ramificação de origem no repositório remoto (o repositório de origem em CodeCatalyst) usando o apelido especificado do repositório local para o repositório remoto. (Observe o uso de dois pontos (`:`).) Como alternativa, especifique `--delete` como parte do comando.  |  `git push remote-name :source-branch-name` `git push remote-name --delete source-branch-name`  | 

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

Você pode marcar uma solicitação pull como **Fechada**. Isso não mescla a solicitação pull, mas pode ajudar você a determinar quais solicitações pull exigem ação e quais não são mais relevantes. Recomendamos fechar uma solicitação pull se você não planeja mais mesclar essas alterações ou se as alterações foram mescladas por outra solicitação pull.

Fechar uma solicitação pull enviará automaticamente um e-mail para o criador da solicitação pull, bem como para quaisquer revisores obrigatórios ou opcionais. Isso não alterará automaticamente o status de nenhum problema vinculado à solicitação pull.

**nota**  
Você não pode reabrir uma solicitação pull após ela ter sido fechada.<a name="pull-requests-close-pull-request"></a>

**Para fechar uma solicitação pull**

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

1. Na página do projeto, as solicitações pull abertas são exibidas. Escolha a solicitação pull que você deseja fechar.

1. Escolha **Fechar**.

1. Revise as informações e selecione **Fechar solicitação pull**.