Configurer des variables d'environnement pour les pools de nœuds de calcul

Cette page explique comment configurer des variables d'environnement pour votre pool de nœuds de calcul Cloud Run.

Tout changement de configuration entraîne la création d'une révision. Les révisions ultérieures obtiennent aussi automatiquement le même paramètre de configuration, à moins que vous ne le mettiez explicitement à jour.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer et déployer des pools de nœuds de calcul Cloud Run, demandez à votre administrateur de vous accorder les rôles IAM suivants :

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 pool de nœuds de calcul Cloud Run communique avec des APIGoogle Cloud , telles que des 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 pages Autorisations de déploiement et Gérer les accès.

Définir des variables d'environnement

Vous pouvez définir des variables d'environnement à l'aide de Google Cloud CLI lorsque vous créez un pool de nœuds de calcul ou déployez une nouvelle révision :

gcloud

Pour spécifier des variables d'environnement lors du déploiement de votre pool de nœuds de calcul, utilisez l'option --set-env-vars :

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

Remplacez :

  • WORKER_POOL : nom de votre pool de nœuds de calcul
  • KEY1=VALUE1,KEY2=VALUE2 : liste de noms et de valeurs de variables, séparés par une virgule
  • IMAGE_URL par une référence à l'image de conteneur qui contient le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

Mettre à jour les variables d'environnement

Vous pouvez mettre à jour les variables d'environnement d'exécution pour les services existants. Il s'agit d'une approche non destructrice, qui permet de modifier ou d'ajouter des variables d'environnement d'exécution sans les supprimer.

gcloud

Pour mettre à jour les variables d'environnement d'un pool de nœuds de calcul existant, utilisez l'option --update-env-vars :

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

Remplacez :

  • WORKER_POOL : nom de votre pool de nœuds de calcul
  • KEY1=VALUE1,KEY2=VALUE2 : liste de noms et de valeurs de variables, séparés par une virgule

Supprimer des variables d'environnement

gcloud

Pour supprimer de manière sélective des variables d'environnement d'un pool de nœuds de calcul existant, utilisez l'option --remove-env-vars :

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

Remplacez :

  • WORKER_POOL : nom de votre pool de nœuds de calcul
  • KEY1,KEY2 : liste de noms de variables séparés par une virgule

Vous pouvez également effacer l'ensemble des variables d'environnement définies précédemment à l'aide de l'option --clear-env-vars :

gcloud beta run worker-pools update WORKER_POOL --clear-env-vars

Remplacez WORKER_POOL par le nom de votre pool de nœuds de calcul.

Afficher la configuration des variable d'environnement pour le pool de nœuds de calcul

  1. Dans la console Google Cloud , accédez à Cloud Run :

    Accédez à Cloud Run

  2. Cliquez sur Pools de nœuds de calcul pour afficher la liste des pools de nœuds de calcul déployés.

  3. Cliquez sur le pool de workers que vous souhaitez examiner pour afficher son volet d'informations.

  4. Cliquez sur l'onglet Conteneurs pour afficher la configuration des conteneurs du pool de nœuds de calcul.

Exemple de code

Pour obtenir un exemple de code montrant comment accéder aux variables d'environnement de votre code, reportez-vous à la section Gérer une configuration sensible avec Secret Manager du tutoriel sur l'authentification des utilisateurs finaux.

Étapes suivantes

Vous pouvez utiliser des variables d'environnement pour définir la configuration des packs de création. Pour obtenir des informations propres à chaque langage, consultez la documentation sur les buildpacks pour :