Criar uma solicitação pull - AWS CodeCommit
Criar uma solicitação pull (console)Criar uma solicitação pull (AWS CLI)

AWS CodeCommit não está mais disponível para novos clientes. Os clientes atuais do AWS CodeCommit podem continuar usando o serviço normalmente. Saiba mais

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 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 alterações para o repositório, você pode criar uma solicitação pull que compara o conteúdo dessa ramificação (a ramificação de origem) com a ramificação em que deseja mesclar suas alterações após a solicitação pull ser fechada (a ramificação de destino).

Você pode usar o console do AWS CodeCommit ou o AWS CLI para criar solicitações de extração para o repositório.

Criar uma solicitação pull (console)

Você pode usar o console do CodeCommit para criar uma solicitação pull em um repositório do CodeCommit. Se o seu repositório estiver configurado com notificações, os usuários inscritos receberão um e-mail quando você criar uma solicitação pull.

  1. Abra o console do CodeCommit em https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Em Repositories (Repositórios), escolha o nome do repositório onde você deseja criar uma solicitação pull.

  3. No painel de navegação, escolha Pull Requests.

    dica

    Você também pode criar solicitações pull em Branches (Ramificações) e em Code (Código).

  4. Escolha Create pull request.

    Criar uma solicitação pull na página Solicitações pull no console do CodeCommit.

  5. Em Create pull request, em Source, escolha a ramificação que contém as alterações que deseja revisar.

  6. Em Destination (Destino), escolha a ramificação na qual você pretende mesclar suas alterações de código quando a solicitação pull for fechada.

  7. Escolha Compare. Uma comparação é executada nas duas ramificações, e as diferenças entre elas são exibidas. Uma análise também é realizada para determinar se as duas ramificações podem ser mescladas automaticamente quando a solicitação pull é fechada.

  8. Analise os detalhes da comparação e as alterações para se certificar de que a solicitação pull contém as alterações e confirmações que você deseja analisar. Caso contrário, ajuste suas escolhas para as ramificações de origem e de destino e escolha Compare novamente.

  9. Quando estiver satisfeito com os resultados da comparação para a solicitação pull, em Title (Título), forneça um título curto, mas descritivo, para essa revisão. Este é o título que aparece na lista de solicitações pull para o repositório.

  10. (Opcional) Em Description (Descrição), insira os detalhes sobre essa análise e qualquer outra informação útil para os revisores.

  11. Escolha Create (Criar).

    Criação de uma solicitação pull

Sua solicitação pull aparece na lista de solicitações pull para o repositório. Se você configurou notificações, os assinantes do tópico do Amazon SNS receberão um e-mail informando sobre a solicitação pull recém-criada.

Criar uma solicitação pull (AWS CLI)

Para usar comandos da AWS CLI com o CodeCommit, instale a AWS CLI. Para obter mais informações, consulte Referência da linha de comando.

Para usar a AWS CLI para criar solicitações pull em um repositório do CodeCommit

  1. Execute o comando create-pull-request, especificando:

    • O nome da solicitação pull (com a opção --title).

    • A descrição da solicitação pull (com a opção --description).

    • Uma lista de destinos para o comando create-pull-request, incluindo:

      • O nome do repositório do CodeCommit em que a solicitação pull foi criada (com o atributo repositoryName).

      • O nome da ramificação que contém as alterações de código que você deseja analisar, também conhecida como ramificação de origem (com o atributo sourceReference).

      • Opcionalmente, o nome da ramificação na qual você pretende mesclar suas alterações de código, também conhecida como a ramificação de destino, se você não quiser mesclar a ramificação padrão (com o atributo destinationReference).

    • Um token de idempotência exclusivo gerado pelo cliente (com a opção --client-request-token).

    Este exemplo cria uma solicitação pull chamada Pronunciation difficulty analyzer (Analisador de dificuldade de pronúncia) com uma descrição Please review these changes by Tuesday (Revise essas alterações até terça-feira) que tem como destino a ramificação de origem jane-branch. A solicitação pull deve ser mesclada com a ramificação padrão principal em um repositório do CodeCommit chamado MyDemoRepo:

    aws codecommit create-pull-request --title "Pronunciation difficulty analyzer" --description "Please review these changes by Tuesday" --client-request-token 123Example --targets repositoryName=MyDemoRepo,sourceReference=jane-branch

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "pullRequest": {
        "approvalRules": [
            {
                "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
                "approvalRuleId": "dd8b17fe-EXAMPLE",
                "approvalRuleName": "2-approver-rule-for-main",
                "creationDate": 1571356106.936,
                "lastModifiedDate": 571356106.936,
                "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
                "originApprovalRuleTemplate": {
                    "approvalRuleTemplateId": "dd3d22fe-EXAMPLE",
                    "approvalRuleTemplateName": "2-approver-rule-for-main"
                },
                "ruleContentSha256": "4711b576EXAMPLE"
            }
        ],
        "authorArn": "arn:aws:iam::111111111111:user/Jane_Doe",
        "description": "Please review these changes by Tuesday",
        "title": "Pronunciation difficulty analyzer",
        "pullRequestTargets": [
            {
                "destinationCommit": "5d036259EXAMPLE",
                "destinationReference": "refs/heads/main",
                "repositoryName": "MyDemoRepo",
                "sourceCommit": "317f8570EXAMPLE",
                "sourceReference": "refs/heads/jane-branch",
                "mergeMetadata": {
                    "isMerged": false
                }
            }
        ],
        "lastActivityDate": 1508962823.285,
        "pullRequestId": "42",
        "clientRequestToken": "123Example",
        "pullRequestStatus": "OPEN",
        "creationDate": 1508962823.285
    }
}