Exercício - Criar, revisar e mesclar uma solicitação pull

  • 5 minutos

Você concluiu o trabalho para adicionar uma fila ao seu site. Agora, a equipe de desenvolvimento do site está pronta para você mesclar as alterações em sua filial principal. Neste exercício, você criará e mesclará uma solicitação pull para suas alterações.

Durante o processo, você:

  • Crie uma solicitação pull.
  • Analise a solicitação pull.
  • Conclua a solicitação pull.
  • Verifique se as alterações foram mescladas.

Criar uma solicitação pull para mesclar a ramificação do recurso

Como não é possível enviar as alterações diretamente para a ramificação principal do repositório, é necessário criar uma solicitação pull.

  1. No seu navegador, vá para Código.

  2. Selecione 2 ramificações para listar as ramificações em seu repositório GitHub.

    Captura de tela do GitHub que mostra a página do repositório com o link para a lista de ramificações realçado.

  3. Ao lado de add-orders-queue, selecione o ícone Mais (...) e, em seguida, selecione Nova solicitação pull.

    Captura de tela do GitHub que mostra a lista de ramificações. O botão para uma nova solicitação pull é realçado para a ramificação add-orders-queue.

  4. Quando você criou a solicitação pull, observe que o GitHub usou automaticamente a mensagem de confirmação do Git como título da solicitação pull.

    Atualize a descrição para o seguinte texto:

    Esta RP adiciona uma nova fila de Armazenamento do Azure para processar pedidos e atualiza a configuração do site para incluir a conta de armazenamento e as informações da fila.

  5. Selecione Criar pull request.

    Captura de tela do GitHub que mostra a página de criação de pull request, com o botão para criar uma pull request realçado.

  1. No seu navegador, vá para Repos>Files.

    Observe que o Azure DevOps mostra um banner que indica que há alterações na ramificação add-orders-queue . O banner se oferece para criar uma solicitação pull para essas alterações.

    Captura de tela do Azure DevOps que mostra a lista de arquivos do repositório, incluindo um banner que oferece a criação de uma solicitação pull.

  2. Selecione Criar uma solicitação pull.

  3. Na página para criar uma solicitação pull, observe que o Azure DevOps usou automaticamente a mensagem de confirmação do Git como o título da solicitação pull.

    Atualize a descrição para o seguinte texto:

    Esta RP adiciona uma nova fila de Armazenamento do Azure para processar pedidos e atualiza a configuração do site para incluir a conta de armazenamento e as informações da fila.

  4. Selecione Criar.

    Captura de ecrã do Azure DevOps que mostra a página de criação de pull request, com o botão para criar um pull request realçado.

Rever o pull request

Normalmente, uma solicitação pull é revisada por alguém que não seja seu autor. Neste exemplo, você fingirá ser outro membro da equipe e analisará sua própria solicitação pull.

  1. Na página pull request, selecione a guia Arquivos alterados .

    Captura de tela do GitHub que mostra a guia para arquivos alterados em uma solicitação pull.

    O GitHub mostra os arquivos que foram alterados nessa solicitação pull. Observe que ele destaca todas as linhas que foram alteradas, para que você possa ver facilmente o que deve revisar.

    Gorjeta

    Imagine que você está revisando isso para sua própria equipe. Poderia fazer alguma sugestão?

  2. No arquivo main.bicep que foi alterado, passe o mouse sobre a linha 18 e selecione o botão com o sinal de adição (+).

    Captura de tela do GitHub que mostra as alterações no arquivo bicep ponto principal. O mouse está pairando sobre a linha 18 e o botão para adicionar comentários é realçado.

  3. Na caixa de comentários, digite o seguinte texto: Isso deve ser colocado em maiúsculas?

  4. Selecione Iniciar uma avaliação.

    Captura de tela do GitHub que mostra o campo de comentário, com o botão para iniciar uma avaliação realçado.

    Gorjeta

    O GitHub não permite que você aprove suas próprias solicitações pull. Aqui, você comentará sua solicitação pull, mas não a aprovará. Quando você trabalha com as solicitações pull da sua própria equipe, este é o ponto em que você a aprova para indicar que está feliz por ela ser mesclada.

  5. Selecione Concluir sua avaliação.

  6. No painel de revisão exibido, selecione Enviar revisão.

    Captura de tela do GitHub que mostra o painel para finalizar uma avaliação, com o botão para enviar uma avaliação realçado.

    O GitHub retorna você à guia Conversa da solicitação pull.

  1. Na página pull request, selecione a guia Arquivos .

    Captura de tela do Azure DevOps que mostra os arquivos alterados na solicitação pull.

    O Azure DevOps mostra os arquivos que foram alterados nessa solicitação pull. Observe que ele destaca todas as linhas que foram alteradas, para que você possa ver facilmente o que deve revisar.

    Gorjeta

    Imagine que você está revisando isso para sua própria equipe. Poderia fazer alguma sugestão?

  2. No arquivo main.bicep que foi alterado, passe o mouse sobre a linha 18 e selecione o botão de comentário.

    Captura de tela do Azure DevOps que mostra as alterações no arquivo bicep de ponto principal. O mouse está pairando sobre a linha 18 e o botão para adicionar um comentário é realçado.

  3. Na caixa de comentários, digite o seguinte texto: Isso deve ser colocado em maiúsculas?

  4. Selecione Comentário.

    Captura de ecrã do Azure DevOps que mostra o campo de comentários, com o botão Comentário realçado.

    A largura da janela do navegador pode afetar a forma como a caixa de diálogo de comentários é exibida. O comentário abrirá uma caixa de diálogo Discussão em vez do comentário embutido, conforme mostrado na captura de tela.

  5. Selecione Aprovar.

    Captura de ecrã do Azure DevOps que mostra o botão Aprovar para o pedido pull.

    Depois de selecionar Aprovar, a opção Definir preenchimento automático é alterada para Concluída. Você usará esse recurso mais tarde nesta unidade.

