Configurar limites de CPU para jobs

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 mudar para qualquer um dos valores mostrados na tabela a seguir.

Tabela de CPU e memória

Veja a seguir os requisitos de memória para CPUs:

CPUs Memória necessária
1 vCPU 128 MiB a 4 GiB
2 vCPU 128 MiB a 8 GiB
4 vCPUs 2 a 16 GiB
6 vCPU 4 a 24 GiB
8 vCPUs 4 a 32 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:

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.

Para especificar a CPU de um job do Cloud Run, faça o seguinte:

Console

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

    Acessar o Cloud Run

  2. Selecione Jobs no menu e clique em Implantar contêiner para preencher a página inicial de configurações do job. Se você estiver configurando um job, selecione-o e clique em Ver e editar a configuração do job.

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

  4. Clique na guia Geral.

    imagem

    • Selecione o limite de CPU que você quer na lista suspensa. 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

  1. 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 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.

    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: 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 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.

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_NAME --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
              resources:
                limits:
                  cpu: CPU

    Substitua CPU pelo limite de CPU desejado. Especifique o valor de 1, 2, 4, 6 ou 8 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.

  3. Atualize a configuração do job que já existe:

    gcloud run jobs replace job.yaml

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     = "cloudrun-job"
    location = "REGION"
    deletion_protection = false

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

Substitua:

  • REGION com a região Google Cloud . Por exemplo, europe-west1.
  • CPU pelo limite de memória necessário do serviço. 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:

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 em que você tem interesse para abrir a página Detalhes do job.

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

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

gcloud

  1. Use o comando a seguir:

    gcloud run jobs describe JOB_NAME
  2. Localize a configuração de CPU na configuração retornada.