Configure limites de CPU para pools de trabalhadores

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 128 MiB
2 128 MiB
4 2 GiB
6 4 GiB
8 4 GiB

Funções necessárias

Para receber as autorizações de que precisa para configurar e implementar pools de trabalhadores do Cloud Run, peça ao seu administrador para lhe conceder as seguintes funções da 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 o seu conjunto de trabalhadores do Cloud Run interage com Google Cloud APIs, como as bibliotecas de clientes da nuvem, 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

Qualquer alteração de configuração leva à criação de uma nova revisão. As revisões subsequentes também vão receber automaticamente esta definição de configuração, a menos que faça atualizações explícitas para a alterar.

Pode definir limites de CPU para um conjunto de trabalhadores do Cloud Run através da Google Cloud consola, da CLI Google Cloud, de YAML ou do Terraform:

Consola

  1. Na Google Cloud consola, aceda ao Cloud Run:

    Aceda ao Cloud Run

  2. Selecione Grupos de trabalhadores no menu e clique em Implementar contentor para configurar um novo grupo de trabalhadores. Se estiver a configurar um conjunto de trabalhadores existente, clique no conjunto de trabalhadores e, de seguida, em Editar e implementar nova revisão.

  3. Se estiver a configurar um novo conjunto de trabalhadores, preencha a página inicial do conjunto de trabalhadores e, em seguida, clique em Recipientes, volumes, rede, segurança para expandir a página de configuração dos conjuntos de trabalhadores.

  4. Clique no separador Contentor.

    imagem

    • Selecione o limite da CPU na lista pendente CPU.

  5. Clique em Criar ou Implementar.

gcloud

Pode atualizar os limites da CPU para um determinado conjunto de trabalhadores através do seguinte comando:

gcloud beta run worker-pools update WORKER_POOL --cpu CPU

Substituir

  • WORKER_POOL com o nome do seu conjunto de trabalhadores
  • CPU com o limite de CPU. Especifique o valor 1, 2, 4, 6 ou 8 CPUs, seguindo os requisitos apresentados na tabela CPU e memória.

Também pode definir a CPU durante a implementação através do comando:

gcloud beta run worker-pools deploy --image IMAGE_URL --cpu CPU

Substituir

  • IMAGE_URL: uma referência à imagem do contentor que contém o conjunto de trabalhadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • CPU com o valor 1, 2, 4, 6 ou 8 CPUs, seguindo os requisitos apresentados na tabela CPU e memória.

YAML

  1. Se estiver a criar um novo conjunto de trabalhadores, ignore este passo. Se estiver a atualizar um worker pool existente, transfira a respetiva configuração YAML:

    gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. O exemplo seguinte contém a configuração YAML:

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
        resources:
          limits:
            cpu: `CPU`

    Substitua o seguinte:

    • WORKER_POOL: o nome do seu conjunto de trabalhadores do Cloud Run.
    • IMAGE_URL: uma referência à imagem do contentor que contém o conjunto de trabalhadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
    • CPU: o valor do limite da CPU. Especifique o valor 1, 2, 4, 6 ou 8 CPUs ou, para menos de 1 CPU, especifique um valor de 0,08 a menos de 1,00, em incrementos de 0,01. (Consulte a tabela em Definir e atualizar limites de CPU para ver as definições necessárias.)

  3. Crie ou atualize o conjunto de trabalhadores com o seguinte comando:

    gcloud beta run worker-pools replace workerpool.yaml

Terraform

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

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
      resources {
        limits = {
          cpu = "CPU"
        }
      }
    }
  }
}

Substituição:

  • WORKER_POOL com o nome do grupo de trabalhadores.
  • REGION com a região Google Cloud . Por exemplo, europe-west1.
  • IMAGE_URL: uma referência à imagem do contentor que contém o conjunto de trabalhadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • CPU com o valor 1, 2, 4, 6 ou 8 CPUs, seguindo os requisitos apresentados na tabela CPU e memória.

Veja a configuração da CPU para o conjunto de trabalhadores

  1. Na Google Cloud consola, aceda ao Cloud Run:

    Aceda ao Cloud Run

  2. Clique em Grupos de trabalhadores para apresentar a lista de grupos de trabalhadores implementados.

  3. Clique no conjunto de trabalhadores que quer examinar para apresentar o respetivo painel de detalhes.

  4. Clique no separador Recipientes para apresentar a configuração da CPU para o conjunto de trabalhadores.