Formations — 1 037 leçons en français

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 comme staging) déclaré sous configurations dans 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.ts par environment.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 le fileReplacements correspondant dans angular.json. Les fichiers d'environnement ne sont plus générés par défaut par ng 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/core qui indique si l'application tourne en mode développement. Sa valeur reflète automatiquement l'option optimization du build utilisé (false avec la configuration production) — 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 un config.json chargé à 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é).

Lire l'explication détaillée et faire le quiz →

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.