Configurar servicios de Cloud Run y Cloud Run Functions

Usa las siguientes variables de entorno para configurar el comportamiento de tus servicios cuando se implementen en Cloud Run o Cloud Functions.

Consulta cómo definir estas variables de entorno en tu imagen de contenedor.

Para obtener información sobre la configuración de un idioma concreto, consulta los siguientes artículos:

Variables de entorno de Cloud Run y Cloud Run Functions

Las siguientes configuraciones permiten crear servicios para aplicaciones y funciones. Para obtener más información sobre las variables de entorno de Cloud Run Functions, consulta las variables de entorno adicionales de Cloud Run Functions.

GOOGLE_ENTRYPOINT

Especifica el comando que se ejecuta cuando se ejecuta el contenedor. Es equivalente a entrypoint en un Dockerfile.

Ejemplos:

Despliegue de código fuente de Cloud Run

  • Java: java -jar target/myjar.jar
  • PHP: php -S 0.0.0.0:8080 index.php
  • Python:

El paquete de compilación de Python define el punto de entrada predeterminado para los despliegues de origen de Cloud Run. En Python 3.13 y versiones posteriores, el buildpack de Python define el punto de entrada en función de la configuración del servicio web en el archivo requirements.txt. Si no especificas un servidor web o un framework en el archivo requirements.txt o usas la versión 3.12 o una anterior de Python, el paquete de compilación de Python define el punto de entrada predeterminado como gunicorn -b :8080 main:app. Para obtener más información, consulta Crear una aplicación de Python.

Todos los demás despliegues

  • Java: java -jar target/myjar.jar
  • PHP: php -S 0.0.0.0:8080 index.php
  • Python: gunicorn -b :8080 main:app

GOOGLE_RUNTIME

Fuerza al entorno de ejecución a habilitar la función. Si la imagen del paquete de compilación de tiempo de ejecución aparece en varios grupos, se usará la imagen del paquete de compilación del primer grupo en todos los grupos.

Ejemplo de Node.js: si se especifica nodejs, se obliga al paquete de compilación del tiempo de ejecución de Node.js a habilitarse.

GOOGLE_RUNTIME_VERSION

Especifica la versión del tiempo de ejecución que quieres instalar. En el caso de .NET, especifica la versión del SDK de .NET.

Ejemplos:

  • Ve a 1.14.1.
  • Java: 8
  • Node.js: 13.7.0
  • .NET: 3.1.301

GOOGLE_BUILDABLE

En los tiempos de ejecución de Go, Java, Dart y .NET, se especifica la ruta a una unidad compilable.

Ejemplo de Go: si se especifica ./maindir, se compila el paquete cuya raíz es maindir.

GOOGLE_BUILD_ARGS

En los tiempos de ejecución de Java (Maven y Gradle) y .NET, añade argumentos al comando de compilación.

Ejemplo de Java: si se especifica -Pprod, se ejecuta mvn clean package ... -Pprod.

GOOGLE_MAVEN_BUILD_ARGS

En el caso de los tiempos de ejecución de Java que usan el complemento Maven, se sustituye el comando Maven predeterminado por el comando de compilación que especifiques.

Si no se especifica GOOGLE_MAVEN_BUILD_ARGS, se ejecuta el siguiente comando de forma predeterminada:

mvn clean package --batch-mode -DskipTests -Dhttp.keepAlive=false

Ejemplo: Si especificas GOOGLE_MAVEN_BUILD_ARGS="clean package:, se ejecuta el comando mvn clean package.

GOOGLE_GRADLE_BUILD_ARGS

En el caso de los tiempos de ejecución de Java que usan el complemento Gradle, se sustituye el comando Gradle predeterminado por el comando de compilación que especifiques.

Si no se especifica GOOGLE_GRADLE_BUILD_ARGS, se ejecuta el siguiente comando de forma predeterminada:

gradle clean assemble -x test --build-cache

Ejemplo: Si especificas GOOGLE_GRADLE_BUILD_ARGS="clean assemble", se ejecuta el comando gradle clean assemble.

GOOGLE_DEVMODE

En Skaffold: habilita los buildpacks del modo de desarrollo. Usa el desarrollo local activo para activar la recompilación automática de contenedores cuando se hagan cambios en el código fuente. Debes instalar Skaffold y ejecutar skaffold dev.

  • Valores admitidos: true, True y 1.

GOOGLE_CLEAR_SOURCE

En el caso de las funciones y las aplicaciones de Go o Java, se borra el origen después de compilar la aplicación. Si la aplicación depende de archivos estáticos, como plantillas de Go, definir esta variable puede provocar que la aplicación no funcione correctamente.

Valores admitidos: true, True o 1

Variables de entorno adicionales de Cloud Run Functions

Las siguientes configuraciones solo están disponibles para el código fuente compilado como funciones que usan Functions Framework y Cloud Run Functions. Para obtener más información sobre estas opciones de configuración, consulta el contrato.

GOOGLE_FUNCTION_TARGET

  • Especifica el nombre de la función exportada que se invocará en respuesta a las solicitudes.
  • Ejemplo: myFunction hará que Functions Framework invoque la función con el mismo nombre.

GOOGLE_FUNCTION_SIGNATURE_TYPE

  • Especifica la firma que usa la función.
  • Ejemplo: http, event o cloudevent.

GOOGLE_FUNCTION_SOURCE

  • Especifica el nombre del directorio o del archivo que contiene el origen de la función, en función del lenguaje.
  • (Solo se aplica a algunos idiomas. Consulta la documentación específica de cada idioma).
  • Ejemplo: function.py para Python.