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

  • 5 minutos

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

Durante o processo, você vai:

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

Criar uma solicitação de pull para mesclar a ramificação de recursos

Como você não pode efetuar push de alterações diretamente para na ramificação principal do repositório, precisará criar uma solicitação de pull.

  1. No navegador, acesse 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 escolha Nova pull request.

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

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

    Atualize a descrição para o seguinte texto:

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

  5. Selecione Criar solicitação de pull.

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

  1. No navegador, acesse Repositório>Arquivos.

    Observe que o Azure DevOps mostra uma faixa que indica que há alterações na ramificação add-orders-queue. A faixa oferece a criação de uma solicitação de pull para essas alterações.

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

  2. Selecione Criar uma solicitação de pull.

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

    Atualize a descrição para o seguinte texto:

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

  4. Selecione Criar.

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

Revisar a solicitação de pull

Normalmente, uma solicitação de pull é revisada por alguém diferente de seu criador. Neste exemplo, você simulará ser outro membro da equipe e revisará sua própria solicitação de pull.

  1. Na página da solicitação de pull, selecione a guia Arquivos alterados.

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

    O GitHub mostrará os arquivos que foram alterados nesta solicitação de pull. Observe que ele realça todas as linhas que foram alteradas, para que você possa ver facilmente o que deve revisar.

    Dica

    Imagine que você está revisando para sua própria equipe. Você faria 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 alterações no arquivo bicep de ponto principal. O mouse está passando sobre a linha 18 e o botão para adicionar comentários está realçado.

  3. Na caixa de comentário, insira o seguinte texto: Deve estar em maiúsculas?

  4. Selecione Iniciar uma revisão.

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

    Dica

    O GitHub não permite que você aprove suas próprias solicitações de pull. Aqui, você comentará a pull request, mas não a aprovará. Quando você trabalha com as solicitações de pull de sua própria equipe, esse é o ponto em que a aprova para indicar que está satisfeito com a mesclagem.

  5. Selecione Concluir sua revisão.

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

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

    O GitHub retorna você para a guia Conversa da solicitação de pull.

  1. Na página da solicitação de pull, selecione a guia Arquivos.

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

    O Azure DevOps mostrará os arquivos que foram alterados nesta solicitação de pull. Observe que ele realça todas as linhas que foram alteradas, para que você possa ver facilmente o que deve revisar.

    Dica

    Imagine que você está revisando para sua própria equipe. Você faria 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 alterações no arquivo bicep de ponto principal. O mouse está passando sobre a linha 18 e o botão para adicionar um comentário está realçado.

  3. Na caixa de comentário, insira o seguinte texto: Deve estar em maiúsculas?

  4. Selecione Comentário.

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

    A largura da janela do navegador pode afetar a forma como a caixa de diálogo de comentário é 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 tela do Azure DevOps que mostra o botão Aprovar na solicitação de pull.

    Depois que você selecionar Aprovar, a opção Definir preenchimento automático será alterada para Concluído. Você usará esse recurso mais adiante nesta unidade.

Responder à revisão da solicitação de pull

Ao criar ou revisar uma solicitação de pull, você poderá 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 de pull com o seguinte comentário: Não, as filas de armazenamento devem ter nomes em letras minúsculas.

  2. Selecione Comentário e Resolver conversa 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 realçado.

  1. Na página da solicitação de pull, selecione a guia Visão geral.

    Captura de tela do Azure DevOps que mostra a guia Visão geral.

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

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

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

Concluir a solicitação de pull

A equipe de desenvolvimento do site confirmou que está pronta para enviar os pedidos para a fila, ou seja, está tudo pronto para você concluir e mesclar a pull request.

A solicitação de pull foi aprovada. A equipe de desenvolvimento do site confirmou que está pronta para enviar os pedidos para a fila, ou seja, está tudo pronto para você concluir e mesclar a pull request.

  1. Selecione Mesclar solicitação de pull.

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

  2. O GitHub solicita que você confirme a mesclagem. Quando o GitHub mescla a solicitação de 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 de pull com o botão para confirmar uma mesclagem realçado.

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

  3. É recomendável excluir as ramificações de recursos quando você terminar de trabalhar com elas. Excluir ramificações ajuda a evitar que os membros da equipe fiquem confusos no futuro sobre qual trabalho ainda está em andamento. Selecione Excluir ramificação.

    Captura de tela do GitHub que mostra uma solicitação de 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 na solicitação de pull.

  2. Em Concluir a solicitação de pull, 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 de pull, com o botão para concluir uma mesclagem realçado.

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

    O Azure DevOps excluiu automaticamente a ramificação de recursos quando você mesclou a solicitação de pull. É recomendável excluir as ramificações de recursos quando você terminar de trabalhar com elas. Excluir ramificações ajuda a evitar que os membros da equipe fiquem confusos no futuro sobre qual trabalho ainda está em andamento.

Verificar as alterações

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

  1. Vá para Código.

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

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

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

  1. Vá para Repositório>Arquivos.

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

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