Gerenciar pools de workers

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

Funções exigidas

Se quiser ter as permissões necessárias para gerenciar pools de workers e revisões de pools 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 interagir 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.

Criar um pool de workers

O Cloud Run cria um novo pool de workers 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 o Google Cloud console ou a Google Cloud CLI para ver uma lista dos pools de workers disponíveis no projeto:

Console

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

    Acessar o Cloud Run

  2. Selecione Pools de workers no menu. Os pools de workers disponíveis são listados na página.

gcloud

Para listar os pools de workers no projeto, execute o seguinte comando:

gcloud 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 o Google Cloud console, a Google Cloud CLI ou o YAML para ver mais detalhes sobre um pool de workers:

Console

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

    Acessar 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 detalhes sobre um pool de workers: 

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

Substitua:

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

YAML

Para ver detalhes sobre um pool de workers, faça o download da configuração YAML dele:

gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml

Desativar um pool de workers

A desativação de um pool de workers encerra todas as instâncias desse pool. Para desativar um pool de workers, defina o escalonamento como zero:

Console

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

    Acessar o Cloud Run

  2. Selecione Pools de workers no menu e, na lista de pools de workers, clique no pool que você quer desativar.

  3. Clique no ícone de caneta à direita de Escalonamento: manual (instâncias: ) e mude o valor para 0.

  4. Clique em Salvar para atualizar e desativar o pool de workers.

gcloud 

gcloud run worker-pools update WORKER_POOL --instances=0

Substitua WORKER_POOL pelo nome do pool de workers.

YAML

  1. Se você estiver criando um novo pool de workers, pule esta etapa. Se você estiver atualizando um pool de workers, faça o download da configuração YAML dele:

    gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. Defina a escala como um valor de 0 para desativar o pool de workers. O exemplo a seguir contém a configuração YAML:

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/scalingMode: manual
    run.googleapis.com/manualInstanceCount: `0`

    Substitua:

    • WORKER_POOL: o nome do pool de workers do Cloud Run.

  3. Crie ou atualize o pool de workers usando o seguinte comando:

    gcloud run worker-pools replace workerpool.yaml

Excluir pools de workers

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.

Console

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

    Acessar o Cloud Run

  2. Selecione Pools de workers no menu e, na lista de pools de workers, selecione o pool que você quer excluir.

  3. Clique em Excluir.

gcloud

Para excluir um pool de workers, use o comando:

gcloud run worker-pools delete WORKER_POOL --region REGION

Substitua:

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