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
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.
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.
Haz clic en la pestaña Contenedor.
- 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
o8
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).
- 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
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
o8
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
o8
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.
Para ver y descargar la configuración, ejecuta el siguiente comando:
gcloud run services describe SERVICE --format export > service.yaml
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
o8
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
- Comienza con
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.
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
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.
Haz clic en Contenedor, variables y secretos, conexiones y seguridad para expandir la página de propiedades del trabajo.
Haz clic en la pestaña General.
- Selecciona el límite de CPU que desees de la lista desplegable. Selecciona un valor de CPU
1
,2
,4
,6
o8
. 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).
- Selecciona el límite de CPU que desees de la lista desplegable. Selecciona un valor de CPU
Haz clic en Crear o Actualizar.
Línea de comandos
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
o8
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
o8
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.
Para ver y descargar la configuración, ejecuta el siguiente comando:
gcloud run jobs describe JOB_NAME --format export > job.yaml
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
o8
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.
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
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.
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.
Haz clic en la pestaña Contenedor.
- 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.
Haz clic en Crear o Implementar.
Línea de comandos
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
. .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.
Para ver y descargar la configuración:
gcloud run services describe SERVICE --format export > service.yaml
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
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
Haz clic en el servicio que te interesa para abrir la página Detalles del servicio.
Haz clic en la pestaña Revisiones (Revisions).
En el panel de detalles a la derecha, la configuración de CPU aparece en la pestaña Contenedor.
Línea de comandos
Usa el siguiente comando:
gcloud run services describe SERVICE
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
Haz clic en el trabajo que te interesa para abrir la página Detalles del trabajo.
Haz clic en la pestaña Configuración.
Ubica la configuración de la CPU en los detalles de configuración.
Línea de comandos
Usa el siguiente comando:
gcloud run jobs describe JOB_NAME
Busca la configuración de CPU en la configuración mostrada.