Accueil › Angular › Déployer et automatiser
Déployer et automatiser
Build, outils et déploiementavance
Une application Angular sans SSR se déploie comme n'importe quel site statique : copier le contenu de dist/<projet>/browser sur un hébergeur de fichiers ou un CDN. Deux points spécifiques à une application avec routeur :
- si elle n'est pas servie à la racine du domaine, reconstruire avec
ng build --base-href /chemin/pour que la balise<base>et les URL générées correspondent réellement à l'emplacement de déploiement ; - configurer une réécriture d'URL vers
index.htmlcôté serveur (ou CDN) pour toute URL sans fichier correspondant : sans elle, rafraîchir la page sur une route profonde (/produits/42) renvoie une 404, le routeur Angular n'ayant pas encore eu l'occasion de s'exécuter côté client.
Pour le cache HTTP, les fichiers empreints (main-4F2K9X1A.js) supportent un Cache-Control très long (immutable) puisqu'un contenu modifié change de nom ; index.html, à nom fixe mais contenu changeant à chaque déploiement, doit rester non caché ou revalidé systématiquement.
Une application SSR ne se limite pas à des fichiers statiques : le dossier server/ produit par le build (ex. server.mjs) doit tourner comme un processus Node actif en permanence, le plus souvent packagé dans un conteneur.
Un pipeline d'intégration continue type enchaîne : installer les dépendances, vérifier le format/lint, tester, construire, déployer — chaque étape ne se lançant que si la précédente réussit. Pour monter de version, ng update @angular/cli@21 @angular/core@21 applique les migrations automatiques associées, une version majeure à la fois.
Les termes à connaître
- Réécriture d'URL vers index.html
Règle configurée sur le serveur ou le CDN qui répond avec
index.htmlpour toute URL sans fichier correspondant sur le disque. Indispensable dès qu'une application utilise le routeur Angular : sans elle, rafraîchir la page sur/produits/42renvoie une 404, car ce chemin n'existe que côté client.- --base-href
Option de
ng buildqui fixe la valeur de la balise<base href>dansindex.html. Le routeur et le chargement des ressources s'appuient sur cette base : elle doit correspondre exactement au chemin sous lequel l'application est réellement servie quand elle n'est pas à la racine du domaine (ex./boutique-admin/).- En-tête Cache-Control
En-tête HTTP qui indique au navigateur (et aux caches intermédiaires, CDN compris) combien de temps garder une ressource sans la revalider. Les fichiers empreints (
main-4F2K9X1A.js) supportent un cache très long (immutable) ;index.html, jamais empreint, doit rester non caché ou revalidé à chaque requête.- Pipeline d'intégration continue (CI)
Suite d'étapes automatisées, déclenchées à chaque changement de code (ou à intervalles réguliers), qui installe les dépendances, vérifie le code, exécute les tests, construit l'application, puis la déploie — dans cet ordre, chaque étape ne s'exécutant que si la précédente réussit.
- ng update
Commande du CLI Angular qui met à jour les paquets d'un workspace et exécute les migrations automatiques (schematics) associées à la nouvelle version. Une montée de version majeure se fait une version à la fois (jamais en sautant une version majeure), en suivant le guide de mise à jour officiel.
- Déploiement SSR
Contrairement à une application purement statique, une application avec rendu côté serveur nécessite d'exécuter le code produit sous
server/(ex.server.mjs) dans un processus Node actif en permanence — typiquement packagé dans un conteneur — plutôt que de simplement copier des fichiers sur un hébergeur statique.- Hébergement statique
Service qui sert des fichiers tels quels (HTML, JS, CSS, images) sans exécuter de code serveur — suffisant pour une application Angular sans SSR, dont tout le rendu se fait dans le navigateur. Un CDN place en plus des copies de ces fichiers géographiquement proches des utilisateurs.
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.