Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
NestJS

TP 13 : Déployer l'API Full-Stack en production

Ce TP met en production l'application de gestion des stagiaires du TP 12 (monorepo Angular + NestJS). Le dépôt est d'abord préparé : la CI GitHub Actions révèle deux erreurs réelles du TP 12, corrigée...

0 chapitres 0 QCM Accès gratuit
TP 13 : Déployer l'API Full-Stack en production

À propos de ce cours

Ce TP met en production l'application de gestion des stagiaires du TP 12 (monorepo Angular + NestJS). Le dépôt est d'abord préparé : la CI GitHub Actions révèle deux erreurs réelles du TP 12, corrigées, puis l'API reçoit sa configuration de production et un script de création d'administrateur. Sur un serveur Ubuntu, l'API tourne avec PM2 et nginx sert, sur un seul domaine en HTTPS, l'application Angular compilée et l'API sous /api, sans CORS. Un script met l'application à jour en une commande. Déploiement réel, parcours dans Chrome, correction et grille sur 20.

Objectifs du TP

  • Mettre en place l'intégration continue d'un monorepo Angular + NestJS.
  • Préparer une application pour la production : configuration, migrations, premier administrateur.
  • Déployer sur un serveur Linux : PM2 pour l'API, nginx pour Angular et l'API sur un seul domaine HTTPS.
  • Mettre à jour l'application en une commande, sans modifier le code sur le serveur.

Durée: 6 h  |  Prérequis: TP 12 terminé et sur GitHub, chapitre 20  |  Matériel: un VPS Ubuntu 24.04 avec un nom de domaine, ou une machine virtuelle Ubuntu 24.04 (VirtualBox, WSL 2)  |  Livrable: l'adresse de l'application en ligne (ou des captures) et le dépôt avec l'étiquette v1.1.0.

Architecture du TP 13

Un seul domaine : nginx sert Angular et transmet /api à NestJS, maintenu en vie par PM2.

Application déployée

L'application en production sur https://stagiaires.exemple.tn, connectée avec le compte créé par le script (capture réelle dans Chrome).

Cahier des charges
ExigenceVérification
Chaque push et chaque Pull Request déclenchent lint, compilation de l'API et d'Angular, migrations et tests e2eonglet Actions : coche verte
Un seul domaine en HTTPS ; HTTP redirigéhttp://… → 301 vers https://…
Angular servi par nginx ; les adresses comme /stagiaires fonctionnent aussi après un rechargement de la pageF5 sur /stagiaires: pas de 404
API sous /api, joignable seulement par nginxport 3000 fermé depuis l'extérieur
API relancée après un plantage et au redémarrage du serveurPM2 : ↺, pm2 startup
Aucun mot de passe de démonstration en production ; premier administrateur créé par un scriptconnexion avec le compte créé
Mise à jour par un script : pull, ci, build, migrations, reloadsortie du script

Correction réellement déployée: toutes les sorties de ce TP viennent du déploiement de la correction sur le serveur de test du chapitre (Ubuntu 24.04, adresse 192.0.2.2, domaine fictif stagiaires.exemple.tn, certificat de test à la place de Let's Encrypt, dépôt cloné depuis une copie locale du dépôt GitHub). Les étapes de la CI ont été exécutées dans le même ordre, sur un clone neuf, avec MariaDB 10.11.

Partie 1 Préparer le dépôt : la CI d'abord
  1. Sur une branche deploiement du dépôt gestion-stagiaires, ajoutez un .gitignore racine (node_modules/, dist/, .angular/, .env…) et les scripts racine lint et test:e2e qui appellent ceux de l'API (npm run lint -w api).
  2. Écrivez un test e2e de l'API (apps/api/test/stagiaires.e2e-spec.ts) : 401 sans jeton, liste paginée, 403 pour une création par un formateur, 409 pour un e-mail en double. Il utilise la base remplie par le seed.
  3. Créez le workflow .github/workflows/ci.yml: service MariaDB, npm ci à la racine, lint, npm run build (API et Angular), migrations, seed, tests e2e, conservation du build Angular comme artefact. Vérifiez-le avec actionlint.
  4. Avant de pousser, exécutez les mêmes commandes en local. Sur la correction du TP 12, elles révèlent réellement deux erreurs :
$ npm run test:e2e -w api
> api@0.0.1 test:e2e
> node --experimental-vm-modules ./node_modules/jest/bin/jest.js --config ./test/jest-e2e.json
node:internal/modules/cjs/loader:1568
  throw err;
  ^
Error: Cannot find module '~/gestion-stagiaires/apps/api/node_modules/jest/bin/jest.js'
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}
$ npm run lint -w api
> api@0.0.1 lint
> oxlint --type-aware src/ test/

