Configura variables de entorno para grupos de trabajadores

En esta página, se describe cómo configurar variables de entorno para tu grupo de trabajadores de Cloud Run.

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 grupos de trabajadores 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 grupo de trabajadores 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 grupo de trabajadores de Cloud Run interactúa con lasGoogle Cloud 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 los permisos de implementación y cómo administrar el acceso.

Configura las variables de entorno

Puedes configurar variables de entorno para un grupo de trabajadores de Cloud Run con la Google Cloud consola, Google Cloud CLI, YAML o Terraform:

Console

En la consola Google Cloud , ve a Cloud Run:

Ir a Cloud Run
Selecciona Grupos de trabajadores en el menú y haz clic en Implementa un contenedor para configurar un grupo de trabajadores nuevo. Si quieres configurar un grupo de trabajadores existente, haz clic en el grupo de trabajadores y, luego, en Editar e implementar una nueva revisión.
Si configuras un grupo de trabajadores nuevo, completa la página inicial del grupo de trabajadores y, luego, haz clic en Contenedores, Herramientas de redes y seguridad para expandir la página de configuración del grupo de trabajadores.
Haz clic en la pestaña Contenedor.
- En la pestaña Variables y Secrets, haz clic en Agregar variable para agregar una variable de entorno nueva y, luego, especifica el nombre 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 Implementar.

gcloud

Para especificar variables de entorno mientras implementas tu grupo de trabajadores, usa la --set-env-vars marca:

gcloud run worker-pools deploy WORKER_POOL --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

Reemplaza lo siguiente:

WORKER_POOL: el nombre de tu grupo de trabajadores
KEY1=VALUE1,KEY2=VALUE2: la lista separada por comas de nombres y valores de variables
IMAGE_URL: una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool: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 grupo de trabajadores nuevo, omite este paso. Si actualizas un grupo de trabajadores existente, descarga su configuración de YAML:
```
gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml
```

En el siguiente ejemplo, se incluye la configuración de YAML:

apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
spec:
  template:
    spec:
      containers:
      - name:
        image: IMAGE_URL
        env:
        - name: NAME
          value: VALUE
        - name: NAME2
          value: VALUE2

Reemplaza lo siguiente:

WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run.
IMAGE_URL: una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
NAME y VALUE: el nombre y los valores de las variables de entorno.

