Suspender um pipeline de entrega

Nesta página, descrevemos como suspender um pipeline de entrega do Cloud Deploy.

É possível suspend um pipeline de entrega. A suspensão de um pipeline significa que ele não pode mais ser usado para o seguinte:

• Criar uma versão

• Promover uma versão

• Reverter uma versão

• Reimplantar uma versão

• Aprovar ou rejeitar um lançamento

Veja alguns motivos possíveis para a suspensão de um pipeline de entrega:

• Há um problema com uma versão e você quer evitar outras ações nesse pipeline até que o problema seja encontrado.

• Sua organização observa um congelamento de fim de ano, por exemplo, durante o pico da temporada de compras de fim de ano.

Para suspender um pipeline de entrega:

1. No arquivo de configuração do pipeline de entrega, inclua a seguinte propriedade:

   suspended: true
   

   Essa propriedade fica no nível superior, conforme mostrado:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
    Name: my-app
   description: main application pipeline
   suspended: true
   serialPipeline:
    stages:
      - targetId: dev
        profiles: []
      - targetId: staging
        profiles: []
      - targetId: prod
        profiles: []
   

2. Registre o pipeline de entrega:

   gcloud deploy apply --file=PIPELINE_CONFIG --region=REGION --project=PROJECT_ID
   

   Em que:

   • PIPELINE_CONFIG

     É o nome do arquivo de configuração do pipeline de entrega, normalmente clouddeploy.yaml. Obrigatório.

   • REGION

     É o nome da região em que o pipeline de entrega foi criado, por exemplo, us-central1. Obrigatório.

   • PROJECT_ID

     É o ID do projeto em que o pipeline de entrega foi criado. Obrigatório.

O pipeline de entrega agora está em um estado suspenso, o que impede a criação da versão, a promoção, a reversão e a reimplantação e a aprovação do lançamento.

Lançamentos de pipelines de entrega suspensos

Se houver algum lançamento em andamento ou na fila quando você suspender um pipeline de entrega, esses lançamentos continuarão para ser concluídos. Eles não serão cancelados. No entanto, como não é possível criar nem promover uma versão, nenhuma nova lançamento pode ser criada usando esse pipeline até que ela seja retomada.

Permissões do IAM necessárias para suspender um pipeline

As permissões do IAM necessárias para suspender um pipeline de entrega estão incluídas nos seguintes papéis:

• roles/clouddeploy.admin

• papéis/clouddeploy.operator

• papéis/clouddeploy.developer

Retomar um pipeline de entrega suspenso

Para reativar um pipeline de entrega suspenso, faça o seguinte:

1. No arquivo de configuração do pipeline de entrega, remova a propriedade suspended: true ou defina-a como false.

2. Aplique a configuração:

   gcloud deploy apply --file=PIPELINE_CONFIG --region=REGION --project=PROJECT_ID
   

Descubra quais pipelines estão suspensos

Todos os pipelines de entrega bloqueados são mostrados com um ícone de bloqueio ao lado do nome na visualização Pipelines de entrega do console do Google Cloud:

A seguir

• Descubra como visualizar um pipeline de entrega que já está em uso.

• Saiba como atualizar um pipeline de entrega.

• Descubra como excluir um pipeline de entrega.

• Saiba como usar notificações de serviço.