Configurar límites de CPU para grupos de trabajadores

En esta página se describe cómo especificar el número de vCPUs que se van a usar en cada instancia de Cloud Run. De forma predeterminada, las instancias de contenedor de Cloud Run están limitadas a 1 vCPU. Puede aumentar o reducir este valor tal como se describe en esta página.

Definir y actualizar límites de vCPUs

De forma predeterminada, cada instancia está limitada a 1 vCPU. Puedes cambiarlo por cualquiera de los valores que se muestran en la siguiente tabla.

Tabla de vCPUs y memoria

A continuación se indican los requisitos de memoria de las vCPUs:

CPUs Memoria necesaria
1 vCPU De 128 MiB a 4 GiB
2 vCPUs De 128 MiB a 8 GiB
4 vCPUs Entre 2 y 16 GiB
6 vCPUs Entre 4 y 24 GiB
8 vCPUs De 4 a 32 GiB

Cantidad máxima de vCPUs

El número máximo de vCPUs que puedes configurar es 8.

Cantidad mínima de vCPUs

El ajuste mínimo de vCPU es 0,08 vCPU.

Roles obligatorios

Para obtener los permisos que necesitas para configurar e implementar grupos de trabajo de Cloud Run, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Para ver una lista de los roles y permisos de gestión de identidades y accesos asociados a Cloud Run, consulta los artículos Roles de gestión de identidades y accesos de Cloud Run y Permisos de gestión de identidades y accesos de Cloud Run. Si tu grupo de trabajadores de Cloud Run interactúa con APIs, como las bibliotecas de cliente de Cloud, consulta la guía de configuración de identidades de servicio.Google Cloud Para obtener más información sobre cómo conceder roles, consulta los artículos sobre permisos de implementación y gestión del acceso.

Configurar límites de CPU

Cualquier cambio en la configuración conlleva la creación de una nueva revisión. Las revisiones posteriores también recibirán automáticamente este ajuste de configuración, a menos que hagas cambios explícitos para modificarlo.

Puedes definir límites de CPU para un grupo de trabajadores de Cloud Run mediante laGoogle Cloud consola, la CLI de Google Cloud, YAML o Terraform:

Consola

  1. En la Google Cloud consola, ve a Cloud Run:

    Ir a Cloud Run

  2. Selecciona Grupos de trabajadores en el menú y haz clic en Implementar contenedor para configurar un nuevo grupo de trabajadores. Si vas a configurar un grupo de trabajadores que ya existe, haz clic en él y, a continuación, en Editar y desplegar nueva revisión.

  3. Si vas a configurar un grupo de trabajadores, rellena la página inicial del grupo de trabajadores y, a continuación, haz clic en Contenedores, volúmenes, redes y seguridad para desplegar la página de configuración del grupo de trabajadores.

  4. Haga clic en la pestaña Contenedor.

    imagen

    • Selecciona el límite de CPU en la lista desplegable CPU.

  5. Haz clic en Crear o en Implementar.

gcloud

Para actualizar los límites de CPU de un grupo de trabajadores, usa el siguiente comando:

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

Sustituir

  • WORKER_POOL con el nombre de tu grupo de trabajadores
  • CPU con el límite de CPU. Especifica el valor 1, 2, 4, 6 o 8 CPUs, siguiendo los requisitos que se muestran en la tabla CPU y memoria.

También puedes definir la CPU durante la implementación con el siguiente comando:

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

Sustituir

  • IMAGE_URL: referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • CPU con el valor 1, 2, 4, 6 o 8 CPUs, siguiendo los requisitos que se muestran en la tabla CPU y memoria.

YAML

  1. Si vas a crear un grupo de trabajadores, omite este paso. Si vas a actualizar un grupo de trabajadores, descarga su configuración YAML:

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

  2. En el ejemplo siguiente se muestra la configuración de 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`

    Haz los cambios siguientes:

    • WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run.
    • IMAGE_URL: referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
    • CPU: el valor del límite de CPU. Especifica el valor 1, 2, 4, 6 o 8 CPUs. Si quieres especificar menos de 1 CPU, indica un valor entre 0,08 y menos de 1,00, en incrementos de 0,01. Consulta la tabla de la sección Definir y actualizar los límites de CPU para ver los ajustes obligatorios.

  3. Crea o actualiza el grupo de trabajadores con el siguiente comando:

    gcloud beta run worker-pools replace workerpool.yaml

Terraform

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de 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"
        }
      }
    }
  }
}

Sustituye:

  • WORKER_POOL con el nombre del grupo de trabajadores.
  • REGION con la región Google Cloud . Por ejemplo, europe-west1.
  • IMAGE_URL: una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • CPU con el valor 1, 2, 4, 6 o 8 CPUs, siguiendo los requisitos que se muestran en la tabla CPU y memoria.

Ver la configuración de CPU del grupo de trabajadores

  1. En la Google Cloud consola, ve a Cloud Run:

    Ir a Cloud Run

  2. Haz clic en Grupos de trabajadores para ver la lista de grupos de trabajadores implementados.

  3. Haz clic en el grupo de trabajadores que quieras examinar para que se muestre su panel de detalles.

  4. Haz clic en la pestaña Contenedores para ver la configuración de CPU del grupo de trabajadores.