Las variables de entorno de compilación son pares clave-valor que te permiten pasar la información de configuración a los paquetes de compilación cuando implementas una función desde el código fuente. Por ejemplo, en el momento de la compilación, es posible que desees personalizar las opciones del compilador, especificar certificados del tiempo de compilación, configurar parámetros, etcétera.
En esta página, se muestra cómo configurar variables de entorno de compilación que están disponibles en el momento de la compilación y que son relevantes para los desarrolladores de plataformas que implementan funciones en Cloud Run.
Antes de comenzar
Habilita la API de Cloud Build
gcloud services enable cloudbuild.googleapis.com
Roles obligatorios
Para obtener los permisos que necesitas para implementar desde la fuente, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
- Desarrollador de origen de Cloud Run (
roles/run.sourceDeveloper) -
Usuario de cuenta de servicio (
roles/iam.serviceAccountUser)
Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta roles de IAM de Cloud Run y permisos de IAM de Cloud Run. Si tu servicio de Cloud Run interactúa con las APIs de Google Cloud, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información acerca de cómo otorgar roles, consulta Permisos de implementación y Administra el acceso.
Configura variables de entorno de compilación
Puedes configurar variables de entorno de compilación para establecer variables nuevas o reemplazar por completo las variables de compilación existentes.
gcloud
Puedes configurar variables de entorno de compilación cuando implementes una función desde el código fuente:
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --set-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Reemplaza lo siguiente:
- SERVICE por el nombre de la función de Cloud Run.
- FUNCTION_ENTRY_POINT por el punto de entrada a tu función en tu código fuente.
- KEY1=VALUE1,KEY2=VALUE2 con la lista separada por comas de los nombres de las variables y sus valores que se implementan junto con una función que te permite pasar la información de configuración a los paquetes de compilación.
Actualiza las variables de entorno de compilación
También puedes actualizar las variables de entorno de compilación para las funciones existentes. Este es un enfoque no destructivo que modifica o agrega variables de entorno de compilación, pero no borra las variables de entorno de compilación.
gcloud
Para actualizar una variable de entorno de compilación para funciones existentes, sigue estos pasos:
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --update-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Borra variables de entorno de compilación
Puedes borrar variables de entorno de compilación para las funciones existentes.
gcloud
Para quitar variables de entorno de compilación, usa --remove-build-env-vars para las funciones existentes:
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --remove-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Como alternativa, puedes borrar las variables de entorno de compilación mediante --clear-build-env-vars para las funciones existentes:
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --clear-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Archivo de variables de entorno de compilación
Usa un archivo de variables de entorno de compilación para las funciones existentes.
gcloud
Para establecer variables de entorno de compilación desde un archivo, sigue estos pasos:
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --build-env-vars-file FILE_NAME.yaml
Reemplaza FILE_NAME.yaml por el archivo cuyo contenido se ve de la siguiente manera:
KEY1: VALUE1
KEY2: VALUE2