Límites de CPU

En esta página, se describe cómo especificar la cantidad de CPU 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. Puedes aumentar o disminuir este valor como se describe en esta página.

En esta página, también se describe cómo habilitar o inhabilitar el aumento de CPU de inicio, una característica que aumenta de forma temporal la asignación de CPU durante el inicio de la instancia para reducir la latencia de inicio.

Configura y actualiza los límites de CPU

Puedes establecer límites de CPU para los trabajos y servicios de Cloud Run.

De forma predeterminada, cada instancia de contenedor está limitada a 1 CPU. Puedes aumentarlo mediante cualquier valor de número entero hasta un máximo de 8 CPU.

CPU y memoria

A continuación, se describen los requisitos de memoria mínima para las CPU:

CPU Memoria mínima
4 2 GiB
6 3 GiB
8 4 GiB

Como alternativa, solo en los servicios de Cloud Run, si deseas usar menos de 1 CPU, puedes seleccionar cualquier valor entre 0.08 y 1, en incrementos de 0.01. Cualquier valor superior a 1 debe ser un valor de número entero. Si usas menos de 1 CPU, se aplican los siguientes requisitos:

Configuración Requisito
Memoria Se necesita un mínimo de 0.5 CPU para establecer un límite de memoria superior a 512 MiB.
Se necesita un mínimo de 1 CPU para establecer un límite de memoria superior a 1 GiB.
Simultaneidad La simultaneidad máxima debe configurarse en 1.
Asignación de CPU La asignación de CPU debe configurarse en la CPU asignada solo durante el procesamiento de la solicitud.
Entorno de ejecución Debes usar el entorno de ejecución de primera generación.

Para servicios de Cloud Run

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 configurar límites de CPU mediante la consola de Google Cloud, la línea de comandos de gcloud o un archivo YAML cuando creas un servicio nuevo o implementas una revisión nueva:

Console

  1. Ir a Cloud Run

  2. Haz clic en Crear servicio si quieres configurar un servicio nuevo en el que realizarás la implementación. Si quieres configurar un servicio existente, haz clic en el servicio y, luego, en Edit and Deploy New Revision.

  3. Si configuras un servicio nuevo, completa la página de configuración del servicio inicial como desees y haz clic en Contenedor, herramientas de redes, seguridad para expandir la página de configuración del servicio.

  4. Haz clic en la pestaña Contenedor.

    imagen

    • Selecciona el límite de CPU que desees de la lista desplegable, con Personalizado, si deseas usar menos de 1 CPU. Selecciona un valor de 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).
  5. Haz clic en Crear o Implementar.

Línea de comandos

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

gcloud run services update SERVICE --cpu CPU

Reemplazar

  • SERVICE por el nombre de tu servicio
  • CPU por el límite de CPU deseado. 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).

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

gcloud run deploy --image IMAGE_URL --cpu CPU

Reemplaza los siguientes elementos:

  • IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest Cuando se usa Artifact Registry, la URL tiene el siguiente formato: REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. .
  • CPU con el valor 1, 2, 4, 6 o 8 CPU, o de menos de 1 CPU, especifica un valor de 0.08 a menos 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).

YAML

Puedes descargar y ver las configuraciones del servicio existente mediante el comando gcloud run services describe --format export, que genera resultados limpios en formato YAML. Luego, puedes modificar los campos que se describen a continuación y subir el YAML modificado mediante el comando gcloud run services replace. Asegúrate de modificar los campos tal como se indica en la documentación.

  1. Para ver y descargar la configuración, ejecuta el siguiente comando:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Actualiza el atributo cpu:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          name: REVISION
        spec:
          containers:
          - image: IMAGE
            resources:
              limits:
                cpu: CPU

    Reemplazar

    • SERVICE por el nombre del servicio de Cloud Run
    • IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest Cuando se usa Artifact Registry, la URL tiene el siguiente formato: REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • CPU por el valor de límite de CPU deseado 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).
    • REVISION por un nombre de revisión nuevo o bórralo (si está presente). Si proporcionas un nuevo nombre de revisión, debe cumplir con los siguientes criterios:
      • Comienza con SERVICE-
      • Solo contiene letras minúsculas, números y -
      • No termina con -
      • No supera los 63 caracteres
  3. Reemplaza el servicio por la configuración nueva mediante el comando siguiente:

    gcloud run services replace service.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 recurso google_cloud_run_service en la configuración de Terraform, en template.spec.containers. Reemplaza 1000m por el recuento de CPU deseado.

resources {
  limits = {
    # CPU usage limit
    # https://cloud.google.com/run/docs/configuring/cpu
    cpu = "1000m" # 1 vCPU

    # Memory usage limit (per container)
    # https://cloud.google.com/run/docs/configuring/memory-limits
    memory = "512Mi"
  }
}

