Suspender um pipeline de entrega

Esta página descreve como suspender um pipeline de entrega do Cloud Deploy.

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

  • Criar uma versão

  • Promover uma versão

  • Reverter uma versão

  • Reimplantar uma versão

  • Aprovar ou rejeitar um lançamento

Confira alguns motivos possíveis para suspender um pipeline de entrega:

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

  • Sua organização observa um congelamento de feriados, por exemplo, durante o período 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 vai para o 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, a promoção, a reversão, o reimplante e a aprovação do lançamento.

Como o pipeline está suspenso, ações como promoção são impedidas.

Lançamentos de pipelines de entrega suspensos

Se houver lançamentos em andamento ou na fila quando você suspender um pipeline de envio, eles vão continuar até a conclusão. Eles não são cancelados. No entanto, como não é possível criar ou promover uma versão, não é possível criar novos lançamentos usando esse pipeline até que ele seja retomado.

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

  • roles/clouddeploy.operator

  • roles/clouddeploy.developer

Retomar um pipeline de entrega suspenso

Para reativar um pipeline de entrega suspenso:

  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

Descobrir quais pipelines estão suspensos

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

Ícone de cadeado, indicando que o pipeline de entrega está suspenso.

A seguir