Compartilhar via

Usar aprovações e gates para controlar a implantação

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

Usando uma combinação de aprovações de implantação manual, portões e intervenção manual em seu pipeline de lançamento, você pode configurar sua implantação de modo rápido e fácil para atender a todos os requisitos específicos de pré-implantação para seu fluxo de trabalho.

Neste tutorial, você aprenderá sobre:

  • Portões pré-implantação
  • Intervenção manual
  • Validação manual
  • Logs de implantação

Pré-requisitos

Configurar portões

Você pode usar portões para garantir que o pipeline de lançamento atenda a critérios específicos antes da implantação sem a necessidade de intervenção do usuário.

  1. Selecione Pipelines>Versões e, em seguida, selecione o pipeline de lançamento. Selecione Editar para abrir o editor de pipeline.

    Uma captura de tela mostrando o botão editar para pipelines de lançamento.

  2. Selecione o ícone de pré-implantação para o estágio e depois selecione o botão de alternância para habilitar Portões.

    Uma captura de tela mostrando como habilitar portões.

  3. Especifique o tempo de atraso antes que os portões adicionados sejam avaliados. Esse tempo é para permitir que as funções de portão inicializem e se estabilizem antes de retornarem os resultados.

    Uma captura de tela mostrando como definir o tempo de atraso para os portões de pré-implantação.

  4. Selecione Adicionar e selecione Itens de Trabalho de Consulta.

    Uma captura de tela mostrando como adicionar uma tarefa de consulta de itens de trabalho.

  5. Selecione uma consulta de item de trabalho no menu suspenso. Dependendo de quantos itens de trabalho você espera que a consulta retorne, defina seus limites máximos e mínimos.

    Uma captura de tela mostrando como configurar a tarefa de Consulta de Itens de Trabalho.

  6. Selecione a seção Opções de Avaliação e especifique o tempo limite e o intervalo de amostragem. Os valores mínimos que você pode especificar são tempo limite de 6 minutos e intervalo de amostragem de 5 minutos.

    Uma captura de tela mostrando como configurar as opções de avaliação para a tarefa de itens de consulta.

  7. Selecione Salvar quando terminar.

    Uma captura de tela mostrando como salvar um pipeline de lançamento.

Configurar intervenção manual

Dependendo do cenário, talvez seja necessário adicionar intervenção manual ao fluxo de liberação. Você pode fazer isso adicionando a tarefa Intervenção Manual ao seu fluxo de trabalho.

  1. Selecione Pipelines>Releases. Selecione o pipeline de lançamento e, em seguida, selecione Tarefas e escolha seu estágio.

    Uma captura de tela mostrando como navegar para realizar tarefas em um pipeline de lançamento.

  2. Selecione as reticências (...) e Adicionar um trabalho sem agente.

    Uma captura de tela mostrando como adicionar um trabalho sem agente.

  3. Arraste e solte o trabalho sem agente na parte superior do processo de implantação. Selecione o sinal (+) e, em seguida, selecione Adicionar a tarefa Intervenção Manual.

    Uma captura de tela mostrando como adicionar a tarefa de intervenção manual.

  4. Insira um nome de exibição e as instruções que serão exibidas quando a tarefa for disparada. Você também pode especificar uma lista de usuários a serem notificados e uma ação de tempo limite (rejeitar ou retomar) se nenhuma intervenção ocorreu dentro do período de tempo limite.

    Uma captura de tela mostrando como configurar a tarefa da intervenção manual.

  5. Selecione Salvar quando terminar.

Observação

A tarefa Intervenção Manual só pode ser usada em um trabalho sem agente.

Configurar a validação manual

Você pode usar a tarefa validação manual no pipeline do YAML para pausar e aguardar a aprovação manual. A validação manual é especialmente útil em cenários em que você deseja validar definições de configuração ou criar pacotes antes de iniciar um trabalho com uso intensivo de computação.

O trabalho waitForValidation pausa a execução e dispara um prompt de interface do usuário para examinar e validar a tarefa. Os endereços de e-mail listados em notifyUsers recebem uma notificação para aprovar ou negar a execução do pipeline.

Uma captura de tela mostrando o prompt de validação manual. 

pool: 
   vmImage: ubuntu-latest

jobs:
- job: waitForValidation
  displayName: Wait for external validation  
  pool: server    
  timeoutInMinutes: 4320 # job times out in 3 days
  steps:   
   - task: ManualValidation@0
     timeoutInMinutes: 1440 # task times out in 1 day
     inputs:
         notifyUsers: |
            someone@example.com
         instructions: 'Please validate the build configuration and resume'
         onTimeout: 'resume'

Exibir Logs de Implantação

Os logs de implantação são úteis para depurar problemas de implantação, mas você também pode usá-los para auditar suas execuções de pipeline, verificar aprovações e ver como elas foram concedidas e por quem.

  1. Selecione Pipelines>Versões e, em seguida, selecione o pipeline de lançamento.

    Uma captura de tela mostrando uma lista de definições de versão.

  2. Esta visão mostrará o status em tempo real de cada estágio em seu pipeline. A etapa de QA neste exemplo está aguardando intervenção. Selecione Retomar.

    Uma captura de tela mostrando o estágio de QA aguardando intervenção.

  3. Insira seu comentário e selecione Retomar.

    Uma captura de tela mostrando como responder a uma solicitação de intervenção manual pendente.

  4. A implantação da fase de Garantia de Qualidade foi bem-sucedida e as aprovações de pré-implantação são disparadas para a fase Produção.

    Uma captura de tela mostrando a aprovação de pré-implementação desencadeada para o próximo estágio.

  5. Selecione Aprovar, insira seu comentário e selecione Aprovar para continuar a implantação.

    Uma captura de tela mostrando como responder a uma solicitação de aprovação pendente.

  6. A status ao vivo indica que os portões estão sendo processados para a fase Produção antes que o lançamento continue.

    Uma captura de tela mostrando os portões de processamento de produção.

  7. Retorne ao pipeline de release, coloque o cursor sobre o estágio e selecione Logs para exibir os logs de implantação.

    Uma captura de tela mostrando como acessar logs de implantação.