Definir seu pipeline Clássico

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

O Azure Pipelines fornece um pipeline altamente configurável e gerenciável para lançamentos em várias fases, como desenvolvimento, preparação, QA e produção. também oferece a oportunidade de implementar portões e aprovações em cada fase específica.

Neste tutorial, você aprenderá sobre:

  • Gatilhos de implantação contínua
  • Adicionar fases
  • Adicionar aprovações de pré-implantação
  • Criando lançamentos e monitorando implantações

Pré-requisitos

Você precisará de:

  • Um pipeline de lançamento que contém pelo menos uma fase. Se você ainda não tiver um, poderá criá-lo trabalhando em qualquer um dos seguintes guias de início rápido e tutoriais:

  • Dois destinos separados no qual você implantará o aplicativo. Podem ser máquinas virtuais, servidores Web, grupos de implantação física local ou outros tipos de destino de implantação. Neste exemplo, estamos usando instâncias do site de Serviço de Aplicativo do Azure. Se você decidir fazer o mesmo, precisará escolher nomes exclusivos, mas é uma boa ideia incluir "QA" em um nome e "Produção" no outro para que você possa identificá-los facilmente. Usará o portal do Azure para criar um aplicativo Web.

Gatilhos de CD (implantação contínua)

Habilitar o gatilho de implantação contínua instruirá o pipeline a criar automaticamente um novo lançamento sempre que um novo build estiver disponível.

  1. No Azure Pipelines, abra a guia Lançamentos. Selecione o pipeline de lançamento e escolha Editar.

    editar o pipeline de lançamento

  2. Selecione o ícone Gatilho de implantação contínua na seção Artefatos para abrir o painel de gatilho. Verifique se isso está habilitado para que o novo lançamento seja criado após a conclusão bem-sucedida de cada novo build.

    gatilhos de implantação contínua

  3. Selecione o ícone Condições de pré-implantação na seção Fases para abrir o painel de condições. Verifique se o gatilho para implantação nessa fase está definido como Após o lançamento. Isso significa que uma implantação será iniciada automaticamente quando um novo lançamento for criado nesse pipeline de lançamento.

    condições de pré-implantação

    Você também pode configurar os Gatilhos de versão, Gatilhos de fases ou Agendar implantações.

Adicionar fases

Nesta seção, adicionaremos duas novas fases ao nosso pipeline de lançamento: QA e produção (dois sites do Serviço de Aplicativo do Azure neste exemplo). Esse é um cenário típico em que você implantaria inicialmente no servidor de teste ou de preparo e no servidor ativo ou de produção. Cada fase representa um destino de implantação.

  1. Selecione a guia Pipeline no pipeline de lançamento e escolha a fase existente. Altere o nome da fase para Produção.

    Escolhendo uma fase existente na guia Pipelines e alterando o nome para Produção no painel Fases

  2. Selecione + Adicionar na lista suspensa e escolha Clonar fase (a opção clonar está disponível somente quando uma fase existente está selecionada).

    selecionando a fase Clonar

    Normalmente, você deseja usar os mesmos métodos de implantação em uma fase de teste e de produção para ter certeza de que os aplicativos implantados se comportarão da mesma maneira. Clonar uma fase existente é uma boa maneira de garantir que você tenha as mesmas configurações para ambos. Em seguida, você só precisa alterar os destinos de implantação.

  3. A fase clonada terá o nome Cópia de Produção. Selecione-a e altere o nome para QA.

    alteração do nome da fase para QA

  4. Para reorganizar as fases no pipeline, selecione o ícone Condições de pré-implantação na fase QA e defina o gatilho como Após o lançamento. O diagrama de pipeline mostrará as duas fases em paralelo.

    reorganizando fases

  5. Selecione o ícone Condições de pré-implantação na fase Produção e defina o gatilho como Após a fase e escolha QA na lista suspensa Fases. O diagrama de pipeline agora indicará que as duas fases serão executadas na ordem correta.

    Selecionando gatilhos de QA e fases

    Observação

    Você pode configurar sua implantação para iniciar quando uma implantação na fase anterior for parcialmente bem-sucedida. Isso significa que a implantação continuará mesmo que uma tarefa não crítica específica tenha falhado. Isso geralmente é usado em implantações de bifurcação e junção que são implantadas em fases diferentes em paralelo.

  6. Selecione Tarefas na lista suspensa e escolha a fase QA.

    Menu suspenso Tarefas e selecionando a fase QA

  7. Dependendo das tarefas que você está usando, altere as configurações para que essa fase seja implantada no destino "QA". Em nosso exemplo, usaremos a tarefa Implantar Serviço de Aplicativo do Azure, conforme mostrado abaixo.

    Usando a tarefa implantar o serviço de aplicativo do Azure

