Nesta página, descrevemos como especificar o número de CPUs a serem usadas para cada instância do Cloud Run. Por padrão, as instâncias de contêiner do Cloud Run estão limitadas a 1 instância de CPU. É possível aumentar ou diminuir esse valor conforme descrito nesta página.
Definir e atualizar os limites de CPU
Por padrão, cada instância é limitada a 1 CPU. É possível aumentar isso usando qualquer valor inteiro até um máximo de 8 CPUs.
CPU e memória
Veja a seguir os requisitos mínimos de memória para CPUs:
CPUs | Memória mínima |
---|---|
4 | 2 GiB |
6 | 4 GiB |
8 | 4 GiB |
Funções exigidas
Para receber as permissões necessárias para configurar os jobs 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 job 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 job do Cloud Run interagir com APIs do Google 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 limites de CPU
É preciso definir no mínimo 1 CPU para um job do Cloud Run.
Para especificar a CPU de um job do Cloud Run, faça o seguinte:
Console
No console do Google Cloud, acesse a página de jobs do Cloud Run:
Se você estiver configurando um novo job, clique na guia Jobs e preencha a página inicial de configurações do job conforme quiser. Se você estiver configurando um job, clique nele e em Editar.
Clique em Contêiner, variáveis e secrets, conexões e segurança para expandir a página de propriedades do job.
Clique na guia Geral.
- Selecione o limite de CPU que você quer na lista
suspensa. Selecione um valor de CPUs
1
,2
,4
,6
ou8
. Os jobs exigem no mínimo 1 CPU. Consulte a tabela em Como configurar e atualizar limites de CPU para as configurações necessárias.
- Selecione o limite de CPU que você quer na lista
suspensa. Selecione um valor de CPUs
Clique em Criar ou Atualizar.
Linha de comando
Atualize os limites de CPU de um determinado job usando o seguinte comando:
gcloud run jobs update JOB_NAME --cpu CPU
Substituir
- JOB_NAME pelo nome do job;
- CPU pelo limite de CPU desejado. Especifique o valor das CPUs
1
,2
,4
,6
ou8
. Os jobs exigem no mínimo 1 CPU. Consulte a tabela em Como configurar e atualizar limites de CPU para as configurações necessárias.
Também é possível definir a CPU ao criar um job usando o comando:
gcloud run jobs create JOB_NAME --image IMAGE_URL --cpu CPU
Substituir
- JOB_NAME pelo nome do job;
- IMAGE_URL por uma referência à imagem de contêiner. Por
exemplo,
us-docker.pkg.dev/cloudrun/container/job:latest
; - CPU pelo limite de CPU desejado. Especifique o valor das CPUs
1
,2
,4
,6
ou8
. Os jobs exigem no mínimo 1 CPU. Consulte a tabela em Como configurar e atualizar limites de CPU para as configurações necessárias.
YAML
Faça o download e consulte a configuração do job que já existe usando o comando gcloud run jobs describe --format export
, que gera resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run jobs replace
.
Modifique os campos somente conforme documentado.
Para visualizar e fazer o download da configuração:
gcloud run jobs describe JOB_NAME --format export > job.yaml
Atualize o atributo
cpu
:apiVersion: run.googleapis.com/v1 kind: Job metadata: name: JOB spec: template: spec: template: spec: containers: - image: IMAGE resources: limits: cpu: CPU
Substitua CPU pelo limite de CPU desejado. Especifique o valor de
1
,2
,4
,6
ou8
CPUs. Os jobs exigem no mínimo 1 CPU. Consulte a tabela em Como configurar e atualizar limites de CPU para as configurações necessárias.Também é possível definir outras configurações, como variáveis de ambiente ou limites de memória.
Atualize a configuração do job que já existe:
gcloud run jobs replace job.yaml
Ver configurações da CPU
Para ver as configurações atuais da CPU do job do Cloud Run:
Console
No console do Google Cloud, acesse a página de jobs do Cloud Run:
Clique no job em que você tem interesse para abrir a página Detalhes do job.
Clique na guia Configuração.
Localize a definição da CPU nos detalhes da configuração.
Linha de comando
Use o comando a seguir:
gcloud run jobs describe JOB_NAME
Localize a configuração de CPU na configuração retornada.