Guides

Multi-environnements

Organiser vos variables selon les différents contextes d'exécution.

Concept

Un environnement représente un contexte d'exécution de votre application. Chaque environnement peut avoir ses propres valeurs pour les mêmes variables.

Variable	development	production
DATABASE_URL	localhost:5432	prod-db.aws.com
DEBUG	true	false
LOG_LEVEL	debug	error

Types d'environnements courants

🛠️ development

Environnement local des développeurs. Base de données locale, logs verbeux, debug activé.

🧪 test

Pour les tests automatisés (CI/CD). Base de données de test, mocks pour services externes.

🎭 staging

Réplique de la production pour les tests d'intégration. Données de test, services réels en mode sandbox.

🚀 production

Environnement live. Vraies données, vraies credentials, logs minimaux.

Créer des environnements

bashbash

# Créer les environnements standard
bunkle env add development
bunkle env add test
bunkle env add staging
bunkle env add production
# Vérifier avec status
bunkle status
# Envs: development, test, staging, production

Utiliser les environnements

Ajouter des variables par environnement

bashbash

# Même variable, valeurs différentes
bunkle var add API_URL "http://localhost:3000" --env development
bunkle var add API_URL "https://staging.api.com" --env staging
bunkle var add API_URL "https://api.com" --env production

Récupérer un environnement spécifique

bashbash

# Générer .env.development
bunkle pull mon-api --env development --output .
# Générer .env.production
bunkle pull mon-api --env production --output .

Intégration avec les frameworks

Next.js

bashbash

# Next.js charge automatiquement .env.local, .env.development, .env.production
bunkle pull mon-api --env development --output .
# Crée .env.development

Node.js (dotenv)

bashbash

# Générer le fichier .env
bunkle pull mon-api --env production --output .
# Dans votre code
require('dotenv').config({ path: '.env.production' })

Docker

bashbash

# Générer le .env pour Docker
bunkle pull mon-api --env production --output .
# Utiliser dans docker-compose.yml
# env_file:
#   - .env.production

Voir aussi

bunkle env add — Commande pour créer un environnement
Workflow complet — Guide pour équipes