Selecciona un entorno de ejecución (servicios)

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

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

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. 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 o gen2 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
  3. 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

  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.