Accueil › Angular › Configurer selon l'environnement
Configurer selon l'environnement
Build, outils et déploiementavance
Angular propose deux manières de faire varier le comportement d'une application selon l'environnement (développement, recette, production).
Configurations angular.json + fileReplacements — l'approche historique et la plus simple. Le schematic ng generate environments crée src/environments/environment.ts et environment.development.ts, et câble automatiquement le fileReplacements correspondant. On peut ajouter d'autres fichiers (environment.staging.ts) et déclarer une nouvelle configuration nommée dans angular.json :
"configurations": {
"staging": {
"fileReplacements": [
{ "replace": "src/environments/environment.ts", "with": "src/environments/environment.staging.ts" }
]
}
}
ng build --configuration staging
Limite importante : la valeur est figée au moment du build. Changer d'environnement veut dire reconstruire — donc un artefact (bundle) différent par environnement. Pour une application déployée telle quelle (même image Docker, même bundle) de la recette à la production, ce n'est pas toujours souhaitable.
Configuration chargée à l'exécution — un fichier JSON (config.json) déployé à côté du bundle et récupéré par une requête HTTP au démarrage, avant l'affichage de l'application. Un seul build sert alors tous les environnements ; seul ce fichier change, généralement injecté par la plateforme de déploiement. C'est l'approche à privilégier quand le même artefact doit être promu d'un environnement à l'autre sans reconstruction.
Dans les deux cas, jamais de secret (clé d'API, mot de passe) dans ces fichiers : ils sont livrés au navigateur et lisibles par n'importe qui. isDevMode() reste utile pour adapter un comportement au mode développement, sans dépendre d'un fichier d'environnement — sa valeur reflète automatiquement l'option optimization du build.
Les termes à connaître
- Configuration (angular.json)
Ensemble nommé d'options de build (
production,development, ou une configuration personnalisée commestaging) déclaré sousconfigurationsdans une cible de build, et activé avec--configuration <nom>.- fileReplacements
Option d'une configuration qui remplace un fichier TypeScript par un autre à la compilation — typiquement
environment.tsparenvironment.staging.ts. Le fichier remplacé n'existe pas dans le bundle final.- ng generate environments
Schematic qui crée le dossier
src/environments/(environment.ts,environment.development.ts) et configure automatiquement lefileReplacementscorrespondant dansangular.json. Les fichiers d'environnement ne sont plus générés par défaut parng new.- Configuration chargée à l'exécution
Approche alternative aux
fileReplacements: un fichier JSON (ex.config.json) déployé à côté du build et chargé par une requête HTTP au démarrage, avant que l'application ne s'affiche. Un seul build sert alors tous les environnements ; seul ce fichier change entre eux.- isDevMode()
Fonction de
@angular/corequi indique si l'application tourne en mode développement. Sa valeur reflète automatiquement l'optionoptimizationdu build utilisé (falseavec la configurationproduction) — aucun appel àenableProdMode()n'est nécessaire.- Secret d'application
Clé d'API privée, mot de passe, jeton d'accès backend… Un fichier
environment.ts(ou unconfig.jsonchargé à l'exécution) est livré au navigateur et lisible par n'importe qui : il ne doit jamais contenir de secret, seulement des valeurs déjà publiques (URL d'API, indicateurs de fonctionnalité).
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.