Implantar artefatos de solicitação de pull com pipelines de versão clássicos

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

As solicitações de pull oferecem um modo de eficaz de examinar as alterações de código antes de serem mescladas na base de código. No entanto, essas alterações podem introduzir problemas que podem ser complicados de encontrar sem criar e implantar seu aplicativo em um ambiente específico. Os gatilhos de solicitação de pull permitem que você configure um conjunto de critérios que devem ser atendidos antes de implantar o código. Neste artigo, você aprenderá a configurar gatilhos de solicitação de pull com Azure Repos e o GitHub para implantar o artefato de compilação.

Pré-requisitos

Implantação de solicitação de pull

Com gatilhos de solicitação de pull, sempre que você gera uma nova solicitação de pull para o branch designado, uma versão é disparada automaticamente para iniciar a implantação nos ambientes designados. O status de implantação será exibido na página de solicitação de pull. Os gatilhos de solicitação de pull podem ajudá-lo a manter uma melhor qualidade de código, liberar com maior confiança e descobrir quaisquer problemas no início do ciclo de desenvolvimento.

Configurar implantações de solicitação de pull é um processo de duas etapas, primeiro devemos configurar um gatilho de solicitação de pull e depois configurar políticas de branch (Azure Repos) ou verificações de status (GitHub) para nossos pipelines de lançamento.

Criar um gatilho de solicitação pull

Um gatilho de solicitação de pull cria uma versão sempre que um novo artefato de compilação está disponível.

  1. Navegue até o projeto do Azure DevOps, selecionePipelines>Lançamentos e selecione o pipeline de lançamento.

  2. Selecione o ícone Gatilho de implantação contínua na seção Artefatos.

    Uma captura de tela mostrando como acessar as configurações de gatilho de implantação contínua.

  3. Selecione o botão de alternância para habilitar o Gatilho de solicitação de pull.

    Uma captura de tela mostrando como habilitar gatilhos de solicitação de pull.

  4. Selecione o Branch de Destino no menu suspenso.

    Uma captura de tela mostrando como selecionar a ramificação de destino.

  5. Para implantar seu aplicativo em uma fase específica, você precisa optar explicitamente por essa fase. A seção Fases mostra as fases habilitadas para implantações de solicitação de pull.

    Uma captura de tela mostrando a lista de estágios habilitados para implantações de solicitação de pull.

    Para aceitar uma fase para implantação de solicitação de pull, selecione o ícone Condições de pré-implantação para a fase específica e, em seguida, selecione Gatilhos>Após o lançamento. Por fim, selecione o botão de alternância Implantação de solicitação de pull para habilitá-lo.

    Uma captura de tela mostrando como habilitar a implantação de solicitação de pull para um estágio específico.

Importante

Não é recomendável habilitar implantações automáticas de solicitação de pull para fases de produção.

Configurar políticas de branch para Azure Repos

Você pode usar políticas de branch para implementar uma lista de critérios que devem ser atendidos para que uma solicitação de pull seja mesclada.

  1. Navegue até o projeto e selecione Repos>Branches para acessar a lista de branches do seu repositório.

    Uma captura de tela mostrando como navegar até branches no Azure Repos.

  2. Selecione o menu de contexto do branch ... apropriado e selecione Políticas de branch.

    Uma captura de tela mostrando como acessar políticas de branch para um branch específico.

  3. Selecione Adicionar status política e selecione um Status para marcar no menu suspenso. Selecione o status correspondente à sua definição de versão e selecione Salvar.

    Uma captura de tela mostrando como adicionar uma política de status.

    Observação

    A definição de versão deve ter sido executada pelo menos uma vez com o gatilho de solicitação de pull habilitado para obter a lista de status. Confira Configurar uma política de branch para um serviço externo para obter mais detalhes.

  4. Com a nova política de status adicionada, os usuários não poderão mesclar nenhuma alteração no branch de destino sem uma status "bem-sucedido" postada na solicitação de pull.

    Uma captura de tela mostrando uma lista de políticas de status e a política de implantação de solicitação de pull habilitada.

  5. Você pode exibir o status de suas políticas na página Visão geral da solicitação de pull. Dependendo das configurações de política, você pode exibir a versão postada status nas seções Obrigatório, Opcional ou Status. A versão status é atualizada sempre que o pipeline é disparado.

    Uma captura de tela mostrando o status das políticas de solicitação de pull.

Configurar verificações de status para repositórios GitHub

Habilitar verificações de status para um repositório GitHub permite que um administrador escolha quais critérios devem ser atendidos antes que uma solicitação de pull seja mesclada no branch de destino.

Observação

As verificações de status serão postadas na solicitação de pull somente depois que o pipeline de lançamento for executado pelo menos uma vez com a condição de implantação de solicitação de pull Habilitada. Confira Regras de proteção de branch para mais detalhes.

Uma captura de tela mostrando como habilitar verificações de status.

Você pode exibir seu verificações de status em sua solicitação de pull na guia Conversa.

Uma captura de tela mostrando as verificações de status da solicitação de pull.