src/main.ts:9:1: error typescript(no-floating-promises): Promises must be awaited, add void operator to ignore. help: The promise must end with a call to .catch, or end with a call to .then with a rejection handler, or be explicitly marked as ignored with the `void` operator.
src/seeds/seed.ts:36:1: error typescript(no-floating-promises): Promises must be awaited, add void operator to ignore. help: The promise must end with a call to .catch, or end with a call to .then with a rejection handler, or be explicitly marked as ignored with the `void` operator.
npm error Lifecycle script `lint` failed with error:
npm error code 1
  • Lint: bootstrap() et seed() renvoient une promesse ignorée. Écrivez void bootstrap(); et void seed();: on indique que l'on ne l'attend pas volontairement.
  • Tests: dans un monorepo à workspaces, Jest est installé dans le node_modules racine, pas dans apps/api/node_modules. Remplacez ./node_modules/jest/bin/jest.js par ../../node_modules/jest/bin/jest.js dans les scripts de test de apps/api/package.json (cette écriture fonctionne aussi sous Windows).

Après correction, les étapes de la CI passent :

$ actionlint .github/workflows/ci.yml && echo "workflow valide"
workflow valide
$ npm ci
added 942 packages, and audited 946 packages in 14s
$ npm run lint
> oxlint --type-aware src/ test/
$ npm run build
Application bundle generation complete. [4.271 seconds] - 2026-11-15T19:35:06.514Z
$ npm run migration:run:prod
1 migrations are new migrations must be executed.
Migration Initialisation1794756939922 has been executed successfully.
$ npm run seed
Comptes : 2, groupes : 3, stagiaires : 12
$ npm run test:e2e
Test Suites: 1 passed, 1 total
Tests:       4 passed, 4 total

Poussez la branche et ouvrez une Pull Request : vérifiez la coche verte dans l'onglet Actions. Commits : fix: promesses non attendues, test(api): e2e des stagiaires, ci: GitHub Actions.

Partie 2 Préparer l'application pour la production
  1. apps/api/src/main.ts: écoute sur HOTE (127.0.0.1 en production), trust proxy depuis TRUST_PROXY, enableShutdownHooks().
  2. Scripts de l'API : start:prod (avec --enable-source-maps), migration:run:prod (CLI TypeORM sur dist/data-source.js, sans recompiler) et admin:creer; scripts racine correspondants.
  3. Script src/scripts/creer-admin.ts (leçon 20.1) : en production, on ne lance pas le seed, qui crée des comptes aux mots de passe connus.
  4. ecosystem.config.cjs à la racine, avec cwd: apps/api pour que l'API trouve son .env.
  5. Dossier deploiement/: configuration nginx et script deployer.sh (parties 4 et 5). Complétez apps/api/.env.example.
  6. Rien à changer côté Angular : environment.prod.ts contient déjà apiUrl: '/api' (TP 12). Comme l'application et l'API sont servies par la même origine, CORS_ORIGINES reste vide. Fusionnez la Pull Request quand la CI est verte.
Partie 3 Préparer le serveur et installer l'application
  1. En root: mises à jour, Node.js 24, nginx, MariaDB, Git, PM2, pare-feu, utilisateur deploy, dossier /var/www/gestion-stagiaires (leçon 20.2, étape 1). Créez la base et son compte :
root@vps:~# mysql -e "CREATE DATABASE gestion_stagiaires CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'gestion'@'localhost' IDENTIFIED BY '********';
GRANT ALL ON gestion_stagiaires.* TO 'gestion'@'localhost';"
ok
  1. En deploy: clonez le dépôt dans /var/www/gestion-stagiaires, créez apps/api/.env (droits 600) :

📄 apps/api/.env (secret masqué)

NODE_ENV=production
PORT=3000
HOTE=127.0.0.1
TRUST_PROXY=loopback
DB_HOTE=localhost
DB_PORT=3306
DB_UTILISATEUR=gestion
DB_MOT_DE_PASSE=Gestion-Prod-2026!
DB_NOM=gestion_stagiaires
JWT_SECRET=••••••••
JWT_DUREE=1h
CORS_ORIGINES=
deploy@vps:/var/www/gestion-stagiaires$ git clone https://github.com/VOTRE_COMPTE/gestion-stagiaires.git .
Cloning into '.'...
done.
deploy@vps:/var/www/gestion-stagiaires$ chmod 600 apps/api/.env && ls -l apps/api/.env
-rw------- 1 deploy deploy 284 Nov 15 19:30 apps/api/.env
  1. Installez, compilez l'API et Angular, créez le schéma et le premier administrateur :
