Configurar limites de CPU para jobs

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.

Observação: ao selecionar um limite de vCPU maior que 1, considere o modelo de threading do aplicativo. Se o aplicativo for de linha única, ele poderá usar apenas uma vCPU por completo.

Quantidade máxima de vCPU

O número máximo de vCPUs que você pode configurar é 8.

Quantidade mínima de vCPU

A configuração mínima de vCPU é 0,08 vCPU.

Se você quiser usar menos de 1 vCPU, selecione qualquer valor entre 0,08 e 1, em incrementos de 0,001.

Se você usar menos de uma vCPU, os seguintes requisitos serão aplicados:

Configuração	Requisito
Memória	É necessário um mínimo de 0,5 vCPU para definir um limite de memória maior que 512 MiB. É necessário um mínimo de 1 vCPU para definir um limite de memória maior que 1 GiB.
Simultaneidade	A simultaneidade máxima precisa ser definida como 1.
Faturamento	As configurações de faturamento precisam ser definidas como faturamento com base em solicitações.
Contêineres	É necessário implantar vários contêineres (arquivos secundários).

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 de recursos pode aumentar seus custos. Para determinar qual configuração de CPU é a melhor para seu recurso:

1. Estabeleça uma configuração inicial de referência para um limite de CPU que equilibre a utilização e os custos da CPU.
2. Monitore as métricas de utilização da CPU no Cloud Monitoring enquanto testa o sistema sob carga.
3. Ajuste a configuração da CPU conforme necessário.

Se a utilização da CPU for consistentemente baixa sob carga máxima, considere reduzir a alocação de vCPUs. Se a latência estiver alta, considere aumentar a alocação de vCPU.

Você pode conferir dados de custo resumidos, dados de utilização e 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 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 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 job 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.

Configurar limites de CPU

É preciso definir no mínimo 1 CPU para um job do Cloud Run.

É possível configurar limites de CPU para um job do Cloud Run usando o Google Cloud console, a CLI gcloud, o YAML ou o Terraform:

Console

1. No console Google Cloud , acesse a página do Cloud Run:

   Acessar o Cloud Run

2. Selecione Jobs no menu de navegação do Cloud Run:

   1. Se você estiver criando um job, clique em Implantar contêiner para preencher a página inicial de configurações do job.

   2. Se você estiver configurando um job, selecione-o e clique em Ver e editar a configuração do job.

3. Clique em Contêineres, conexões, segurança para expandir a página de propriedades do job.

4. Na guia Contêineres, selecione o limite de CPU na lista CPU. Selecione um valor de CPUs 1, 2, 4, 6 ou 8. 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.

5. Clique em Criar ou Atualizar.

gcloud

• Para definir os limites de CPU ao criar um job, execute o seguinte comando:

  gcloud run jobs create JOB --image IMAGE_URL --cpu CPU

  Substitua:

  • JOB: o nome do seu job do Cloud Run;
  • IMAGE_URL: uma referência à imagem do contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
  • CPU: o limite de CPU. Especifique o valor das CPUs 1, 2, 4, 6 ou 8. 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.

• Para atualizar os limites de CPU de um job atual, execute o seguinte comando:

  gcloud run jobs update JOB --cpu CPU

YAML

1. Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço existente, faça o download da configuração YAML correspondente:

   gcloud run jobs describe JOB --format export > job.yaml

2. Atualize o atributo cpu:

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - image: IMAGE_URL
               resources:
                 limits:
                   cpu: CPU

   Substitua:

   • JOB: o nome do seu job do Cloud Run;
   • IMAGE_URL: uma referência à imagem do contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
   • CPU: o limite de CPU. Especifique o valor das CPUs 1, 2, 4, 6 ou 8. 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.

3. Crie ou atualize o serviço usando o seguinte comando:

   gcloud run jobs replace job.yaml

   Por padrão, o comando gcloud run jobs replace usa o arquivo job.yaml, se ele estiver presente.

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

Adicione o seguinte a um recurso google_cloud_run_v2_job na configuração do Terraform:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB"
  location = "REGION"
  deletion_protection = false

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
        resources {
          limits = {
            cpu    = "CPU"
          }
        }
      }
    }
  }
}

Substitua:

• JOB: o nome do seu job do Cloud Run;
• REGION: a Google Cloud região. Por exemplo, europe-west1.
• CPU: o limite de CPU. Especifique o valor das CPUs 1, 2, 4, 6 ou 8. 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.

Ver configurações da CPU

Para ver as configurações atuais da CPU do job do Cloud Run, use o console Google Cloud ou a Google Cloud CLI:

Console

1. No console do Google Cloud , acesse a página de jobs do Cloud Run:

   Acessar jobs do Cloud Run

2. Clique no job para abrir a página Detalhes do job.

3. Clique em Ver e editar a configuração do job.

4. Localize a definição da CPU nos detalhes da configuração.

gcloud

1. Execute este comando:

   gcloud run jobs describe JOB

2. Localize a configuração de CPU na configuração retornada.