Configure limites de CPU para tarefas

Esta página descreve como especificar o número de CPUs a usar para cada instância do Cloud Run. Por predefinição, as instâncias de contentores do Cloud Run estão limitadas a 1 CPU. Pode aumentar ou diminuir este valor, conforme descrito nesta página.

Defina e atualize os limites de CPU

Por predefinição, cada instância está limitada a 1 CPU. Pode alterar esta opção para qualquer um dos valores apresentados na tabela seguinte.

Tabela de CPU e memória

Seguem-se os requisitos mínimos de memória para CPUs:

CPUs Memória mínima
1 512 MiB
2 512 MiB
4 2 GiB
6 4 GiB
8 4 GiB

Funções necessárias

Para receber as autorizações de que precisa para configurar tarefas do Cloud Run, peça ao seu administrador para lhe conceder as seguintes funções de IAM:

Para ver uma lista de funções e autorizações de IAM associadas ao Cloud Run, consulte os artigos Funções de IAM do Cloud Run e Autorizações de IAM do Cloud Run. Se a sua tarefa do Cloud Run interagir com Google Cloud APIs, como as bibliotecas de cliente da Google Cloud, consulte o guia de configuração da identidade do serviço. Para mais informações sobre a atribuição de funções, consulte as autorizações de implementação e faça a gestão do acesso.

Configure os limites de CPU

Tem de definir, pelo menos, 1 CPU para uma tarefa do Cloud Run.

Para especificar a CPU para uma tarefa do Cloud Run:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas do Cloud Run:

    Aceda ao Cloud Run

  2. Selecione Tarefas no menu e clique em Implementar contentor para preencher a página de definições iniciais da tarefa. Se estiver a configurar uma tarefa existente, selecione a tarefa e, de seguida, clique em Editar.

  3. Clique em Recipientes, volumes, ligações, segurança para expandir a página de propriedades da tarefa.

  4. Clique no separador Geral.

    imagem

    • Selecione o limite de CPU pretendido na lista pendente. Selecione um valor de 1, 2, 4, 6 ou 8 CPUs. As tarefas requerem, no mínimo, 1 CPU. (Consulte a tabela em Definir e atualizar limites de CPU para ver as definições necessárias.)

  5. Clique em Criar ou Atualizar.

gcloud

  1. Atualize os limites de CPU de uma determinada tarefa através do seguinte comando:

    gcloud run jobs update JOB_NAME --cpu CPU

    Substituir

    • JOB_NAME com o nome do seu trabalho
    • CPU com o limite de CPU pretendido. Especifique o valor 1, 2, 4, 6 ou 8 CPUs. As tarefas requerem, no mínimo, 1 CPU. (Consulte a tabela em Definir e atualizar limites de CPU para ver as definições necessárias.)

    Também pode definir a CPU quando criar uma tarefa através do comando:

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

    Substituir

    • JOB_NAME com o nome do seu trabalho.
    • IMAGE_URL: uma referência à imagem do contentor, por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • CPU com o limite de CPU pretendido. Especifique o valor 1, 2, 4, 6 ou 8 CPUs. As tarefas requerem, no mínimo, 1 CPU. (Consulte a tabela em Definir e atualizar limites de CPU para ver as definições necessárias.)

YAML

  1. Se estiver a criar uma nova tarefa, ignore este passo. Se estiver a atualizar uma tarefa existente, transfira a respetiva configuração YAML:

    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 pretendido. Especifique o valor 1, 2, 4, 6 ou 8 CPUs. As tarefas requerem, no mínimo, 1 CPU. (Consulte a tabela em Definir e atualizar limites de CPU para ver as definições necessárias.)

    Também pode especificar mais configurações, como variáveis de ambiente ou limites de memória.

  3. Atualize a configuração da tarefa existente:

    gcloud run jobs replace job.yaml

Terraform

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

Adicione o seguinte a um recurso google_cloud_run_v2_job na sua 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"
            }
          }
        }
      }
    }
  }

Substituir:

  • REGION com a região Google Cloud . Por exemplo, europe-west1.
  • CPU com o limite de memória necessário do seu serviço. Especifique o valor 1, 2, 4, 6 ou 8 CPUs. As tarefas requerem, no mínimo, 1 CPU. (Consulte a tabela em Definir e atualizar limites de CPU para ver as definições necessárias.)

Veja as definições da CPU

Para ver as definições atuais da CPU para a sua tarefa do Cloud Run:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas do Cloud Run:

    Aceda às tarefas do Cloud Run

  2. Clique no trabalho que lhe interessa para abrir a página Detalhes do trabalho.

  3. Clique em Ver e editar configuração da tarefa.

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

gcloud

  1. Use o seguinte comando:

    gcloud run jobs describe JOB_NAME

  2. Localize a definição da CPU na configuração devolvida.