Groupes d’environnement

Un groupe d’environnement est un jeu réutilisable de variables d’environnement que vous attachez à un ou plusieurs services. Au déploiement, les variables d’un groupe sont injectées dans chaque service attaché — les variables propres au service ont toujours priorité, ce qui permet de surcharger une valeur par défaut partagée pour un service donné.

Créer un groupe#

1. 1

   Ouvrir Groupes d’env.

   Depuis la barre latérale, ouvrez Groupes d’env. et cliquez sur « Nouveau groupe ».

2. 2

   Ajouter des variables

   Ajoutez des clés et valeurs une par une, ou importez un fichier .env pour remplir le groupe en une fois.

3. 3

   Attacher aux services

   Attachez le groupe à tout service devant recevoir ses variables.

Importer un fichier .env#

L’import fusionne par défaut — les clés existantes sont conservées sauf si le fichier les redéfinit, auquel cas le fichier l’emporte. Choisissez remplacer pour au contraire éliminer tout ce qui n’est pas dans le fichier.

Via la CLI#

gheima env-groups create shared
gheima env-groups import grp_123 .env.production
gheima env-groups attach grp_123 my-app
gheima env-groups detach grp_123 my-app

Via l’API#

curl -X POST https://gheima.ma/api/v1/env-groups \
  -H "Authorization: Bearer $GHEIMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"shared"}'

Priorité & limites#

• Les variables propres à un service l’emportent toujours sur une valeur venant d’un groupe attaché.
• Quand plusieurs groupes sont attachés à un service, ils fusionnent dans l’ordre d’attachement — le groupe attaché le plus récemment gagne sur une clé partagée.
• Supprimer un groupe le détache de tous les services ; le changement prend effet au prochain déploiement de chacun.
• Le nombre maximal de groupes d’environnement sur votre compte dépend de votre offre.