O escalonamento manual permite definir uma contagem de instâncias específica sem precisar de reimplantação. Use o escalonamento manual quando a carga de trabalho precisar de um número fixo de instâncias ou quando você quiser controlar a contagem de instâncias no seu próprio sistema.
Para escalonar instâncias automaticamente com base na utilização da CPU em vez de definir uma contagem fixa de instâncias, consulte Configurar o escalonamento automático de CPU para pools de workers.
Considerações de faturamento ao usar o escalonamento manual
Quando você usa o escalonamento manual, todas as instâncias solicitadas são faturadas como instâncias ativas, mesmo que estejam ociosas. Para ver todos os detalhes de faturamento, consulte a página de preços.
Funções exigidas
Para receber as permissões necessárias para configurar e implantar pools de workers do Cloud Run, peça ao administrador para conceder a você os seguintes papéis do IAM:
- Desenvolvedor do Cloud Run (
roles/run.developer) no pool de workers do Cloud Run - Usuário da conta de serviço (
roles/iam.serviceAccountUser) na conta de serviço
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 APIs doGoogle Cloud , 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.
Configurar escalonamento
Alterar o modo de escalonamento ou a contagem manual de instâncias não cria uma nova revisão.
Para configurar o modo de escalonamento, use o console do Google Cloud , a Google Cloud CLI, o YAML, o Terraform ou a API REST:
Console
No console do Google Cloud , acesse o Cloud Run:
Se você estiver configurando um novo pool de workers, selecione Pools de workers no menu e clique em Implantar contêiner. Se você estiver configurando um pool de workers atual, clique nele para exibir o painel de detalhes e, em seguida, clique no ícone de caneta ao lado de Escalonamento no canto superior direito do painel de detalhes.
Localize o formulário Escalonamento (para um novo pool de workers) ou o formulário Editar escalonamento para um pool de workers atual.
No campo Número de instâncias, especifique o número de instâncias de contêiner para o pool de workers.
Conclua a especificação.
Clique em Criar para um novo pool de workers ou em Salvar para um pool de workers atual.
gcloud
- Para especificar o escalonamento manual de um novo pool de workers, execute o seguinte comando
com a
flag
--scaling:
gcloud beta run worker-pools deploy WORKER_POOL \ --scaling=INSTANCE_COUNT \ --image IMAGE_URL
Substitua:
- WORKER_POOL: o nome do pool de workers.
- INSTANCE_COUNT: o número de instâncias do pool de workers.
Isso define o pool de workers para escalonamento manual. Especifique um valor de
0para desativar o pool de workers. IMAGE_URL: uma referência à imagem de contêiner que contém o pool de workers, comous-docker.pkg.dev/cloudrun/container/worker-pool:latest.Para especificar o escalonamento manual de um pool de workers, execute o seguinte comando com a flag
--scaling:
gcloud beta run worker-pools update WORKER_POOL \ --scaling=INSTANCE_COUNT
Substitua:
- WORKER_POOL: o nome do pool de workers.
- INSTANCE_COUNT: o número de instâncias do pool de workers.
YAML
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 correspondente:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Defina
scalingModecomomanuale especifiquemanualInstanceCount:apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/scalingMode: manual run.googleapis.com/manualInstanceCount: "INSTANCE_COUNT"
Substitua:
- WORKER_POOL: o nome do pool de workers do Cloud Run.
- INSTANCE_COUNT: o número de instâncias que você está escalonando manualmente
para o pool de workers. Especifique um valor de
0para desativar o pool de workers.
Crie ou atualize o pool de workers usando o seguinte comando:
gcloud run worker-pools replace worker-pool.yaml
O comando
gcloud run worker-pools replaceusa o arquivoworker-pool.yamlpor padrão, se ele estiver presente.
Terraform
Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
template {
containers {
image = "IMAGE_URL"
}
}
scaling {
scaling_mode = "MANUAL"
manual_instance_count = "INSTANCE_COUNT"
}
}
Substitua:
- WORKER_POOL: o nome do pool de workers.
- REGION: a região do Google Cloud , por exemplo,
europe-west1. IMAGE_URL: uma referência à imagem de contêiner que contém o pool de workers, comous-docker.pkg.dev/cloudrun/container/worker-pool:latest.- INSTANCE_COUNT: o número de instâncias do pool de workers.
Isso define o pool de workers para escalonamento manual. Especifique um valor de
0para desativar o pool de workers.
API REST
Para atualizar o número de instâncias de um determinado pool de workers, envie uma solicitação HTTP PATCH para o endpoint workerPools.patch da API Cloud Run Admin:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X PATCH \ -d '{"scaling":{"scalingMode":"MANUAL","manualInstanceCount":INSTANCE_COUNT}}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.scalingMode,scaling.manualInstanceCount
Substitua:
- ACCESS_TOKEN: um token de acesso válido para uma conta que
tem as permissões do IAM para atualizar um pool de workers.
Por exemplo, se você fez login em
gcloud, é possível recuperar um token de acesso usandogcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner. - INSTANCE_COUNT: o número de instâncias do pool de workers.
- PROJECT_ID: o ID do projeto do Google Cloud .
- REGION: a região do Google Cloud em que o pool de workers está implantado.
- WORKER_POOL: o nome do pool de workers.
Ver a configuração de escalonamento de um pool de workers
No console do Google Cloud , acesse o Cloud Run:
Clique em Pools de workers para exibir a lista de pools de workers implantados.
Clique no pool de workers que você quer examinar para exibir o painel de detalhes.
A configuração de escalonamento atual é mostrada acima da lista de revisões de pools de workers: Escalonamento: manual (instâncias: ).
Desativar um pool de workers
Para desativar um pool de workers, execute o seguinte comando com a flag
--scaling=0:
gcloud beta run worker-pools update WORKER_POOL --scaling=0
Substitua WORKER_POOL pelo nome do pool de workers.