Configura los límites de CPU para los grupos de trabajadores

Versión preliminar : Grupos de trabajadores de Cloud Run

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se describe cómo especificar la cantidad de CPU virtuales que se usará a cada instancia de Cloud Run. De forma predeterminada, las instancias de contenedor de Cloud Run están limitadas a 1 CPU virtual. Puedes aumentar o disminuir este valor como se describe en esta página.

Configura y actualiza los límites de CPU virtuales

De forma predeterminada, cada instancia está limitada a 1 CPU virtual. Puedes cambiar esto a cualquiera de los valores que se muestran en la siguiente tabla.

Tabla de CPU virtuales y memoria

A continuación, se describen los requisitos de memoria para las CPU virtuales:

CPU	Memoria necesaria
1 CPU virtual	128 MiB a 4 GiB
2 CPU virtuales	128 MiB a 8 GiB
4 CPU virtuales	2 a 16 GiB
6 CPU virtuales	4 a 24 GiB
8 CPU virtuales	4 a 32 GiB

Los valores superiores a 1 deben ser números enteros.

Nota: Cuando selecciones un límite de CPU virtuales superior a 1 CPU virtual, ten en cuenta el modelo de subprocesos de tu aplicación. Si tu aplicación tiene un solo subproceso, es posible que solo use una CPU virtual por completo.

Cantidad máxima de CPU virtuales

La cantidad máxima de CPU virtuales que puedes configurar es de 8 CPU virtuales.

Cantidad mínima de CPU virtuales

El parámetro de configuración mínimo de CPU virtuales es de 1 CPU virtual.

Consideraciones de costo

El costo de tu recurso de Cloud Run se ve afectado por su configuración de CPU y el tiempo que está activo, entre otros factores. El aprovisionamiento excesivo de tus recursos puede aumentar tus costos. Para determinar qué configuración de CPU podría ser la mejor para tu recurso, haz lo siguiente:

1. Establece una configuración inicial de referencia para un límite de CPU que equilibre el uso y los costos de la CPU.
2. Supervisa las métricas de uso de la CPU en Cloud Monitoring mientras pruebas el sistema bajo carga.
3. Ajusta la configuración de la CPU según sea necesario.

Si el uso de la CPU es constantemente bajo bajo carga máxima, considera reducir la asignación de CPU virtuales. Si la latencia es alta, considera aumentar la asignación de CPU virtuales.

Puedes ver datos de costos resumidos, datos de uso y recomendaciones de optimización de costos para los servicios en la página Optimización de Cloud Hub. Revisa los precios de Cloud Run o estima los costos con la calculadora de precios para obtener más información.

Roles obligatorios

Para obtener los permisos que necesitas para configurar y, luego, implementar los grupos de trabajadores de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Desarrollador de Cloud Run (roles/run.developer) en el grupo de trabajadores de Cloud Run
• Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) en la identidad del servicio

Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu grupo de trabajadores de Cloud Run interactúa con lasGoogle Cloud APIs, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información sobre cómo otorgar roles, consulta los permisos de implementación y cómo administrar el acceso.

Configura los límites de CPU

Cualquier cambio en la configuración conlleva la creación de una revisión nueva. Las revisiones posteriores también adoptarán esta configuración de manera automática, a menos que realices actualizaciones explícitas para cambiarla.

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

Console

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

   Ir a Cloud Run

2. Selecciona Grupos de trabajadores en el menú y haz clic en Implementa un contenedor para configurar un grupo de trabajadores nuevo. Si quieres configurar un grupo de trabajadores existente, haz clic en el grupo de trabajadores y, luego, en Editar e implementar una nueva revisión.

3. Si configuras un grupo de trabajadores nuevo, completa la página inicial del grupo de trabajadores y, luego, haz clic en Contenedores, Herramientas de redes y seguridad para expandir la página de configuración del grupo de trabajadores.

4. Haz clic en la pestaña Contenedor.

   

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

5. Haz clic en Crear o Implementar.

gcloud

Puedes actualizar los límites de CPU para un grupo de trabajadores determinado mediante el siguiente comando:

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

Reemplazar

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

También puedes configurar el valor de CPU durante la implementación mediante el siguiente comando:

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

Reemplazar

• 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 CPU, según los requisitos que se muestran en la tabla de CPU y memoria.

YAML

1. Si creas un grupo de trabajadores nuevo, omite este paso. Si actualizas un grupo de trabajadores existente, descarga su configuración de YAML:

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

2. En el siguiente ejemplo, se incluye 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`

   Reemplaza lo siguiente:

   • WORKER_POOL: El nombre de tu grupo de trabajadores de Cloud Run.
   • 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: El valor límite de CPU. Especifica el valor 1, 2, 4, 6 o 8 CPU, o de menos de 1 CPU, especifica un valor de 0.08 a menos de 1.00, en incrementos de 0.01. (Consulta la tabla en Configura y actualiza los límites de CPU para obtener la configuración necesaria).

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

   gcloud beta run worker-pools replace workerpool.yaml

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los 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"
        }
      }
    }
  }
}

Reemplaza lo siguiente:

• WORKER_POOL por el nombre del grupo de trabajadores.
• REGION por la Google Cloud región. 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 CPU, según los requisitos que se muestran en la tabla de CPU y memoria.

Visualiza la configuración de CPU para el 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 mostrar la lista de grupos de trabajadores implementados.

3. Haz clic en el grupo de trabajadores que deseas examinar para mostrar su panel de detalles.

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

Nota: También puedes usar el comando gcloud beta run worker-pools describe de Google Cloud CLI para ver los detalles de la configuración.