deploy@vps:/var/www/gestion-stagiaires$ npm ci
added 942 packages, and audited 946 packages in 15s
25 vulnerabilities (6 low, 17 moderate, 2 high)
deploy@vps:/var/www/gestion-stagiaires$ npm run build
> build
> npm run build -w api && npm run build -w web
> api@0.0.1 build
> nest build
> web@0.0.0 build
> ng build
❯ Building...
✔ Building...
Initial chunk files | Names         |  Raw size | Estimated transfer size
main-IRQDT6YA.js    | main          | 268.38 kB |                73.84 kB
styles-TQQHL4F2.css | styles        |   1.99 kB |               657 bytes
                    | Initial total | 270.38 kB |                74.50 kB
Lazy chunk files    | Names         |  Raw size | Estimated transfer size
chunk-dcc4vIvO.js   | -             |  51.83 kB |                10.94 kB
chunk-B461GbRx.js   | liste         |   4.31 kB |                 1.73 kB
chunk-BQF5MB7X.js   | formulaire    |   3.49 kB |                 1.41 kB
chunk-b6Lt5PXk.js   | connexion     |   1.60 kB |               820 bytes
chunk-CS3_0JY_.js   | -             | 702 bytes |               702 bytes
chunk-Dg6-PGm2.js   | acces-refuse  | 486 bytes |               486 bytes
Application bundle generation complete. [4.115 seconds] - 2026-11-15T19:31:20.479Z
Output location: /var/www/gestion-stagiaires/apps/web/dist/web
deploy@vps:/var/www/gestion-stagiaires$ npm run migration:run:prod
> migration:run:prod
> npm run migration:run:prod -w api
> api@0.0.1 migration:run:prod
> typeorm -d dist/data-source.js migration:run
0 migrations are already loaded in the database.
1 migrations were found in the source code.
1 migrations are new migrations must be executed.
Migration Initialisation1794756939922 has been executed successfully.
deploy@vps:/var/www/gestion-stagiaires$ ADMIN_EMAIL=direction@exemple.tn ADMIN_NOM='Direction des études' ADMIN_MOT_DE_PASSE='Direction-2026-Prod' npm run admin:creer
> admin:creer
> npm run admin:creer -w api
> api@0.0.1 admin:creer
> node dist/scripts/creer-admin.js
Compte administrateur direction@exemple.tn créé
  1. Les groupes sont des données de référence (le TP 12 n'a pas d'écran pour les créer) : insérez-les en SQL, comme l'administration le ferait une fois.
root@vps:~# mysql gestion_stagiaires -e "INSERT INTO groupes (code, intitule) VALUES ('DEV101','Développement web 1'), ('RES201','Réseaux informatiques'), ('MM301','Multimédia'); SELECT id, code, intitule FROM groupes;" 
id	code	intitule
1	DEV101	Développement web 1
2	RES201	Réseaux informatiques
3	MM301	Multimédia
Partie 4 PM2 et nginx sur un seul domaine
  1. Démarrez l'API avec PM2, enregistrez la liste, puis exécutez en root la commande affichée par pm2 startup:
deploy@vps:/var/www/gestion-stagiaires$ pm2 start ecosystem.config.cjs
[PM2][WARN] Applications gestion-stagiaires-api not running, starting...
[PM2] App [gestion-stagiaires-api] launched (1 instances)
┌────┬───────────────────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name                      │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├────┼───────────────────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 0  │ gestion-stagiaires-api    │ default     │ 0.0.1   │ fork    │ 18488    │ 0s     │ 0    │ online    │ 0%       │ 18.9mb   │ deploy   │ disabled │
└────┴───────────────────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘
deploy@vps:/var/www/gestion-stagiaires$ pm2 save && curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3000/api/groupes
[PM2] Saving current process list...
[PM2] Successfully saved in /home/deploy/.pm2/dump.pm2
401

Le 401 est la réponse attendue : la route est protégée, mais l'API répond.

  1. Configuration nginx : root pointe sur le build Angular ; /api/ est transmis à NestJS ; try_files … /index.html renvoie l'application Angular pour toute adresse qui n'est pas un fichier (c'est le routeur d'Angular qui affiche ensuite la bonne page) ; les fichiers JS et CSS, dont le nom contient une empreinte qui change à chaque build, sont mis en cache un an, alors que index.html ne l'est jamais.

