Les variables d'environnement de compilation sont des paires clé/valeur qui vous permettent de transmettre des informations de configuration aux packs de création lors du déploiement d'une fonction à partir du code source. Par exemple, au moment de la compilation, vous pouvez personnaliser les options du compilateur, spécifier des certificats au moment de la compilation, configurer des paramètres, etc.
Cette page explique comment définir des variables d'environnement de compilation disponibles au moment de la compilation. Elle s'adresse aux développeurs de plate-forme qui déploient des fonctions dans Cloud Run.
Avant de commencer
Activez l'API Cloud Build :
gcloud services enable cloudbuild.googleapis.com
Rôles requis
Pour obtenir les autorisations nécessaires pour déployer à partir de la source, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :
- Développeur de source Cloud Run (
roles/run.sourceDeveloper) -
Utilisateur du compte de service (
roles/iam.serviceAccountUser)
Pour obtenir la liste des rôles et des autorisations IAM associés à Cloud Run, consultez les sections Rôles IAM Cloud Run et Autorisations IAM Cloud Run. Si votre service Cloud Run communique avec les API Google Cloud, telles que les bibliothèques clientes Cloud, consultez le guide de configuration de l'identité du service. Pour en savoir plus sur l'attribution de rôles, consultez les sections Autorisations de déploiement et Gérer les accès.
Définir des variables d'environnement de compilation
Vous pouvez définir des variables d'environnement de compilation pour établir de nouvelles variables ou remplacer complètement des variables de compilation existantes.
gcloud
Vous pouvez définir des variables d'environnement de compilation lorsque vous déployez une fonction à partir du code source :
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --set-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Remplacez :
- SERVICE par le nom de votre fonction Cloud Run ;
- FUNCTION_ENTRY_POINT par le point d'entrée de votre fonction dans votre code source ;
- KEY1=VALUE1,KEY2=VALUE2 par la liste de noms de variables séparés par une virgule et de leurs valeurs, déployées avec une fonction qui vous permet de transmettre des informations de configuration aux buildpacks.
Mettre à jour des variables d'environnement de compilation
Vous pouvez mettre à jour les variables d'environnement de compilation pour les fonctions existantes. Il s'agit d'une approche non destructrice, qui permet de modifier ou d'ajouter des variables d'environnement de compilation sans les supprimer.
gcloud
Pour mettre à jour une variable d'environnement de compilation pour des fonctions existantes :
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --update-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Supprimer des variables d'environnement de compilation
Vous pouvez supprimer des variables d'environnement de compilation pour les fonctions existantes.
gcloud
Pour supprimer des variables d'environnement de compilation, utilisez le fichier --remove-build-env-vars pour les fonctions existantes :
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --remove-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Vous pouvez également effacer les variables d'environnement de compilation à l'aide de --clear-build-env-vars pour les fonctions existantes :
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --clear-build-env-vars KEY1=VALUE1,KEY2=VALUE2
Fichier de variables d'environnement de compilation
Vous utilisez un fichier de variables d'environnement de compilation pour les fonctions existantes.
gcloud
Pour définir des variables d'environnement de compilation à partir d'un fichier :
gcloud beta run deploy SERVICE \ --source . \ --function FUNCTION_ENTRY_POINT \ --build-env-vars-file FILE_NAME.yaml
Remplacez FILE_NAME.yaml par le contenu du fichier qui ressemble à ceci :
KEY1: VALUE1
KEY2: VALUE2