Gerenciar revisões do pool de workers

Quando você implanta em um pool de workers ou muda a configuração dele, o Cloud Run cria uma revisão imutável.

As considerações a seguir se aplicam a revisões:

  • Não é necessário excluir manualmente as revisões, embora isso seja possível.
  • As revisões inativas não consomem recursos e não são faturadas.
  • Há um máximo de 1.000 revisões por pool de workers: se você exceder esse limite, as revisões mais antigas serão excluídas automaticamente.
  • O sufixo de revisão é atribuído automaticamente. Se você quiser usar seu próprio sufixo de versão, insira o parâmetro da CLI -revision-suffix.

Funções exigidas

Para ter as permissões necessárias para gerenciar pools de trabalhadores e revisões de pool de trabalhadores do Cloud Run, peça ao administrador para conceder a você o papel do IAM de Desenvolvedor do Cloud Run (roles/run.developer) no pool de trabalhadores do Cloud Run.

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o pool de trabalhadores do Cloud Run interagir com APIs doGoogle Cloud , como as bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Ver a lista de revisões de um pool de workers

gcloud

Para conferir a lista de revisões de um determinado pool de workers:

  1. Encontre o nome do pool de worker na lista de pools disponíveis no projeto:

    gcloud beta run worker-pools list

  2. Use o comando a seguir para receber todas as revisões desse pool de workers:

    gcloud beta run worker-pools revisions list
   --worker-pool=WORKER_POOL
   --region=REGION

    Substitua:

    • WORKER_POOL pelo nome do pool de workers.
    • REGION com a Google Cloud região do pool de workers.

Ver detalhes da revisão

gcloud

Para ver os detalhes de uma revisão no projeto, siga estas etapas:

  1. Encontre o nome do pool de worker na lista de pools disponíveis no projeto:

    gcloud beta run worker-pools list

  2. Use o comando a seguir para ver todas as revisões do pool de workers que você acabou de pesquisar: 

    gcloud beta run worker-pools revisions list
    --worker-pool=WORKER_POOL
    --region=REGION

    Substituir

    • WORKER_POOL pelo nome do pool de workers.
    • REGION com a Google Cloud região do pool de workers.

  3. Use o comando a seguir para ver mais detalhes sobre uma revisão específica: 

    gcloud beta run worker-pools revisions describe REVISION --region=REGION --worker-pool=WORKER_POOL

    Substituir

    • REVISION pelo nome da revisão que você quer saber mais.
    • REGION com a Google Cloud região do pool de workers.
    • WORKER_POOL com o nome do pool de workers.

    É possível usar a sinalização --format para formatar a saída. Por exemplo, para formatar a saída como YAML: 

    gcloud beta run worker-pools revisions describe REVISION
    --region=REGION
    --worker-pool=WORKER_POOL
    --format yaml

Observe que uma revisão não atual pode ter o status de RETIRED, o que significa que o Cloud Run retirou a infraestrutura necessária para essa revisão específica.

Excluir revisões

Um caso de uso comum para excluir uma revisão é quando você quer garantir que uma revisão específica não seja usada acidentalmente.

Não é possível excluir uma revisão se ela:

  • A única revisão do pool de workers.
  • A revisão mais recente do pool de workers.

Quando você exclui uma revisão, a imagem do contêiner usada por ela não é excluída automaticamente do Artifact Registry. Para excluir uma imagem de contêiner do Artifact Registry, consulte as instruções de exclusão do Artifact Registry.

Não é possível desfazer a exclusão de uma revisão.

Use a Google Cloud CLI para excluir uma revisão:

gcloud

Para excluir uma revisão, use o comando a seguir:

gcloud beta run worker-pools revisions delete REVISION 
    --region=REGION
    --worker-pool=WORKER_POOL

Substituir

  • Substitua REVISION pelo nome da revisão que você está excluindo.
  • WORKER_POOL pelo nome do pool de workers.
  • REGION com a Google Cloud região do pool de workers.

A seguir

Depois de implantar uma revisão, faça o seguinte: