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 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 con Google Cloud CLI cuando creas un grupo de trabajadores nuevo o implementas una revisión nueva:

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 por una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest

Actualiza las variables de entorno

Puedes actualizar las variables de entorno de ejecución para los servicios existentes. Este es un enfoque no destructivo que modifica o agrega variables de entorno de ejecución, pero no las borra.

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.

Borra variables de entorno

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: