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 portas e aprovações em cada fase específica.
Neste tutorial, você aprenderá:
- 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 onde 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, terá que escolher nomes exclusivos, mas é uma boa ideia incluir “QA” no nome de um 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.
No Azure Pipelines, abra a guia Lançamentos. Selecione o pipeline de lançamento e selecione Editar.
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.
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.
Você também pode configurar os gatilhos de lançamento, Gatilhos de fases, ou agendar implantações.
Adicionar fases
Nesta seção, adicionaremos dois novos estágios ao nosso pipeline de lançamento: QA e produção (dois sites do Azure App Services 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.
Selecione a guia Pipeline no pipeline de lançamento e escolha a fase existente. Altere o nome da fase para Produção.
Selecione + Adicionar na lista suspensa e escolha Clonar fase (a opção clonar está disponível somente quando uma fase existente está selecionada).
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.
A fase clonada terá o nome Cópia de Produção. Selecione-a e altere o nome para QA.
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.
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.
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.
Selecione Tarefas na lista suspensa e escolha a fase QA.
Dependendo das tarefas que estiver usando, altere as configurações para que esse estágio seja implantado no destino "QA". Em nosso exemplo, usaremos a tarefa Implantar o Serviço de Aplicativo do Azure, conforme mostrado abaixo.
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. Recomenda-se sempre verificar se o aplicativo está funcionando corretamente no estágio de controle de qualidade ou de teste antes de implantá-lo 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:
Selecione a guia Pipeline, o ícone Condições de pré-implantação e Aprovadores de pré-implantação.
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 uma liberação ou implantação não deve aprová-la.
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.
Selecione Salvar.
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, vamos criar manualmente um novo lançamento. Normalmente, um lançamento é criado automaticamente quando um novo artefato de compilação está disponível. No entanto, neste cenário, vamos criá-lo manualmente.
Selecione Versão na lista suspensa e escolha Criar lançamento.
Insira uma descrição para o lançamento, verifique se os artefatos corretos estão selecionados e selecione Criar.
Uma faixa será exibida indicando que foi criado um novo lançamento. Selecione o link do lançamento para ver mais detalhes.
A página de resumo do lançamento mostrará o status da implantação em cada fase.
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.
Selecione o ícone pending_approval para abrir o painel da janela de aprovação. Insira um breve comentário e selecione Aprovar.
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:
No resumo do lançamento, passe o mouse sobre uma fase e selecione Logs.
Durante a implantação, você ainda pode acessar a página de logs para ver os logs dinâmicos de cada tarefa.
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.
Se você precisar de informações adicionais para depurar sua implantação, poderá executar o lançamento no modo de depuração.