Groupes d’environnement

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

Créer un groupe#

1. 1

   Ouvrez 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 restent, sauf si le fichier les redéfinit, auquel cas le fichier l’emporte. Pour supprimer toutes les clés absentes du fichier, importez en mode replace. Même dans ce cas, les variables secrètes sont conservées, car personne ne peut les relire pour les renvoyer.

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://api.gheima.ma/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. Sur une clé commune, le groupe attaché le plus récemment l’emporte.
• 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’env sur votre compte dépend de votre plan.