Crea o actualiza el grupo de trabajadores con el siguiente comando:
```
gcloud run worker-pools replace workerpool.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.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
      env {
        name  = "KEY1"
        value = "VALUE1"
      }
      env {
        name  = "KEY2"
        value = "VALUE2"
      }
    }
  }
}

Reemplaza lo siguiente:

WORKER_POOL: el nombre del grupo de trabajadores.
REGION: la Google Cloud región, por ejemplo, europe-west1
IMAGE_URL: una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
KEY1 y VALUE1: la variable de entorno y valor. También, puedes agregar más variables y valores según lo necesites.

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 grupos de trabajadores

Si configuras una variable de entorno predeterminada en el contenedor y, también configuras una variable de entorno con el mismo nombre en el grupo de trabajadores de Cloud Run, el valor establecido en el grupo de trabajadores 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 consola Google Cloud , ve a Cloud Run:

Ir a Cloud Run
Selecciona Grupos de trabajadores en el menú y haz clic en Implementa un contenedor para configurar un grupo de trabajadores nuevo. Si quieres configurar un grupo de trabajadores existente, haz clic en el grupo de trabajadores y, luego, en Editar e implementar una nueva revisión.
Si configuras un grupo de trabajadores nuevo, completa la página inicial del grupo de trabajadores y, luego, haz clic en Contenedores, Herramientas de redes y seguridad para expandir la página de configuración del grupo de trabajadores.
Haz clic en la pestaña Contenedor.
- En la pestaña Variables y Secrets, haz clic en Agregar variable y pega el contenido de tu archivo .env en 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.
Haz clic en Crear o Implementar.

gcloud

Para especificar varias variables de entorno desde el archivo .env, ejecuta el siguiente comando:

gcloud run worker-pools deploy WORKER_POOL --image IMAGE_URL --env-vars-file=ENV_FILE_PATH

Reemplaza lo siguiente:

WORKER_POOL: el nombre del grupo de trabajadores.
IMAGE_URL: una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
ENV_FILE_PATH: la 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 varias veces la marca --set-env-vars:

   [...]
   --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 de ejecución para los grupos de trabajadores existentes. Este es un enfoque no destructivo que modifica o agrega variables de entorno de ejecución, pero no las borra.

Puedes actualizar las variables de entorno en Google Cloud la consola, Google Cloud CLI, YAML o Terraform:

Console

En la consola Google Cloud , ve a Cloud Run:

Ir a Cloud Run
Selecciona Grupos de trabajadores en el menú, haz clic en el grupo de trabajadores que deseas actualizar y, luego, en Editar e implementar una nueva revisión.
Haz clic en Contenedores, Herramientas de redes y seguridad para expandir la página de configuración del grupo de trabajadores.
Haz clic en la pestaña Variables y Secrets.
Busca la variable de entorno que deseas actualizar y, luego, especifica un nombre diferente para la variable o un valor diferente en los campos Nombre y Valor.
Haz clic en Implementar.

gcloud

Para actualizar las variables de entorno de un grupo de trabajadores existente, usa la --update-env-vars marca:

gcloud run worker-pools update WORKER_POOL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

Reemplaza lo siguiente:

WORKER_POOL: el nombre de tu grupo de trabajadores
KEY1=VALUE1,KEY2=VALUE2: la lista separada por comas de nombres y valores de variables

YAML

Descarga la configuración YAML del grupo de trabajadores:

gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml

Edita las variables de nombre y valor.
Actualiza el grupo de trabajadores con el siguiente comando:
```
gcloud run worker-pools replace workerpool.yaml
```

Terraform

Para actualizar las variables de entorno de un grupo de trabajadores existente, abre el archivo main.tf correspondiente al grupo de trabajadores y edita las variables de nombre y valor. Luego, ejecuta el comando para aplicar la configuración de Terraform.

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Borra variables de entorno

Console

En la consola Google Cloud , ve a Cloud Run:

Ir a Cloud Run
Selecciona Grupos de trabajadores en el menú, haz clic en el grupo de trabajadores que deseas actualizar y, luego, en Editar e implementar una nueva revisión.
Haz clic en Contenedores, Herramientas de redes y seguridad para expandir la página de configuración del grupo de trabajadores.
Haz clic en la pestaña Variables y Secrets.
Busca la variable de entorno que deseas borrar y haz clic en el ícono de la papelera a la derecha del campo Valor para borrar la variable de entorno.
Haz clic en Implementar.

gcloud

Para quitar variables de entorno de forma selectiva de un grupo de trabajadores existente, usa la --remove-env-vars marca:

gcloud run worker-pools update WORKER_POOL --remove-env-vars KEY1,KEY2

Reemplaza lo siguiente:

WORKER_POOL: el nombre de tu grupo de trabajadores
KEY1,KEY2: la 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 worker-pools update WORKER_POOL --clear-env-vars

Reemplaza WORKER_POOL por el nombre de tu grupo de trabajadores.

Visualiza la configuración de variable de entorno para el grupo de trabajadores

En la consola Google Cloud , ve a Cloud Run:

Ir a Cloud Run
Haz clic en Grupos de trabajadores para mostrar la lista de grupos de trabajadores implementados.
Haz clic en el grupo de trabajadores que deseas examinar para mostrar su panel de detalles.
Haz clic en la pestaña Contenedores para mostrar la configuración del contenedor del grupo de trabajadores.

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 establecer una configuración de paquetes de compilación. Para obtener detalles específicos del lenguaje, consulta la documentación de los paquetes de compilación para lo siguiente:

Configura variables de entorno para grupos de trabajadores Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Roles obligatorios

Configura las variables de entorno

Console

gcloud

YAML

Terraform

Configura variables de entorno predeterminadas en el contenedor

Orden de prioridad: Comparación entre contenedores y variables de grupos de trabajadores

Configura varias variables de entorno

Configura varias variables de entorno con el archivo .env

Console

gcloud

Configura varias variables de entorno con la marca --set-env-vars

Caracteres de coma de escape

Actualiza variables de entorno

Console

gcloud

YAML

Terraform

Borra variables de entorno

Console

gcloud

Visualiza la configuración de variable de entorno para el grupo de trabajadores

Código de muestra

¿Qué sigue?

Configura variables de entorno para grupos de trabajadores

Configura varias variables de entorno con el archivo `.env`

Configura varias variables de entorno con la marca `--set-env-vars`