Definir e atualizar os limites de vCPU
Tabela de vCPU e memória
Confira a seguir os requisitos de memória para vCPUs:
| CPUs | Memória necessária |
|---|---|
| 1 vCPU | 512 MiB a 4 GiB |
| 2 vCPU | 512 MiB a 8 GiB |
| 4 vCPUs | 2 a 16 GiB |
| 6 vCPU | 4 a 24 GiB |
| 8 vCPUs | 4 a 32 GiB |
Valores maiores que 1 precisam ser números inteiros.
Quantidade máxima de vCPU
A quantidade máxima de vCPU que você pode configurar é 8 vCPU.
Quantidade mínima de vCPU
A configuração mínima é de 1 vCPU.
Considerações sobre o custo
O custo do seu recurso do Cloud Run é afetado pela configuração de CPU e pelo tempo de atividade do recurso, entre outros fatores. O superprovisionamento dos recursos pode aumentar seus custos. Para determinar qual configuração de CPU é a melhor para seu recurso:
- Estabeleça uma configuração inicial de referência para um limite de CPU que equilibre a utilização e os custos da CPU.
- Monitore as métricas de utilização da CPU no Cloud Monitoring enquanto testa o sistema sob carga.
- Ajuste a configuração da CPU conforme necessário.
Se o uso da CPU for consistentemente baixo sob carga máxima, considere reduzir a alocação de vCPUs. Se a latência for alta, considere aumentar a alocação de vCPUs.
Você pode conferir dados resumidos de custo e utilização, além de recomendações de otimização de custos para recursos na página de otimização do Cloud Hub. Consulte os preços do Cloud Run ou calcule os custos com a calculadora de preços para mais informações.
Funções exigidas
Para receber as permissões necessárias para configurar e implantar pools de trabalhadores 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 worker do Cloud Run - Usuário da conta de serviço (
roles/iam.serviceAccountUser) na identidade do 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 trabalhadores do Cloud Run interagir com APIsGoogle 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.
Configurar limites de CPU
Qualquer mudança na configuração leva à criação de uma nova revisão. As próximas revisões também recebem automaticamente essa configuração, a menos que você faça atualizações explícitas para alterá-la.
É possível definir limites de CPU para um pool de trabalhadores do Cloud Run usando o consoleGoogle Cloud , a Google Cloud CLI, o YAML ou o Terraform:
Console
No console Google Cloud , acesse a página do Cloud Run:
Selecione Pools de trabalhadores no menu de navegação do Cloud Run:
Se você estiver configurando um pool de workers, clique nele e em Editar e implantar nova revisão.
Se você estiver configurando um novo pool de workers, clique em Implantar contêiner e preencha a página inicial do pool de workers. Em seguida, clique em Contêineres, Rede, segurança para expandir a página de configuração dos pools de workers.
Clique na guia Contêineres.
Selecione o limite de CPU na lista CPU.
Clique em Criar ou Implantar.
gcloud
É possível atualizar os limites de CPU de um determinado pool de workers usando o seguinte comando:
gcloud run worker-pools update WORKER_POOL --cpu CPU
Substituir
- WORKER_POOL com o nome do pool de workers
- CPU com o limite de CPU. Especifique o valor de
1,2,4,6ou8CPUs, seguindo os requisitos mostrados na tabela CPU e memória.
Também é possível definir o limite de CPU durante a implantação usando este comando:
gcloud run worker-pools deploy --image IMAGE_URL --cpu CPU
Substituir
IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, comous-docker.pkg.dev/cloudrun/container/worker-pool:latest.- CPU com o valor
1,2,4,6ou8CPUs, seguindo os requisitos mostrados na tabela CPU e memória.
YAML
Se você estiver criando um novo pool de workers, pule esta etapa. Se você estiver atualizando um pool de trabalhadores, faça o download da configuração YAML correspondente:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
O exemplo a seguir contém a configuração YAML:
apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL spec: template: spec: containers: - image: IMAGE_URL resources: limits: cpu: `CPU`
Substitua:
- WORKER_POOL: o nome do seu pool de workers do Cloud Run.
IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, comous-docker.pkg.dev/cloudrun/container/worker-pool:latest.- CPU: o valor do limite de CPU.
Especifique o valor de
1,2,4,6ou8CPUs. Para menos de uma CPU, especifique um valor de 0,08 a menos de 1,00, em incrementos de 0,01. Consulte a tabela em Como configurar e atualizar limites de CPU para as configurações necessárias.
Crie ou atualize o pool de workers usando o seguinte comando:
gcloud run worker-pools replace worker-pool.yaml
Por padrão, o comando
gcloud run worker-pools replaceusa o arquivoworker-pool.yaml, 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"
resources {
limits = {
cpu = "CPU"
}
}
}
}
}
Substitua:
- WORKER_POOL com o nome do pool de workers.
- REGION com a região Google Cloud . Por exemplo, europe-west1.
IMAGE_URL: uma referência à imagem de contêiner que contém o pool de trabalhadores, comous-docker.pkg.dev/cloudrun/container/worker-pool:latest- CPU com o valor
1,2,4,6ou8CPUs, seguindo os requisitos mostrados na tabela CPU e memória.
Ver a configuração da CPU para o pool de workers
No Google Cloud console, acesse o Cloud Run:
Clique em Pools de workers para mostrar a lista de pools de workers implantados.
Clique no pool de workers que você quer examinar para mostrar o painel de detalhes.
Clique na guia Contêineres para mostrar a configuração de CPU do pool de workers.