Responder à revisão do pull request

Ao criar ou revisar uma solicitação pull, você pode participar de uma conversa sobre seu conteúdo. Imagine que você é o autor desse arquivo e deseja responder a um comentário do revisor.

  1. Responda à revisão da solicitação pull com o seguinte comentário: Não, as filas de armazenamento devem ter nomes minúsculos.

  2. Selecione Comentário e, em seguida, selecione Resolver conversação para indicar que a discussão na linha terminou.

    Captura de tela do GitHub que mostra a resposta a um comentário, com os botões para inserir um comentário e resolver uma conversa em destaque.

  1. Na página pull request, selecione a guia Visão geral .

    Captura de ecrã do Azure DevOps que mostra o separador Descrição Geral.

  2. Agora, imagine que você é o autor deste arquivo. Responda à revisão da solicitação pull com o seguinte comentário: Não, as filas de armazenamento devem ter nomes minúsculos.

  3. Selecione Responder e resolver para indicar que a discussão na linha terminou.

    Captura de ecrã do Azure DevOps que mostra a resposta a um comentário, com o botão para responder e resolver realçado.

Conclua o pull request

A equipe de desenvolvimento do seu site confirmou que está pronta para você enviar os pedidos para a fila, para que você esteja pronto para concluir e mesclar sua solicitação pull.

O seu pull request foi aprovado. A equipe de desenvolvimento do seu site confirmou que está pronta para você enviar os pedidos para a fila, para que você esteja pronto para concluir e mesclar sua solicitação pull.

  1. Selecione Mesclar solicitação pull.

    Captura de tela do GitHub que mostra uma solicitação pull com o botão para mesclagem realçado.

  2. O GitHub pede que você confirme a mesclagem. Quando o GitHub mescla a solicitação pull, ele cria uma confirmação e gera automaticamente uma mensagem de confirmação. Selecione Confirmar mesclagem.

    Captura de tela do GitHub que mostra uma solicitação pull com o botão para confirmar uma mesclagem realçado.

    Sua solicitação pull é mesclada e seu novo recurso está agora na ramificação principal do repositório.

  3. É uma boa prática excluir suas ramificações de recursos quando terminar de usá-las. A exclusão de ramificações ajuda a evitar confundir os membros da equipe no futuro sobre quais trabalhos ainda estão em andamento. Selecione Excluir ramificação.

    Captura de tela do GitHub que mostra uma solicitação pull com o botão para excluir uma ramificação realçado.

  1. Selecione Concluir.

    Captura de tela do Azure DevOps que mostra o botão Concluir para uma solicitação pull.

  2. Em Complete pull request, use as configurações padrão. Selecione Concluir mesclagem.

    Captura de tela do Azure DevOps que mostra o painel de conclusão da solicitação pull, com o botão para concluir uma mesclagem realçado.

    Sua solicitação pull é mesclada e seu novo recurso está agora na ramificação principal do repositório.

    O Azure DevOps excluiu automaticamente a ramificação do recurso quando você mesclou a solicitação pull. É uma boa prática excluir suas ramificações de recursos quando terminar de usá-las. A exclusão de ramificações ajuda a evitar confundir os membros da equipe no futuro sobre quais trabalhos ainda estão em andamento.

Verificar as alterações

Depois de mesclar uma solicitação pull, é uma boa ideia confirmar se as alterações foram mescladas com êxito.

  1. Vá para Código.

  2. Vá para o arquivo deploy/main.bicep e, em seguida, para o arquivo deploy/modules/appService.bicep .

    Captura de tela do GitHub que mostra a lista de arquivos do repositório após a solicitação pull ser mesclada.

    Observe que a fila e suas outras alterações agora estão nos arquivos.

  1. Vá para Repos>Files.

  2. Vá para o arquivo deploy/main.bicep e, em seguida, para o arquivo deploy/modules/appService.bicep .

    Observe que a fila e suas outras alterações agora estão nos arquivos.