Para trabajos de Cloud Run

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. Ir a Cloud Run

  2. Si quieres configurar un nuevo trabajo, haz clic en la pestaña Trabajos y completa la página de configuración de trabajo inicial como desees. Si quieres configurar un trabajo existente, haz clic en el trabajo y, luego, en Editar.

  3. Haz clic en Contenedor, variables y secretos, 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.

Línea de comandos

  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 por una referencia a la imagen del contenedor, como 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

Descarga y visualiza la configuración del trabajo existente mediante el comando gcloud run jobs describe --format export, que genera resultados limpios en formato YAML. Luego, modifica los campos que se describen a continuación y sube el YAML modificado mediante el comando gcloud run jobs replace. Asegúrate de modificar los campos tal como se indica en la documentación.

  1. Para ver y descargar la configuración, ejecuta el siguiente comando:

    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

Establecer el aumento de la CPU de inicio (servicios)

La función de aumento de la CPU de inicio para las revisiones proporciona CPU adicional durante el tiempo de inicio de la instancia y durante 10 segundos después de que se haya iniciado la instancia.

El aumento real de CPU varía según la configuración del límite de CPU:

Límite de CPU CPU aumentada
0-1 2
2 1.8
1.8 3.6
2.7 8
8 8

Se te cobra por la CPU aumentada que se asignó mientras dure el tiempo de inicio del contenedor. Por ejemplo, si el tiempo de inicio del contenedor es de 15 segundos y asignas 2 CPU, con el aumento de CPU de inicio, se te cobrará por 4 CPU durante el tiempo de inicio de la instancia (posiblemente más corto), incluidos los 10 segundos después de que tu contenedor haya terminado de iniciarse, y por 2 CPU durante el resto del ciclo de vida del contenedor.

Puedes habilitar o inhabilitar el aumento de CPU de inicio con la consola de Google Cloud o Google Cloud CLI.

Consola

  1. Ir a Cloud Run

  2. Haz clic en Crear servicio si quieres configurar un servicio nuevo en el que realizarás la implementación. Si quieres configurar un servicio existente, haz clic en el servicio y, luego, en Edit and Deploy New Revision.

  3. Si configuras un servicio nuevo, completa la página de configuración del servicio inicial como desees y haz clic en Contenedor, herramientas de redes, seguridad para expandir la página de configuración del servicio.

  4. Haz clic en la pestaña Contenedor.

    imagen

    • Para habilitar el aumento de CPU de inicio, selecciona la casilla de verificación Aumento de CPU de inicio. Para inhabilitar esta función, quita la selección de la casilla de verificación.
  5. Haz clic en Crear o Implementar.

Línea de comandos

  1. Puedes habilitar el aumento de la CPU de inicio para un servicio determinado con el siguiente comando:

    gcloud run services update SERVICE --cpu-boost

    Reemplaza SERVICE por el nombre del servicio

    Puedes habilitar el aumento de la CPU de inicio durante la implementación mediante el siguiente comando:

    gcloud run deploy --image IMAGE_URL --cpu-boost

    Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest. Cuando se usa Artifact Registry, la URL tiene el siguiente formato: REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. .

  2. Puedes inhabilitar el aumento de la CPU de inicio para un servicio determinado mediante el siguiente comando:

    gcloud run services update SERVICE --no-cpu-boost

    Reemplaza SERVICE por el nombre del servicio

    Puedes inhabilitar el aumento de la CPU de inicio durante la implementación mediante el siguiente comando:

    gcloud run deploy --image IMAGE_URL --no-cpu-boost

YAML

Puedes descargar y ver las configuraciones del servicio existente mediante el comando gcloud run services describe --format export, que genera resultados limpios en formato YAML. Luego, puedes modificar los campos que se describen a continuación y subir el YAML modificado mediante el comando gcloud run services replace. Asegúrate de modificar los campos tal como se indica en la documentación.

  1. Para ver y descargar la configuración:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Actualiza el atributo run.googleapis.com/startup-cpu-boost y especifica 'true' a fin de habilitar el aumento de CPU de inicio o 'false' para inhabilitarlo:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          annotations:
            run.googleapis.com/startup-cpu-boost: 'true'

    Reemplazar

    • SERVICE por el nombre del servicio de Cloud Run
  3. Reemplaza el servicio por la configuración nueva mediante el siguiente comando:

    gcloud run services replace service.yaml

Visualiza la configuración de CPU

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

Console

  1. Ir a Cloud Run

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

  3. Haz clic en la pestaña Revisiones (Revisions).

  4. En el panel de detalles a la derecha, la configuración de CPU aparece en la pestaña Contenedor.

Línea de comandos

  1. Usa el siguiente comando:

    gcloud run services describe SERVICE
  2. Busca la configuración de CPU en la configuración mostrada.

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

Console

  1. 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 la pestaña Configuración.

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

Línea de comandos

  1. Usa el siguiente comando:

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