Gerenciar pools de workers

Nesta página, descrevemos como visualizar informações sobre um pool de workers e excluir pools de workers.

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.

Criar um pool de workers

O Cloud Run cria um novo pool de trabalhadores na primeira vez que você implanta uma imagem de contêiner. Consulte Implantar um novo pool de workers para mais instruções.

Ver a lista de pools de workers no projeto

Use a Google Cloud CLI para conferir uma lista dos pools de workers disponíveis no seu projeto:

gcloud

Para listar os pools de workers no projeto:

gcloud beta run worker-pools list

É possível filtrar essa lista por propriedades da definição do pool de workers, como um rótulo atribuído.

Ver mais detalhes sobre um pool de workers

Use a Google Cloud CLI para ver mais detalhes sobre um pool de workers:

gcloud

Para ver detalhes sobre um pool de workers: 

gcloud beta run worker-pools describe WORKER_POOL
 Substitua WORKER_POOL pelo 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 describe WORKER_POOL
    --region REGION
    --format yaml

Substitua:

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

Desativar um pool de workers atual

A desativação de um pool de workers encerra todas as instâncias dele. Para desativar um pool de workers, use o seguinte comando para definir o escalonamento como zero:

gcloud beta run worker-pools update WORKER_POOL --scaling=0

Substitua WORKER_POOL pelo nome do pool de workers.

Excluir pools de workers atuais

As considerações a seguir se aplicam à exclusão de um pool de workers:

  • A exclusão de um pool de workers exclui todos os recursos relacionados a ele, incluindo todas as revisões, sem importar se estão ou não processando cargas de trabalho.
  • A exclusão de um pool de workers não remove automaticamente as imagens de contêiner do Artifact Registry. Para excluir imagens de contêiner usadas pelas revisões excluídas do Artifact Registry, consulte Como excluir imagens.
  • Depois de excluir um pool de workers, ele permanece visível na Google Cloud CLI até que a exclusão seja totalmente concluída. No entanto, não é possível atualizar o pool de workers.

  • A exclusão de um pool de workers é permanente. Não é possível desfazer ou restaurar.

gcloud

Para excluir um pool de workers, use o comando:

gcloud beta run worker-pools delete WORKER_POOL --region REGION

Substitua:

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