Suspender um pipeline de entrega

Nesta página, descrevemos como suspender um pipeline de entrega do Google 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

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

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

  • Sua organização observa um congelamento de feriados, por exemplo, durante a alta 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, a promoção, a reversão e a reimplantação da versão e a aprovação do lançamento.

Como o pipeline está suspenso, ações, como "Promover", são evitadas.

Lançamentos de pipelines de entrega suspensos

Se houver lançamentos em andamento ou na fila quando você suspender um pipeline de entrega, eles continuarão sendo concluídos. Eles não serão cancelados. No entanto, como não é possível criar ou promover uma versão, nenhum lançamento novo pode ser criado 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:

  • papéis/clouddeploy.admin

  • papéis/clouddeploy.operator

  • papéis/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

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

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

A seguir