Configura los límites de CPU para los trabajos

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.

Establece 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 requerida
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 valores enteros.

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 0.08 CPU virtuales.

Si deseas usar menos de 1 CPU virtual, puedes seleccionar cualquier valor entre 0.08 y 1, en incrementos de 0.001.

Si usas menos de 1 CPU virtual, se aplican los siguientes requisitos:

Configuración Requisito
Memoria Se necesita un mínimo de 0.5 CPU virtuales para establecer un límite de memoria superior a 512 MiB.
Se necesita un mínimo de 1 CPU virtual para establecer un límite de memoria superior a 1 GiB.
Simultaneidad La simultaneidad máxima debe configurarse en 1.
Facturación La configuración de facturación debe establecerse en facturación basada en solicitudes.
Contenedores Debes implementar varios contenedores (sidecars).

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 durante la 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 los trabajos de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:

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 trabajo de Cloud Run interactúa con Google Cloud las 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 permisos de implementación y administra el acceso.

Configura los límites de CPU

Debes establecer un mínimo de 1 CPU para un trabajo de Cloud Run.

A fin de especificar la CPU para un trabajo de Cloud Run, haz lo siguiente:

Console

  1. En la Google Cloud consola, ve a la página Trabajos de Cloud Run:

    Ir a Cloud Run

  2. Haz clic en Implementar contenedor para completar la página de configuración inicial del trabajo. Si configuras un trabajo existente, selecciónalo y, luego, haz clic en Ver y editar la configuración del trabajo.

  3. Haz clic en Contenedores, conexiones y seguridad para expandir la página de propiedades del trabajo.

  4. Haz clic en la pestaña General.

    imagen

    • Selecciona el límite de CPU que desees de la lista desplegable. Selecciona un valor de CPU 1, 2, 4, 6 o 8. Los trabajos requieren un mínimo de 1 CPU. (Consulta la tabla en Configura y actualiza los límites de CPU para obtener la configuración necesaria).
  5. Haz clic en Crear o Actualizar.

gcloud

  1. Actualiza los límites de CPU de un trabajo determinado mediante el siguiente comando:

    gcloud run jobs update JOB_NAME --cpu CPU

    Reemplazar

    • JOB_NAME por el nombre de tu trabajo
    • CPU por el límite de CPU deseado. Especifica el valor 1, 2, 4, 6 o 8 CPU. Los trabajos requieren un mínimo de 1 CPU. (Consulta la tabla en Configura y actualiza los límites de CPU para obtener la configuración necesaria).

    También puedes configurar la CPU cuando creas un trabajo con el comando siguiente:

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

    Reemplazar

    • JOB_NAME por el nombre de tu trabajo.
    • IMAGE_URL: Una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • CPU por el límite de CPU deseado. Especifica el valor 1, 2, 4, 6 o 8 CPU. Los trabajos requieren un mínimo de 1 CPU. (Consulta la tabla en Configura y actualiza los límites de CPU para obtener la configuración necesaria).

YAML

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

    gcloud run jobs describe JOB_NAME --format export > job.yaml
  2. Actualiza el atributo cpu:

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB
    spec:
      template:
        spec:
          template:
            spec:
              containers:
              - image: IMAGE
              resources:
                limits:
                  cpu: CPU

    Reemplaza CPU por el límite de CPU deseado. Especifica el valor 1, 2, 4, 6 o 8 CPU. Los trabajos requieren un mínimo de 1 CPU. (Consulta la tabla en Configura y actualiza los límites de CPU para obtener la configuración necesaria).

    También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.

  3. Actualiza la configuración del trabajo existente:

    gcloud run jobs replace job.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.

Agrega lo siguiente a un google_cloud_run_v2_job recurso en la configuración de 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"
            }
          }
        }
      }
    }
  }

Reemplaza lo siguiente:

  • REGION por la Google Cloud región. Por ejemplo, europe-west1.
  • CPU por el límite de memoria requerido de tu servicio. Especifica el valor 1, 2, 4, 6, o 8 CPU. Los trabajos requieren un mínimo de 1 CPU. (Consulta la tabla en Configura y actualiza los límites de CPU para obtener la configuración necesaria).

Visualiza la configuración de CPU

Para ver la configuración actual de la CPU de tu trabajo de Cloud Run, sigue estos pasos:

Console

  1. En la Google Cloud consola, ve a la página de trabajos de Cloud Run:

    Ir a Trabajos de Cloud Run

  2. Haz clic en el trabajo que te interesa para abrir la página Detalles del trabajo.

  3. Haz clic en Ver y editar la configuración del trabajo.

  4. Ubica la configuración de la CPU en los detalles de configuración.

gcloud

  1. Usa el siguiente comando:

    gcloud run jobs describe JOB_NAME
  2. Busca la configuración de CPU en la configuración mostrada.