📄 deploiement/nginx-gestion-stagiaires.conf

# /etc/nginx/sites-available/gestion-stagiaires
# Un seul domaine : Angular (fichiers statiques) sur /, l'API NestJS sur /api
upstream gestion_api {
    server 127.0.0.1:3000;
    keepalive 16;
}

server {
    listen 80;
    server_name stagiaires.exemple.tn;
    server_tokens off;
    return 301 https://$host$request_uri;
}

server {
    # nginx 1.24 (Ubuntu 24.04) ; nginx >= 1.25.1 : « listen 443 ssl; » + « http2 on; »
    listen 443 ssl http2;
    server_name stagiaires.exemple.tn;

    ssl_certificate     /etc/letsencrypt/live/stagiaires.exemple.tn/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/stagiaires.exemple.tn/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    server_tokens off;
    client_max_body_size 1m;
    access_log /var/log/nginx/gestion-stagiaires.access.log;
    error_log  /var/log/nginx/gestion-stagiaires.error.log;

    # Angular compilé (ng build)
    root /var/www/gestion-stagiaires/apps/web/dist/web/browser;
    index index.html;

    gzip on;
    gzip_types text/css application/javascript application/json image/svg+xml;

    # API NestJS
    location /api/ {
        proxy_pass http://gestion_api;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # fichiers avec empreinte (main-XXXX.js…) : en cache un an
    location ~* \.(?:js|css|woff2?|png|jpg|svg|ico)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        try_files $uri =404;
    }

    # routes Angular (/stagiaires, /connexion…) : toujours index.html
    location / {
        add_header Cache-Control "no-cache";
        try_files $uri $uri/ /index.html;
    }
}
root@vps:~# cp /var/www/gestion-stagiaires/deploiement/nginx-gestion-stagiaires.conf /etc/nginx/sites-available/gestion-stagiaires
root@vps:~# ln -sf /etc/nginx/sites-available/gestion-stagiaires /etc/nginx/sites-enabled/
root@vps:~# nginx -t && nginx -s reload
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
2026/11/15 20:31:39 [notice] 18521#18521: signal process started
  1. Certificat : certbot --nginx -d stagiaires.exemple.tn (leçon 20.2, étape 5). Vérifiez ensuite chaque exigence :
root@vps:~# curl -sI http://stagiaires.exemple.tn/ | grep -iE "^HTTP|^location"
HTTP/1.1 301 Moved Permanently
Location: https://stagiaires.exemple.tn/
root@vps:~# curl -sk https://stagiaires.exemple.tn/stagiaires | grep -o "<title>.*</title>\|<app-root>"
<title>Centre de formation</title>
<app-root>
root@vps:~# curl -skI https://stagiaires.exemple.tn/main-IRQDT6YA.js | grep -iE "^HTTP|cache-control"
HTTP/2 200 
cache-control: max-age=31536000
cache-control: public, immutable
root@vps:~# curl -sk -X POST https://stagiaires.exemple.tn/api/auth/connexion -H 'Content-Type: application/json' \
  -d '{"email":"direction@exemple.tn","motDePasse":"Direction-2026-Prod"}' | cut -c1-70
{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwiZW1h
root@vps:~# curl -s -m 3 http://192.0.2.2:3000/api/groupes || echo "refusé (code $?)"
refusé (code 7)
Partie 5 Mettre à jour en une commande
  1. Écrivez deploiement/deployer.sh: git pull --ff-only, npm ci, npm run build, npm run migration:run:prod, pm2 reload, pm2 save, vérification.
  2. Sur votre poste, modifiez le titre de l'onglet dans apps/web/src/index.html, passez par une Pull Request (CI verte), fusionnez, puis lancez le script sur le serveur :
deploy@vps:/var/www/gestion-stagiaires$ bash deploiement/deployer.sh
== 1) Code
From https://github.com/VOTRE_COMPTE/gestion-stagiaires
   44ac0b2..75ec125  main       -> origin/main
Updating 44ac0b2..75ec125
Fast-forward
 apps/web/src/index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
