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 requeridos

Para obtener los permisos que necesitas para configurar e implementar grupos de trabajadores de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:

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

Configure las variables de entorno

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

Console

  1. En la consola de Google Cloud , ve a Cloud Run:

    Ir a Cloud Run

  2. Selecciona Grupos de trabajadores en el menú y haz clic en Implementar 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 Implementar y editar una nueva revisión.

  3. Si configuras un grupo de trabajadores nuevo, completa la página inicial del grupo de trabajadores y, luego, haz clic en Contenedores, volúmenes, Herramientas de redes y seguridad para expandir la página de configuración del grupo de trabajadores.

  4. Haz clic en la pestaña Contenedor.

    imagen

    • En la pestaña Variables y secretos, 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 establecer varias variables de entorno o escapar caracteres especiales, consulta Cómo establecer varias variables de entorno.
  5. Haz clic en Crear o Implementar.

gcloud

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

gcloud beta 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: Es la lista separada por comas de los nombres y valores de las variables.
  • IMAGE_URL: Es 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 Cómo configurar varias variables de entorno.

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"
  launch_stage = "BETA"

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

Reemplaza lo siguiente:

  • WORKER_POOL: Es el nombre del grupo de trabajadores.
  • REGION: la Google Cloud región, por ejemplo,europe-west1
  • IMAGE_URL: Es 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: Son la variable de entorno y el valor. También puedes agregar más variables y valores según sea necesario.

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 variables de contenedor y de grupo 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 establecer varias variables de entorno con el archivo .env o la marca --set-env-vars.

Cómo configurar varias variables de entorno con el archivo .env

Console

  1. En la consola de Google Cloud , ve a Cloud Run:

    Ir a Cloud Run

  2. Selecciona Grupos de trabajadores en el menú y haz clic en Implementar 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 Implementar y editar una nueva revisión.

  3. Si configuras un grupo de trabajadores nuevo, completa la página inicial del grupo de trabajadores y, luego, haz clic en Contenedores, volúmenes, Herramientas de redes y seguridad para expandir la página de configuración del grupo de trabajadores.

  4. Haz clic en la pestaña Contenedor.

    imagen

    • 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 completa automáticamente el campo Value y crea variables nuevas para cada par clave-valor que definas en el archivo .env.
  5. Haz clic en Crear o Implementar.

gcloud

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

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

Reemplaza lo siguiente:

  • WORKER_POOL: Es el nombre del grupo de trabajadores.
  • IMAGE_URL: Es 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: Es la ruta de acceso al archivo .env.

Cómo establecer 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 tu variable de entorno contiene caracteres de coma como valores, debes escapar esos delimitadores especificando un carácter delimitador diferente, por ejemplo, @:
--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

Actualiza las 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 la Google Cloud consola, Google Cloud CLI o Terraform:

Console

  1. En la consola de Google Cloud , ve a Cloud Run:

    Ir a Cloud Run

  2. Selecciona Grupos de trabajadores en el menú, haz clic en el grupo de trabajadores que deseas actualizar y, luego, en Editar e implementar nueva revisión.

  3. Haz clic en Contenedores, volúmenes, herramientas de redes y seguridad para expandir la página de configuración de los grupos de trabajadores.

  4. Haz clic en la pestaña Variables y Secrets.

    imagen

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

  6. Haz clic en Implementar.

gcloud

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

gcloud beta 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: Es la lista separada por comas de los nombres y valores de las variables.

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

  1. En la consola de Google Cloud , ve a Cloud Run:

    Ir a Cloud Run

  2. Selecciona Grupos de trabajadores en el menú, haz clic en el grupo de trabajadores que deseas actualizar y, luego, en Editar e implementar nueva revisión.

  3. Haz clic en Contenedores, volúmenes, herramientas de redes y seguridad para expandir la página de configuración de los grupos de trabajadores.

  4. Haz clic en la pestaña Variables y Secrets.

    imagen

  5. Ubica 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.

  6. Haz clic en Implementar.

gcloud

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

gcloud beta 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: Es la lista de nombres de variables separados por comas.

Como alternativa, puedes borrar todas las variables de entorno configuradas previamente con la marca --clear-env-vars:

gcloud beta 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

  1. En la consola de Google Cloud , ve a Cloud Run:

    Ir a Cloud Run

  2. Haz clic en Grupos de trabajadores para ver la lista de grupos de trabajadores implementados.

  3. Haz clic en el grupo de trabajadores que deseas examinar para mostrar su panel de detalles.

  4. 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 los siguientes lenguajes: