docs
Dashboard
Guides

Workflow complet

Guide étape par étape pour gérer vos variables d'environnement en équipe.

Scénario

Vous développez une API avec plusieurs environnements (development, staging, production) et devez partager les variables avec votre équipe de manière sécurisée.

Étape 1 : Configuration initiale

Le lead développeur configure le projet une première fois :

bashbash
# Se connecter
bunkle login
# Créer le projet
bunkle create mon-api -d "API principale"
# Créer les environnements
bunkle env add development
bunkle env add staging
bunkle env add production

Étape 2 : Ajouter les variables

Définir les variables pour chaque environnement :

bashbash
# Variables de développement
bunkle var add DATABASE_URL "postgres://localhost:5432/dev" --env development
bunkle var add API_KEY "dev-key-123" --env development
bunkle var add DEBUG "true" --env development
# Variables de staging
bunkle var add DATABASE_URL "postgres://staging-db:5432/stage" --env staging
bunkle var add API_KEY "staging-key-456" --env staging
bunkle var add DEBUG "true" --env staging
# Variables de production
bunkle var add DATABASE_URL "postgres://prod-db:5432/prod" --env production
bunkle var add API_KEY "prod-key-789" --env production
bunkle var add DEBUG "false" --env production

Étape 3 : Onboarding d'un développeur

Un nouveau développeur rejoint l'équipe. Il peut récupérer les variables en quelques commandes :

bashbash
# Se connecter avec son compte
bunkle login
# Lister les projets disponibles
bunkle projects
# Récupérer les variables de développement
bunkle pull mon-api --env development --output .
# Le fichier .env.development est créé !
cat .env.development
# DATABASE_URL=postgres://localhost:5432/dev
# API_KEY=dev-key-123
# DEBUG=true

Étape 4 : Modifier une variable

Si une variable doit être mise à jour (ex: rotation de clé API) :

bashbash
# Mettre à jour la clé API de production
bunkle var add API_KEY "new-prod-key-abc" --env production --project mon-api
# Tous les développeurs peuvent maintenant récupérer la nouvelle valeur
bunkle pull mon-api --env production --output .

Étape 5 : Synchroniser depuis un fichier local

Si vous préférez modifier le fichier .env localement puis synchroniser :

bashbash
# Modifier le fichier .env.development localement
echo "NEW_VAR=hello" >> .env.development
# Synchroniser vers Bunkle
bunkle push --file .env.development --env development
# Les modifications sont maintenant disponibles pour toute l'équipe

Bonnes pratiques

✅ Utiliser des noms descriptifs

Préférez STRIPE_SECRET_KEY à KEY1

✅ Séparer les environnements

Ne jamais utiliser les mêmes credentials entre dev et production

✅ Rotation régulière des secrets

Changez les clés API et mots de passe périodiquement

✅ Ne pas commiter les .env

Ajoutez .env* à votre .gitignore

Voir aussi