En esta página, se describe cómo especificar el entorno de ejecución para cada instancia de Cloud Run. En el caso de los servicios de Cloud Run, las instancias de Cloud Run se ejecutan en el entorno de ejecución de primera generación de forma predeterminada. Puedes cambiar esto si lo deseas, solo para servicios. Ten en cuenta que los trabajos de Cloud Run usan de forma automática el entorno de ejecución de segunda generación y no se puede cambiar para los trabajos.
Consulta la documentación de concepto de entornos de ejecución a fin de obtener ayuda para elegir el entorno que mejor se adapte a tu servicio.
Configura y actualiza el entorno de ejecución
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.
De forma predeterminada cada instancia usa el entorno de ejecución de primera generación para los servicios de Cloud Run. Si usas la segunda generación, también debes especificar al menos 512 MiB de memoria.
Puedes configurar el entorno de ejecución 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:
Consola
En la consola de Google Cloud ve a Cloud Run:
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 implementar y editar la nueva revisión.
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 entorno de ejecución deseado con los botones de opción.
Haz clic en Crear o Implementar.
Línea de comandos
Puedes actualizar el entorno de ejecución de un servicio determinado mediante el siguiente comando:
gcloud run services update SERVICE --execution-environment ENVIRONMENT
Reemplaza SERVICE por el nombre de tu servicio y ENVIRONMENT por el entorno de ejecución deseado. Especifica el valor gen1
para la primera generación o gen2
para la segunda generación.
También puedes configurar el entorno de ejecución durante la implementación mediante el siguiente comando:
gcloud run deploy --image IMAGE_URL --execution-environment ENVIRONMENT
Reemplazar
- IMAGE_URL por una referencia a la imagen del contenedor, como
us-docker.pkg.dev/cloudrun/container/hello:latest
Si usas Artifact Registry, el repositorio REPO_NAME debe estar creado. La URL tiene el formatoLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
. ENVIRONMENT
por el entorno de ejecución deseado. Especifica el valorgen1
para la primera generación ogen2
para la segunda generación.
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
Establece la anotación
run.googleapis.com/execution-environment
:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: annotations: run.googleapis.com/execution-environment: ENVIRONMENT name: REVISION
Reemplazar
- SERVICE por el nombre del servicio de Cloud Run
- ENVIRONMENT por el entorno de ejecución deseado. Especifica el valor
gen1
para la primera generación ogen2
para la segunda generación. - 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
Visualiza la configuración del entorno de ejecución
Para ver la configuración actual del entorno de ejecución del servicio de Cloud Run, sigue estos pasos:
Consola
En la consola de Google Cloud ve a Cloud Run:
Haz clic en el servicio que te interesa para abrir la página Detalles del servicio.
Haz clic en la pestaña Revisiones.
En el panel de detalles a la derecha, la configuración del entorno de ejecución se muestra en la pestaña Contenedor.
Línea de comandos
Usa el siguiente comando:
gcloud run services describe SERVICE
Ubica la configuración del entorno de ejecución en la configuración que se muestra.