Elige un entorno de ejecución (servicios)

En esta página, se describe cómo especificar el entorno de ejecución de las instancias de Cloud Run. Los servicios de Cloud Run no tienen un entorno de ejecución especificado de forma predeterminada, lo que significa que Cloud Run selecciona el entorno de ejecución según las funciones que se usaron. Si no especificas un entorno de ejecución para el servicio, Cloud Run puede seleccionar el entorno de primera o segunda generación.

Ten en cuenta que los trabajos de Cloud Run usan únicamente 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 para obtener ayuda para elegir el entorno que mejor se adapte a tu servicio.

Funciones obligatorias

Para obtener los permisos que necesitas para configurar y, luego, implementar los servicios 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 Roles de IAM de Cloud Run y Permisos de IAM de Cloud Run. Si tu servicio de Cloud Run interactúa con las APIs de Google Cloud, 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 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.

La configuración predeterminada de los servicios de Cloud Run no se especifica, lo que significa que Cloud Run selecciona un entorno de ejecución adecuado. Como alternativa, puedes especificar un entorno de ejecución. Para usar la segunda generación, debes especificar al menos 512 MiB de memoria.

Puedes configurar el entorno de ejecución a través de 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. En la consola de Google Cloud ve a Cloud Run:

    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 implementar y editar la nueva revisión.

  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 entorno de ejecución deseado con los botones de opción. Mantén la opción “Configuración predeterminada” para permitir que Cloud Run seleccione un entorno de ejecución adecuado.

  5. 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 formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • ENVIRONMENT por el entorno de ejecución deseado. Especifica el valor gen1 para la primera generación o gen2 para la segunda generación.

YAML

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

    gcloud run services describe SERVICE --format export > service.yaml

  2. 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

    Reemplazar

    • SERVICE por el nombre del servicio de Cloud Run
    • ENVIRONMENT por el entorno de ejecución seleccionado. Especifica el valor gen1 para la primera generación o gen2 para la segunda generación.

    Quita la anotación run.googleapis.com/execution-environment para el comportamiento predeterminado.

  3. Crea o actualiza el servicio con el siguiente comando:

    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

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

    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.

  4. 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

  1. Usa el siguiente comando:

    gcloud run services describe SERVICE

  2. Ubica la configuración del entorno de ejecución en la configuración que se muestra.