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

Preview — Cloud Run worker pools

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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 :

• Développeur Cloud Run (roles/run.developer) sur le pool de nœuds de calcul Cloud Run
• Utilisateur du compte de service (roles/iam.serviceAccountUser) sur l'identité du service

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.

Avertissement : Si votre pool de nœuds de calcul Cloud Run utilise l'identité du service pour authentifier l'accès aux API Google Cloud , ne définissez jamais GOOGLE_APPLICATION_CREDENTIALS en tant que variable d'environnement sur un pool de nœuds de calcul Cloud Run. Configurez toujours un compte de service géré par l'utilisateur.

Définir des variables d'environnement

Vous pouvez définir des variables d'environnement pour un pool de workers Cloud Run à l'aide de la consoleGoogle Cloud , de Google Cloud CLI ou de Terraform :

Console

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

   Accédez à Cloud Run

2. Sélectionnez Pools de nœuds de calcul dans le menu, puis cliquez sur Déployer un conteneur pour configurer un nouveau pool de nœuds de calcul. Si vous configurez un pool de nœuds de calcul existant, cliquez sur celui-ci, puis sur Modifier et déployer la nouvelle révision.

3. Si vous configurez un nouveau pool de nœuds de calcul, remplissez la page initiale du pool de nœuds de calcul, puis cliquez sur Conteneur(s), Volumes, Mise en réseau, Sécurité pour développer la page de configuration des pools de nœuds de calcul.

4. Cliquez sur l'onglet Conteneur.

   

   • Dans l'onglet "Variables et secrets", cliquez sur Ajouter une variable pour ajouter une variable d'environnement, puis spécifiez le nom de la variable dans les champs Nom et Valeur. Pour savoir comment définir plusieurs variables d'environnement ou échapper des caractères spéciaux, consultez Définir plusieurs variables d'environnement.

5. Cliquez sur Créer ou Déployer.

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 les éléments suivants :

• 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 : référence à l'image de conteneur contenant le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest

Pour savoir comment définir plusieurs variables d'environnement ou échapper des caractères spéciaux, consultez Définir plusieurs variables d'environnement.

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.

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"
      }
    }
  }
}

Remplacez les éléments suivants :

• WORKER_POOL : nom du pool de nœuds de calcul.
• REGION : région Google Cloud (par exemple,europe-west1)
• IMAGE_URL : référence à l'image de conteneur contenant le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• KEY1 et VALUE1 : variable d'environnement et valeur. Si vous le souhaitez, vous pouvez ajouter d'autres variables accompagnées de leur valeur.

Définir des variables d'environnement par défaut dans le conteneur

Vous pouvez utiliser l'instruction ENV dans un fichier Dockerfile pour définir les valeurs par défaut des variables d'environnement :

ENV KEY1=VALUE1,KEY2=VALUE2

Ordre de priorité entre les variables de conteneur et de pool de nœuds de calcul

Si vous définissez une variable d'environnement par défaut dans le conteneur et une variable d'environnement portant le même nom sur le pool de nœuds de calcul Cloud Run, la valeur définie au niveau du pool de nœuds de calcul est prioritaire.

Définir plusieurs variables d'environnement

Vous pouvez définir plusieurs variables d'environnement à l'aide du fichier .env ou de l'indicateur --set-env-vars.

Définir plusieurs variables d'environnement à l'aide du fichier .env

Console

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

   Accédez à Cloud Run

2. Sélectionnez Pools de nœuds de calcul dans le menu, puis cliquez sur Déployer un conteneur pour configurer un nouveau pool de nœuds de calcul. Si vous configurez un pool de nœuds de calcul existant, cliquez sur celui-ci, puis sur Modifier et déployer la nouvelle révision.

3. Si vous configurez un nouveau pool de nœuds de calcul, remplissez la page initiale du pool de nœuds de calcul, puis cliquez sur Conteneur(s), Volumes, Mise en réseau, Sécurité pour développer la page de configuration des pools de nœuds de calcul.

4. Cliquez sur l'onglet Conteneur.

   

   • Dans l'onglet "Variables et secrets", cliquez sur Ajouter une variable, puis collez le contenu de votre fichier .env dans le champ Nom. Cloud Run remplit automatiquement le champ Valeur et crée des variables pour chaque paire clé/valeur que vous définissez dans le fichier .env.

5. Cliquez sur Créer ou Déployer.

gcloud

Pour spécifier plusieurs variables d'environnement à partir du fichier .env, exécutez la commande suivante :

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

Remplacez les éléments suivants :

• WORKER_POOL : nom du pool de nœuds de calcul.
• IMAGE_URL : référence à l'image de conteneur contenant le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• ENV_FILE_PATH : chemin d'accès au fichier .env.

Définir plusieurs variables d'environnement à l'aide de l'indicateur --set-env-vars

Si vous avez plusieurs variables d'environnement qui ne peuvent pas être répertoriées au format KEY1=VALUE1,KEY2=VALUE2, vous pouvez répéter l'option --set-env-vars plusieurs fois :

   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

Échapper les caractères de virgule

Comme la virgule , est utilisée pour séparer les variables d'environnement, si votre variable d'environnement contient des virgules en tant que valeurs, vous devez échapper ces délimiteurs en spécifiant un caractère de délimitation différent, par exemple @ :

--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

Mettre à jour les variables d'environnement

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

Vous pouvez mettre à jour les variables d'environnement dans la console Google Cloud , Google Cloud CLI ou Terraform :

Console

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

   Accédez à Cloud Run

2. Sélectionnez Pools de nœuds de calcul dans le menu, puis cliquez sur le pool de nœuds de calcul que vous mettez à jour, puis sur Modifier et déployer la nouvelle révision.

3. Cliquez sur Conteneur(s), volumes, mise en réseau, sécurité pour développer la page de configuration des pools de nœuds de calcul.

4. Cliquez sur l'onglet Variables et secrets.

   

5. Recherchez la variable d'environnement que vous souhaitez modifier, puis spécifiez un autre nom ou une autre valeur dans les champs Nom et Valeur.

6. Cliquez sur Déployer.

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 les éléments suivants :

• 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

Terraform

Pour mettre à jour les variables d'environnement d'un pool de nœuds de calcul existant, ouvrez le fichier main.tf correspondant au pool de nœuds de calcul et modifiez les variables de nom et de valeur. Exécutez ensuite la commande pour appliquer la configuration Terraform.

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.

Supprimer des variables d'environnement

Console

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

   Accédez à Cloud Run

2. Sélectionnez Pools de nœuds de calcul dans le menu, puis cliquez sur le pool de nœuds de calcul que vous mettez à jour, puis sur Modifier et déployer la nouvelle révision.

3. Cliquez sur Conteneur(s), volumes, mise en réseau, sécurité pour développer la page de configuration des pools de nœuds de calcul.

4. Cliquez sur l'onglet Variables et secrets.

   

5. Recherchez la variable d'environnement que vous souhaitez supprimer, puis cliquez sur l'icône de corbeille à droite du champ Valeur.

6. Cliquez sur Déployer.

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 les éléments suivants :

• 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 :

• Node.js
• Python
• Go
• Ruby
• PHP
• Java