== 2) Dépendances et compilation (API + Angular)
added 942 packages in 26s
> build
> npm run build -w api && npm run build -w web
> api@0.0.1 build
> nest build
> web@0.0.0 build
> ng build
Application bundle generation complete. [3.114 seconds] - 2026-11-15T19:33:23.844Z
== 3) Migrations
> migration:run:prod
> npm run migration:run:prod -w api
> api@0.0.1 migration:run:prod
> typeorm -d dist/data-source.js migration:run
No migrations are pending
== 4) Redémarrage de l'API
[PM2] Applying action reloadProcessId on app [gestion-stagiaires-api](ids: [ 0 ])
[PM2] [gestion-stagiaires-api](0) ✓
[PM2] Saving current process list...
[PM2] Successfully saved in /home/deploy/.pm2/dump.pm2
== 5) Vérification
curl: (22) The requested URL returned error: 401
API : 401
root@vps:~# curl -sk https://stagiaires.exemple.tn/ | grep -o "<title>.*</title>"
<title>Gestion des stagiaires</title>
deploy@vps:/var/www/gestion-stagiaires$ git pull --ff-only
From https://github.com/VOTRE_COMPTE/gestion-stagiaires
   75ec125..faf6e74  main       -> origin/main
Updating 75ec125..faf6e74
Fast-forward
 deploiement/deployer.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Le titre est mis à jour sans aucune modification à la main sur le serveur. La première version de la vérification finale utilisait curl -f, qui transforme le 401 attendu en erreur : elle a été corrigée (commit fix(deploiement)) et donne maintenant :

