Configura variables de entorno para servicios

En esta página, se describe cómo configurar las variables de entorno de tu servicio de Cloud Run.

Puedes usar variables de entorno para la configuración del servicio, pero no las recomendamos como una forma de almacenar secretos, como las credenciales de la base de datos o las claves de API. Los valores sensibles deben almacenarse fuera de tu código fuente y de las variables de entorno. Para almacenar secretos, te recomendamos que uses Secret Manager. Si deseas configurar servicios para acceder a los secretos almacenados en Secret Manager, consulta Configura secretos.

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.

Roles obligatorios

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:

• Desarrollador de Cloud Run (roles/run.developer) en el servicio de Cloud Run
• Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) en la identidad del servicio

Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu servicio de Cloud Run interactúa con las APIs deGoogle 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.

Cantidad máxima de variables de entorno y límites

Puedes establecer un máximo de 1,000 variables de entorno para un servicio de Cloud Run.

La longitud variable máxima es de 32 KB.

Configure las variables de entorno

Puedes establecer variables de entorno para servicios nuevos y existentes. Ten en cuenta que la marca --set-env-vars es una acción destructiva que borra las variables de entorno establecidas anteriormente que no se incluyen en la nueva lista de variables de entorno.

Las variables de entorno están vinculadas a una revisión de servicio específica y no son visibles para otros servicios en tu Google Cloud proyecto.

Puedes configurar variables de entorno mediante la Google Cloud consola, Google Cloud CLI o un archivo YAML cuando creas un servicio nuevo o implementas una revisión nueva:

gcloud run deploy SERVICE --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

gcloud run services update SERVICE --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-env-var"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      # Environment variables
      env {
        name  = "foo"
        value = "bar"
      }
      env {
        name  = "baz"
        value = "quux"
      }
    }
  }
}

Configura variables de entorno predeterminadas en el contenedor

Puedes usar la sentencia ENV en un Dockerfile a fin de establecer valores predeterminados para las variables de entorno:

ENV KEY1=VALUE1,KEY2=VALUE2

Orden de prioridad: Comparación entre contenedores y variables de servicio

Si configuras una variable de entorno predeterminada en el contenedor y, también configuras una variable de entorno con el mismo nombre en el servicio de Cloud Run, el valor establecido en el servicio tiene prioridad.

Actualiza las variables de entorno

Puedes actualizar las variables de entorno de los servicios existentes. Este es un enfoque no destructivo que modifica o agrega variables de entorno, pero no borra las variables de entorno establecidas anteriormente.

gcloud run services update SERVICE --update-env-vars KEY1=VALUE1,KEY2=VALUE2

Visualiza la configuración de las variables de entorno

Para ver la configuración actual de las variables de entorno de tu servicio de Cloud Run, sigue estos pasos:

Borra variables de entorno

Puedes borrar variables de entorno para servicios existentes.

gcloud run services update SERVICE --remove-env-vars KEY1,KEY2

gcloud run services update SERVICE --clear-env-vars

Prácticas recomendadas

En la siguiente sección, se destacan algunas de las prácticas recomendadas para configurar las variables de entorno.

Variables de entorno reservadas para servicios

Las variables de entorno definidas en el contrato de entorno de ejecución del contenedor están reservadas y no se pueden configurar. En particular, Cloud Run inserta la variable de entorno PORT dentro de tu contenedor. No debes configurarla tú mismo.

Variables de entorno reservadas adicionales cuando se implementan funciones

Cloud Run configura las siguientes variables de entorno de ejecución automáticamente cuando se implementan funciones:

• FUNCTION_TARGET: Es la función que se ejecutará.
• FUNCTION_SIGNATURE_TYPE: Es el tipo de función: http para funciones de HTTP y event para funciones controladas por eventos.

Algunas variables de entorno adicionales se configuran automáticamente según el entorno de ejecución que usa tu función. Estas se basan en el sistema operativo del entorno de ejecución, por ejemplo, DEBIAN_FRONTEND, SHLVL o PATH, y el entorno de ejecución del lenguaje, por ejemplo, NODE_ENV, VIRTUAL_ENV o GOPATH.

Es posible que las variables de entorno que proporciona el entorno, además de las que se configuran automáticamente, cambien en las próximas versiones del entorno de ejecución. Como práctica recomendada, te sugerimos que no dependas de ninguna variable de entorno que no hayas configurado explícitamente ni la modifiques.

La modificación de las variables de entorno que proporciona el entorno puede generar resultados impredecibles. Los intentos de modificar dichas variables de entorno podrían bloquearse o, peor aún, podrían generar consecuencias no deseadas, como funciones que no pueden iniciarse. Como recomendación, considera colocar una clave única como prefijo a las variables de entorno para evitar conflictos.

Variables de entorno no válidas

No puedes usar las siguientes variables de entorno:

Código de muestra

Para ver una muestra de código que indica cómo acceder a las variables de entorno en tu código, consulta Cómo manejar la configuración sensible con Secret Manager en el instructivo de autenticación de usuarios finales.

¿Qué sigue?

Puedes usar variables de entorno para configurar los paquetes de compilación. Para obtener detalles específicos del lenguaje, consulta la documentación de los paquetes de compilación para lo siguiente:

• Node.js
• Python
• Go
• Ruby
• PHP
• Java

Si realizas la implementación desde la fuente y necesitas personalizar las variables en el momento de la compilación, consulta Cómo configurar variables de entorno de compilación.