Gerenciar revisões do pool de workers

As revisões do pool de workers do Cloud Run permitem acompanhar o histórico de configuração e reverter para estados de implantação anteriores. Cada implantação ou atualização de configuração em um pool de workers cria uma revisão imutável.

As revisões inativas não consomem recursos nem geram custos. Portanto, não é necessário excluir revisões manualmente. Cada pool de workers retém até 1.000 revisões e exclui automaticamente as mais antigas quando esse limite é excedido.

Funções exigidas

Se quiser ter as permissões necessárias para gerenciar os pools de workers e as revisões do pool de workers 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 workers 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 workers do Cloud Run interage com Google Cloud APIs, como 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

Cada nome de revisão inclui um sufixo atribuído automaticamente, a menos que você especifique um sufixo personalizado ao implantar com a Google Cloud CLI --revision-suffix flag.

Console

  1. No Google Cloud console, acesse o Cloud Run:

    Acesse o Cloud Run

  2. Selecione Pools de workers no menu para mostrar a lista de pools de workers.

gcloud

Para visualizar a lista de revisões de um determinado pool de workers, siga estas etapas:

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

    gcloud run worker-pools list

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

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

    Substitua:

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

Ver detalhes da revisão

Console

  1. No Google Cloud console, acesse o Cloud Run:

    Acesse o Cloud Run

  2. Selecione Pools de workers no menu para mostrar os pools de workers disponíveis.

  3. Clique no pool de workers para mostrar o painel de detalhes.

gcloud

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

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

    gcloud run worker-pools list

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

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

    Substituir

    • WORKER_POOL pelo nome do pool de workers.
    • REGION pela 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 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 pela Google Cloud região do pool de workers.
    • WORKER_POOL pelo nome do pool de workers.

    É possível usar a --format flag para formatar a saída. Por exemplo, para formatar a saída como YAML: 

    gcloud 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 for:

  • 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 esta revisão 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 o Google Cloud console ou a Google Cloud CLI para excluir uma revisão:

Console

  1. No Google Cloud console, acesse o Cloud Run:

    Acesse o Cloud Run

  2. Selecione Pools de workers no menu para mostrar os pools de workers disponíveis.

  3. Clique no pool de workers para mostrar o painel de detalhes.

  4. Clique em Revisões.

  5. Selecione a revisão que você quer excluir.

  6. Clique nas reticências em Ações e em Excluir para excluir a revisão.

gcloud

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

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

Substituir

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

A seguir

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