En esta página, se describe cómo configurar las variables de entorno para tu trabajo de Cloud Run.
Cuando configuras las variables de entorno, se insertan en el contenedor y tu código puede acceder a ellas. Además, se establecen como pares clave-valor.
Nombres reservados
Las variables de entorno definidas en el contrato de entorno de ejecución del contenedor están reservadas y no se pueden configurar.
Cantidad máxima de variables de entorno
Ten en cuenta que puedes configurar un máximo de 1,000 variables de entorno por contenedor para cada trabajo de Cloud Run.
Roles obligatorios
Para obtener los permisos que necesitas para configurar los trabajos de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM en el trabajo:
- Desarrollador de Cloud Run (
roles/run.developer) - el trabajo de Cloud Run - Usuario de la cuenta de servicio (
roles/iam.serviceAccountUser) - 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 trabajo de Cloud Run interactúa con Google Cloud las APIs, 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 las variables de entorno
Puedes configurar variables de entorno para trabajos nuevos y existentes. Ten en cuenta que la marca --set-env-vars es una acción destructiva que borra las variables de entorno configuradas anteriormente que no se incluyen en la nueva lista de variables de entorno.
Puedes configurar variables de entorno con la Google Cloud consola, gcloud CLI o un archivo YAML:
Console
En la Google Cloud consola de, ve a la página Trabajos de Cloud Run:
Haz clic en Implementar contenedor para completar la página de configuración de trabajo inicial. Si quieres configurar un trabajo existente, selecciona el trabajo y, luego, haz clic en Ver y editar la configuración del trabajo.
Haz clic en Contenedores, Conexiones, Seguridad para expandir la página de propiedades del trabajo.
Haz clic en la pestaña Variables.
- En la pestaña Variables y secretos, haz clic en Agregar variable y especifica el nombre y el valor que deseas para la variable en los campos Nombre y Valor. Para obtener más información sobre cómo configurar varias variables de entorno o escapar caracteres especiales, consulta Configura varias variables de entorno.
Haz clic en Crear o Actualizar.
gcloud
Para especificar variables de entorno cuando tú
creas un trabajo, usa la --set-env-vars marca:
gcloud run jobs create JOB_NAME --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2
Reemplaza lo siguiente:
- JOB_NAME: el nombre de tu trabajo.
- KEY1=VALUE1,KEY2=VALUE2: lista separada por comas de nombres de variables y sus valores.
- IMAGE_URL: una referencia a la
imagen del contenedor, por
ejemplo,
us-docker.pkg.dev/cloudrun/container/job:latest.
Para obtener más información sobre cómo configurar varias variables de entorno o escapar caracteres especiales, consulta Configura varias variables de entorno.
YAML
Si creas un trabajo nuevo, omite este paso. Si actualizas un trabajo existente, descarga su configuración de YAML:
gcloud run jobs describe JOB_NAME --format export > job.yaml
- Actualiza los atributos
nameyvalueenenvcomo se muestra encontainers::
apiVersion: run.googleapis.com/v1 kind: Job metadata: name: JOB spec: template: spec: template: spec: containers: - image: IMAGE env: - name: KEY-1 value: VALUE-1 - name: KEY-N value: VALUE-N
Reemplaza KEY-1 y VALUE-1 por la variable de entorno y el valor. De forma opcional, agrega más variables y valores según sea necesario.
También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.
- Actualiza los atributos
Actualiza la configuración del trabajo existente:
gcloud run jobs replace job.yaml
Terraform
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
Agrega lo siguiente a ungoogle_cloud_run_v2_job
recurso en la configuración de Terraform:resource "google_cloud_run_v2_job" "default" {
name = "JOB_NAME"
location = "REGION"
template {
template {
containers {
image = "us-docker.pkg.dev/cloudrun/container/job"
env {
name = "KEY-1"
value = "VALUE-1"
}
env {
name = "KEY-N"
value = "VALUE-N"
}
}
}
}
}
Reemplaza lo siguiente:
- JOB_NAME: por el nombre del trabajo de Cloud Run.
- REGION: La Google Cloud región. Por ejemplo,
europe-west1. - KEY-1: la variable de entorno.
- VALUE-1: el valor asociado con la clave.
De forma opcional, agrega más bloques env para configurar variables de entorno adicionales.
Configura variables de entorno predeterminadas en el contenedor
Puedes usar la ENV
sentencia 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 trabajo
Si configuras una variable de entorno predeterminada en el contenedor y, también configuras una variable de entorno con el mismo nombre en el trabajo de Cloud Run, el valor establecido en el trabajo tiene prioridad.
Configura varias variables de entorno
Puedes configurar varias variables de entorno con el archivo .env o la marca --set-env-vars.
Configura varias variables de entorno con el archivo .env
Console
En la Google Cloud consola de, ve a la página Trabajos de Cloud Run:
Haz clic en Implementar contenedor para completar la página de configuración de trabajo inicial. Si quieres configurar un trabajo existente, selecciona el trabajo y, luego, haz clic en Ver y editar la configuración del trabajo.
Haz clic en Contenedores, Conexiones, Seguridad para expandir la página de propiedades del trabajo.
Haz clic en la pestaña Contenedor.
- En la pestaña Variables y secretos, haz clic en Agregar variable y pega el contenido de tu archivo
.enven el campo Nombre. Cloud Run propaga automáticamente el campo Valor y crea variables nuevas para cada par clave-valor que definas en el archivo.env.
- En la pestaña Variables y secretos, haz clic en Agregar variable y pega el contenido de tu archivo
Haz clic en Crear o Actualizar.
gcloud
Para especificar varias variables de entorno desde el archivo .env, ejecuta el siguiente comando:
gcloud run jobs create JOB_NAME --image=IMAGE_URL --env-vars-file=ENV_FILE_PATH
Reemplaza lo siguiente:
- JOB_NAME: el nombre de tu trabajo de Cloud Run.
- IMAGE_URL: una referencia a la
imagen del contenedor, por
ejemplo,
us-docker.pkg.dev/cloudrun/container/job:latest. - ENV_FILE_PATH: ruta de acceso al archivo
.env.
Configura varias variables de entorno con la marca --set-env-vars
Si tienes varias variables de entorno que no se pueden enumerar en formato KEY1=VALUE1,KEY2=VALUE2, puedes repetir la marca --set-env-vars varias veces:
[...] --set-env-vars "KEY1=VALUE1" \ --set-env-vars "KEY2=VALUE2" \ --set-env-vars "KEY3=VALUE3"
Caracteres de coma de escape
Debido a que el carácter de coma, se usa para dividir las variables de entorno, si la
variable de entorno contiene caracteres de coma como valores, debes
escapar esos delimitadores mediante la especificación de un
carácter delimitador diferente, por ejemplo, @:
--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."
Actualiza variables de entorno
Puedes actualizar las variables de entorno para los trabajos existentes. Este es un enfoque no destructivo que modifica o agrega variables de entorno, pero no borra las variables de entorno configuradas anteriormente.
Console
Para actualizar las variables de entorno con la Google Cloud consola de, sigue estos pasos:
En la Google Cloud consola de, ve a la página Trabajos de Cloud Run:
Selecciona tu trabajo de la lista y haz clic en Editar e implementar nueva revisión.
Haz clic en la pestaña Contenedor.
En la pestaña Variables y secretos , edita los campos Nombre o Valor y haz clic en Listo.
Haz clic en Implementar.
gcloud
Para actualizar las variables de entorno de un trabajo existente, usa la
--update-env-vars
marca:
gcloud run jobs update JOB_NAME --update-env-vars KEY1=VALUE1,KEY2=VALUE2
Reemplaza lo siguiente:
- JOB_NAME: el nombre de tu trabajo.
- KEY1=VALUE1,KEY2=VALUE2: lista separada por comas de nombres de variables y valores.
Visualiza la configuración de las variables de entorno
Para ver la configuración actual de las variables de entorno de tu trabajo de Cloud Run, sigue estos pasos:
Console
En la Google Cloud consola de, ve a la página de trabajos de Cloud Run:
Haz clic en el trabajo que te interesa para abrir la página Detalles del trabajo.
Haz clic en Ver y editar la configuración del trabajo.
Localiza la configuración de variables de entorno en los detalles de configuración.
gcloud
Usa el siguiente comando:
gcloud run jobs describe JOB_NAME
Ubica la configuración de las variables de entorno en la configuración que se muestra.
Borra variables de entorno
Puedes borrar variables de entorno para los trabajos existentes.
Console
Para borrar las variables de entorno con la Google Cloud consola de, sigue estos pasos:
En la Google Cloud consola, ve a Cloud Run:
Selecciona tu trabajo de la lista y haz clic en Editar e implementar nueva revisión.
Haz clic en la pestaña Contenedor.
En la pestaña Variables y secretos, mueve el cursor a la izquierda del campo Valor de la variable de entorno que deseas quitar para que se muestre el ícono de borrado Borrar y haz clic en él.
Haz clic en Listo.
Haz clic en Implementar.
gcloud
Para quitar de forma selectiva las variables de entorno de un trabajo existente, usa la
--remove-env-vars
marca:
gcloud run jobs update JOB_NAME --remove-env-vars KEY1,KEY2
Reemplaza lo siguiente:
- JOB_NAME: el nombre de tu trabajo.
- KEY1,KEY2: lista separada por comas de nombres de variables.
Como alternativa, borra todas las variables de entorno configuradas previamente
con la --clear-env-vars
marca:
gcloud run jobs update JOB_NAME --clear-env-vars