deploy@vps:/var/www/gestion-stagiaires$ bash deploiement/deployer.sh
== 5) Vérification
API : 401 (401 attendu : route protégée, l'API répond)
  1. Créez l'étiquette v1.1.0 et poussez-la. Complétez le README : adresse de production, badge de la CI, section « Déploiement » (préparation du serveur, premier déploiement, mise à jour).
Partie 6 Vérifier dans le navigateur
  1. Ouvrez http://stagiaires.exemple.tn/stagiaires: redirection HTTPS, puis vers la connexion. Connectez-vous avec le compte créé par le script.
  2. Créez deux stagiaires ; rechargez la page (F5) sur /stagiaires et /stagiaires/nouveau: aucune erreur 404.
  3. Dans l'onglet Réseau : les requêtes partent vers /api/… sur le même domaine, sans requête OPTIONS (pas de CORS).
  4. Plantez l'API (kill -9 $(pm2 pid gestion-stagiaires-api)) et vérifiez qu'elle revient d'elle-même.

Formulaire en production

Création d'un stagiaire en production, groupe choisi parmi les données de référence (capture réelle).

Résultat attendu
  • Le dépôt contient le workflow, la configuration PM2, le dossier deploiement/, les tests e2e, et la CI est verte sur main.
  • L'application répond en HTTPS sur un seul domaine ; HTTP est redirigé ; les routes Angular résistent au rechargement ; le port 3000 est fermé.
  • Le premier administrateur a été créé par le script ; aucun compte de démonstration n'existe en production.
  • Une mise à jour se fait par Pull Request (CI) puis bash deploiement/deployer.sh.
Pour aller plus loin
  • Variante Docker (leçon 20.3) : un Dockerfile pour l'API, un service nginx qui sert le build Angular, MariaDB, le tout dans un docker-compose.yml.
  • Déploiement continu : un job GitHub Actions qui, après la CI sur main, se connecte en SSH au serveur et lance deployer.sh, protégé par un environment avec validation manuelle.
  • Sauvegarde quotidienne de la base avec mariadb-dump et une tâche cron, conservée hors du serveur.
  • Supervision : un service externe qui appelle l'application toutes les minutes et vous prévient en cas de panne.
Correction : fichiers ajoutés ou modifiés
package.json

📄 package.json

{
  "name": "gestion-stagiaires",
  "private": true,
  "workspaces": [
    "apps/*",
    "packages/*"
  ],
  "scripts": {
    "dev:api": "npm run start:dev -w api",
    "dev:web": "npm start -w web",
    "dev": "concurrently -n api,web -c red,blue \"npm run dev:api\" \"npm run dev:web\"",
    "build": "npm run build -w api && npm run build -w web",
    "migration:generate": "npm run migration:generate -w api",
    "migration:run": "npm run migration:run -w api",
    "seed": "npm run seed -w api",
    "migration:run:prod": "npm run migration:run:prod -w api",
    "admin:creer": "npm run admin:creer -w api",
    "lint": "npm run lint -w api",
    "test:e2e": "npm run test:e2e -w api"
  },
  "devDependencies": {
    "concurrently": "^9.2.1"
  }
}
apps/api/package.json

📄 apps/api/package.json

{
  "name": "api",
  "version": "0.0.1",
  "description": "",
  "author": "",
  "private": true,
  "license": "UNLICENSED",
  "scripts": {
    "build": "nest build",
    "deploy": "nest deploy",
    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
    "start": "nest start",
    "start:dev": "nest start --watch",
    "start:debug": "nest start --debug --watch",
    "start:prod": "node --enable-source-maps dist/main",
    "lint": "oxlint --type-aware src/ test/",
    "test": "node --experimental-vm-modules ../../node_modules/jest/bin/jest.js",
    "test:watch": "node --experimental-vm-modules ../../node_modules/jest/bin/jest.js --watch",
    "test:cov": "node --experimental-vm-modules ../../node_modules/jest/bin/jest.js --coverage",
    "test:debug": "node --inspect-brk --experimental-vm-modules -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
    "test:e2e": "node --experimental-vm-modules ../../node_modules/jest/bin/jest.js --config ./test/jest-e2e.json",
    "typeorm": "typeorm -d dist/data-source.js",
    "migration:generate": "npm run build && typeorm migration:generate -d dist/data-source.js src/migrations/$npm_config_name",
    "migration:run": "npm run build && typeorm migration:run -d dist/data-source.js",
    "seed": "npm run build && node dist/seeds/seed.js",
    "migration:run:prod": "typeorm -d dist/data-source.js migration:run",
    "admin:creer": "node dist/scripts/creer-admin.js"
  },
  "dependencies": {
    "@nestjs/common": "^12.0.1",
    "@nestjs/config": "^12.1.1",
    "@nestjs/core": "^12.0.1",
    "@nestjs/jwt": "^12.0.5",
    "@nestjs/mapped-types": "^12.0.1",
    "@nestjs/platform-express": "^12.0.1",
    "bcrypt": "^6.0.0",
    "class-transformer": "^0.5.1",
    "class-validator": "^0.15.1",
    "reflect-metadata": "^0.2.2",
    "rxjs": "^7.8.1",
    "@nestjs/typeorm": "^12.0.3",
    "typeorm": "^1.1.3",
    "mysql2": "^3.24.6"
  },
  "devDependencies": {
    "@nestjs/cli": "^12.0.0",
    "@nestjs/mau": "^0.2.6",
    "@nestjs/schematics": "^12.0.0",
    "@nestjs/testing": "^12.0.1",
    "@types/bcrypt": "^6.0.0",
    "@types/express": "^5.0.0",
    "@types/jest": "^30.0.0",
    "@types/node": "^24.0.0",
    "@types/supertest": "^7.0.0",
    "jest": "^30.0.0",
    "oxlint": "^1.58.0",
    "oxlint-tsgolint": "^7.0.2001",
    "prettier": "^3.4.2",
    "source-map-support": "^0.5.21",
    "supertest": "^7.0.0",
    "ts-jest": "^29.4.0",
    "ts-loader": "^9.5.2",
    "ts-node": "^10.9.2",
    "tsconfig-paths": "^4.2.0",
    "typescript": "^6.0.2"
  }
}
apps/api/src/main.ts

📄 apps/api/src/main.ts

import { NestFactory } from '@nestjs/core';
import type { NestExpressApplication } from '@nestjs/platform-express';
import { AppModule } from './app.module';
import { configurerApp } from './configurer-app';

async function bootstrap() {
  const app = await NestFactory.create<NestExpressApplication>(AppModule);
  configurerApp(app);
  // derrière nginx : l'adresse réelle du client est dans X-Forwarded-For
  if (process.env.TRUST_PROXY) app.set('trust proxy', process.env.TRUST_PROXY);
  app.enableShutdownHooks();
  // HOTE=127.0.0.1 en production : l'API n'est joignable que par nginx
  await app.listen(Number(process.env.PORT ?? 3000), process.env.HOTE ?? '0.0.0.0');
}
void bootstrap();
apps/api/src/scripts/creer-admin.ts

📄 apps/api/src/scripts/creer-admin.ts

import * as bcrypt from 'bcrypt';
import source from '../data-source';
import { Utilisateur } from '../utilisateurs/utilisateur.entity';

// Premier compte administrateur en production (pas de seed avec des mots de passe connus) :
//   ADMIN_EMAIL=... ADMIN_NOM=... ADMIN_MOT_DE_PASSE=... npm run admin:creer
async function creerAdmin() {
  const email = process.env.ADMIN_EMAIL?.toLowerCase();
  const motDePasse = process.env.ADMIN_MOT_DE_PASSE ?? '';
  if (!email || motDePasse.length < 12) {
    console.error('ADMIN_EMAIL et ADMIN_MOT_DE_PASSE (12 caractères minimum) sont obligatoires');
    process.exit(1);
  }
  await source.initialize();
  const repo = source.getRepository(Utilisateur);
  if (await repo.existsBy({ email })) {
    console.log(`Le compte ${email} existe déjà : rien à faire`);
  } else {
    await repo.save(repo.create({ email, nom: process.env.ADMIN_NOM ?? 'Administration', role: 'admin', motDePasse: await bcrypt.hash(motDePasse, 12) }));
    console.log(`Compte administrateur ${email} créé`);
  }
  await source.destroy();
}
void creerAdmin();
apps/api/.env.example

📄 apps/api/.env.example

NODE_ENV=development
PORT=3000
# production : 127.0.0.1 (seul nginx peut joindre l'API)
HOTE=0.0.0.0
# production derrière nginx : loopback
TRUST_PROXY=
DB_HOTE=localhost
DB_PORT=3306
DB_UTILISATEUR=apc_dev
DB_MOT_DE_PASSE=
DB_NOM=gestion_stagiaires
JWT_SECRET=
JWT_DUREE=1h
# développement : http://localhost:4200 ; production (même origine) : laisser vide
CORS_ORIGINES=http://localhost:4200
apps/api/test/stagiaires.e2e-spec.ts

📄 apps/api/test/stagiaires.e2e-spec.ts

import { Test } from '@nestjs/testing';
import type { INestApplication } from '@nestjs/common';
import request from 'supertest';
import { AppModule } from '../src/app.module';
import { configurerApp } from '../src/configurer-app';

// Base de test : migrations + seed (npm run seed) exécutés avant les tests
describe('Gestion des stagiaires (e2e)', () => {
  let app: INestApplication;
  let admin: string;
  let formateur: string;

  beforeAll(async () => {
    const module = await Test.createTestingModule({ imports: [AppModule] }).compile();
    app = configurerApp(module.createNestApplication({ logger: false }));
    await app.init();
    const connexion = (email: string, motDePasse: string) =>
      request(app.getHttpServer()).post('/api/auth/connexion').send({ email, motDePasse }).expect(200);
    admin = (await connexion('admin@exemple.tn', 'Admin2026!')).body.access_token;
    formateur = (await connexion('mansouri@exemple.tn', 'Formateur2026')).body.access_token;
  });
  afterAll(() => app.close());

  it('401 sans jeton', () => request(app.getHttpServer()).get('/api/stagiaires').expect(401));

  it('liste paginée', async () => {
    const r = await request(app.getHttpServer()).get('/api/stagiaires?page=1&limite=5')
      .set('Authorization', `Bearer ${formateur}`).expect(200);
    expect(r.body.donnees).toHaveLength(5);
    expect(r.body.total).toBe(12);
  });

  it('création réservée aux administrateurs (403)', () =>
    request(app.getHttpServer()).post('/api/stagiaires').set('Authorization', `Bearer ${formateur}`)
      .send({ nom: 'Test', prenom: 'Test', email: 'test@exemple.tn', dateNaissance: '2005-01-01', groupeId: 1 }).expect(403));

  it('e-mail en double refusé (409)', () =>
    request(app.getHttpServer()).post('/api/stagiaires').set('Authorization', `Bearer ${admin}`)
      .send({ nom: 'Ben Ali', prenom: 'Sami', email: 'sami.benali@exemple.tn', dateNaissance: '2005-01-01', groupeId: 1 }).expect(409));
});
.github/workflows/ci.yml

📄 .github/workflows/ci.yml

name: CI

on:
  push:
    branches: [main]
  pull_request:

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

jobs:
  verifier:
    name: API et Angular
    runs-on: ubuntu-24.04
    timeout-minutes: 15

    services:
      mariadb:
        image: mariadb:10.11
        env:
          MARIADB_ROOT_PASSWORD: racine
          MARIADB_DATABASE: gestion_test
          MARIADB_USER: api
          MARIADB_PASSWORD: api
        ports:
          - 3306:3306
        options: >-
          --health-cmd="healthcheck.sh --connect --innodb_initialized"
          --health-interval=10s --health-timeout=5s --health-retries=10

    env:
      DB_HOTE: 127.0.0.1
      DB_PORT: 3306
      DB_UTILISATEUR: api
      DB_MOT_DE_PASSE: api
      DB_NOM: gestion_test
      JWT_SECRET: secret-de-test-uniquement-pour-la-ci-0123456789
      JWT_DUREE: 1h

    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-node@v7
        with:
          node-version: 24
          cache: npm

      - name: Installer les dépendances (tout le monorepo)
        run: npm ci

      - name: Lint de l'API
        run: npm run lint

      - name: Compiler l'API et Angular
        run: npm run build

      - name: Migrations et données de test
        run: |
          npm run migration:run:prod
          npm run seed

      - name: Tests e2e de l'API
        run: npm run test:e2e

      - name: Conserver le build Angular
        uses: actions/upload-artifact@v7
        with:
          name: angular-dist
          path: apps/web/dist/web/browser
          retention-days: 7
ecosystem.config.cjs

📄 ecosystem.config.cjs

// pm2 start ecosystem.config.cjs
module.exports = {
  apps: [
    {
      name: 'gestion-stagiaires-api',
      cwd: __dirname + '/apps/api', // le .env de l'API est lu dans ce dossier
      script: 'dist/main.js',
      node_args: '--enable-source-maps',
      instances: 1,
      exec_mode: 'fork',
      max_memory_restart: '300M',
      env: { NODE_ENV: 'production' },
      time: true,
    },
  ],
};
deploiement/nginx-gestion-stagiaires.conf

📄 deploiement/nginx-gestion-stagiaires.conf

# /etc/nginx/sites-available/gestion-stagiaires
# Un seul domaine : Angular (fichiers statiques) sur /, l'API NestJS sur /api
upstream gestion_api {
    server 127.0.0.1:3000;
    keepalive 16;
}

server {
    listen 80;
    server_name stagiaires.exemple.tn;
    server_tokens off;
    return 301 https://$host$request_uri;
}

server {
    # nginx 1.24 (Ubuntu 24.04) ; nginx >= 1.25.1 : « listen 443 ssl; » + « http2 on; »
    listen 443 ssl http2;
    server_name stagiaires.exemple.tn;

    ssl_certificate     /etc/letsencrypt/live/stagiaires.exemple.tn/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/stagiaires.exemple.tn/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    server_tokens off;
    client_max_body_size 1m;
    access_log /var/log/nginx/gestion-stagiaires.access.log;
    error_log  /var/log/nginx/gestion-stagiaires.error.log;

    # Angular compilé (ng build)
    root /var/www/gestion-stagiaires/apps/web/dist/web/browser;
    index index.html;

    gzip on;
    gzip_types text/css application/javascript application/json image/svg+xml;

    # API NestJS
    location /api/ {
        proxy_pass http://gestion_api;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # fichiers avec empreinte (main-XXXX.js…) : en cache un an
    location ~* \.(?:js|css|woff2?|png|jpg|svg|ico)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        try_files $uri =404;
    }

    # routes Angular (/stagiaires, /connexion…) : toujours index.html
    location / {
        add_header Cache-Control "no-cache";
        try_files $uri $uri/ /index.html;
    }
}
deploiement/deployer.sh

📄 deploiement/deployer.sh

#!/bin/bash
# Mise à jour de l'application sur le serveur (utilisateur deploy) : bash deploiement/deployer.sh
set -euo pipefail
cd /var/www/gestion-stagiaires

echo "== 1) Code"
git pull --ff-only

echo "== 2) Dépendances et compilation (API + Angular)"
npm ci --no-audit --no-fund
npm run build

echo "== 3) Migrations"
npm run migration:run:prod | grep -vE '^query:' || true

echo "== 4) Redémarrage de l'API"
pm2 reload ecosystem.config.cjs --update-env
pm2 save

echo "== 5) Vérification"
sleep 3
curl -sS -o /dev/null -w "API : %{http_code} (401 attendu : route protégée, l'API répond)\n" http://127.0.0.1:3000/api/groupes
.gitignore

📄 .gitignore

node_modules/
dist/
.angular/
coverage/
*.tsbuildinfo
.env
*.log
Grille d'évaluation
CritèrePoints
Workflow GitHub Actions complet (service MariaDB, lint, build API + Angular, migrations, e2e) et vert ; erreurs du TP 12 corrigées4
Tests e2e pertinents (401, pagination, 403, 409)2
Application prête pour la production : HOTE, TRUST_PROXY, scripts de production, création de l'administrateur sans seed3
Serveur : utilisateur dédié, pare-feu, base et compte dédiés, .env protégé2
PM2 : ecosystem, redémarrage automatique vérifié, démarrage avec le serveur2
nginx : Angular, try_files, /api, cache, HTTPS et redirection4
Script de mise à jour utilisé pour une vraie mise à jour2
README (déploiement, badge), commits et étiquette v1.1.01
Total20

Cet article vous a-t-il aidé ?