Adicionar aprovações de pré-implantação

O pipeline de lançamento que modificamos anteriormente é implantado em QA e produção. Se a implantação no QA falhar, não será disparada a implantação na produção. É recomendável sempre verificar se o aplicativo está funcionando corretamente na fase de test ou QA antes de implantar na produção. A adição de aprovações garantirá que todos os critérios sejam atendidos antes da implantação na próxima fase. Para adicionar aprovações ao pipeline, siga as etapas abaixo:

  1. Selecione a guia Pipeline, o ícone Condições de pré-implantação e Aprovadores de pré-implantação.

    painel de aprovadores de pré-implantação

  2. Na caixa de texto Aprovadores, insira os usuários que serão responsáveis pela aprovação da implantação. Também é recomendável desmarcar a caixa de seleção O usuário que solicita um lançamento ou implantação não deve aprová-lo.

    Adicionar aprovadores de pré-implantação

    Você pode adicionar quantos aprovadores forem necessários, tanto usuários individuais quanto grupos de organizações. Também é possível configurar aprovações pós-implantação selecionando o ícone "usuário" no lado direito da fase no diagrama de pipeline. Para obter mais informações, confira Aprovações e portas de lançamentos.

  3. Selecione Salvar.

    salvar o pipeline de lançamento

Criar uma versão

Agora que a configuração do pipeline de lançamento foi concluída, é hora de iniciar a implantação. Para fazer isso, criaremos manualmente um novo lançamento. Normalmente, um lançamento é criado automaticamente quando um novo artefato de compilação está disponível. No entanto, nesse cenário, vamos criá-lo manualmente.

  1. Selecione Versão na lista suspensa e escolha Criar lançamento.

    criar um novo lançamento

  2. Insira uma descrição para o lançamento, verifique se os artefatos corretos estão selecionados e selecione Criar.

    criar um novo painel de lançamento

  3. Uma faixa será exibida indicando que um novo lançamento foi criado. Selecione o link do lançamento para ver mais detalhes.

    lançamento criado com êxito

  4. A página de resumo do lançamento mostrará o status da implantação em cada fase.

    status da implantação

    Outras exibições, como a lista de versões, também exibem um ícone que indica que a aprovação está pendente. O ícone mostra um pop-up que contém o nome da fase e mais detalhes quando você aponta para ele. Isso facilita para um administrador ver quais lançamentos estão aguardando aprovação, bem como o progresso geral de todos os lançamentos.

    exibição da lista de lançamentos

  5. Selecione o ícone pending_approval para abrir o painel da janela de aprovação. Insira um breve comentário e selecione Aprovar.

    aprovando a implantação

Observação

Você pode agendar a implantação em uma data posterior, por exemplo, durante horários fora do pico. Você também pode reatribuir a aprovação a um usuário diferente. Os administradores de lançamentos podem acessar e substituir todas as decisões de aprovação.

Monitorar e acompanhar implantações

Os logs de implantação ajudam você a monitorar e depurar o lançamento do aplicativo. Para marcar os logs da nossa implantação, siga as etapas abaixo:

  1. No resumo do lançamento, passe o mouse sobre uma fase e selecione Logs.

    logs de implantação

    Durante a implantação, você ainda pode acessar a página de logs para ver os logs dinâmicos de cada tarefa.

  2. Selecione qualquer tarefa para ver os logs dessa tarefa específica. Isso facilita o rastreamento e a depuração de problemas de implantação. Você também pode baixar os logs de tarefas individuais ou um zip de todos os arquivos de log.

    baixando logs

  3. Se você precisar de informações adicionais para depurar sua implantação, poderá executar o lançamento no modo de depuração.

Próxima etapa