À propos de ce cours
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.
Un seul domaine : nginx sert Angular et transmet /api à NestJS, maintenu en vie par PM2.

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
| Exigence | Vérification |
|---|---|
| Chaque push et chaque Pull Request déclenchent lint, compilation de l'API et d'Angular, migrations et tests e2e | onglet 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 page | F5 sur /stagiaires: pas de 404 |
API sous /api, joignable seulement par nginx | port 3000 fermé depuis l'extérieur |
| API relancée après un plantage et au redémarrage du serveur | PM2 : ↺, pm2 startup |
| Aucun mot de passe de démonstration en production ; premier administrateur créé par un script | connexion avec le compte créé |
| Mise à jour par un script : pull, ci, build, migrations, reload | sortie 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
- Sur une branche
deploiementdu dépôtgestion-stagiaires, ajoutez un.gitignoreracine (node_modules/,dist/,.angular/,.env…) et les scripts racinelintettest:e2equi appellent ceux de l'API (npm run lint -w api). - É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. - 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 avecactionlint. - 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()etseed()renvoient une promesse ignorée. Écrivezvoid bootstrap();etvoid seed();: on indique que l'on ne l'attend pas volontairement. - Tests: dans un monorepo à workspaces, Jest est installé dans le
node_modulesracine, pas dansapps/api/node_modules. Remplacez./node_modules/jest/bin/jest.jspar../../node_modules/jest/bin/jest.jsdans les scripts de test deapps/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
apps/api/src/main.ts: écoute surHOTE(127.0.0.1en production),trust proxydepuisTRUST_PROXY,enableShutdownHooks().- Scripts de l'API :
start:prod(avec--enable-source-maps),migration:run:prod(CLI TypeORM surdist/data-source.js, sans recompiler) etadmin:creer; scripts racine correspondants. - 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. ecosystem.config.cjsà la racine, aveccwd: apps/apipour que l'API trouve son.env.- Dossier
deploiement/: configuration nginx et scriptdeployer.sh(parties 4 et 5). Complétezapps/api/.env.example. - Rien à changer côté Angular :
environment.prod.tscontient déjàapiUrl: '/api'(TP 12). Comme l'application et l'API sont servies par la même origine,CORS_ORIGINESreste vide. Fusionnez la Pull Request quand la CI est verte.
Partie 3 Préparer le serveur et installer l'application
- En
root: mises à jour, Node.js 24, nginx, MariaDB, Git, PM2, pare-feu, utilisateurdeploy, 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
- En
deploy: clonez le dépôt dans/var/www/gestion-stagiaires, créezapps/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
- 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éé
- 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
- Démarrez l'API avec PM2, enregistrez la liste, puis exécutez en
rootla commande affichée parpm2 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.
- Configuration nginx :
rootpointe sur le build Angular ;/api/est transmis à NestJS ;try_files … /index.htmlrenvoie 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 queindex.htmlne 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
- 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
- Écrivez
deploiement/deployer.sh:git pull --ff-only,npm ci,npm run build,npm run migration:run:prod,pm2 reload,pm2 save, vérification. - 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)
- Créez l'étiquette
v1.1.0et 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
- Ouvrez
http://stagiaires.exemple.tn/stagiaires: redirection HTTPS, puis vers la connexion. Connectez-vous avec le compte créé par le script. - Créez deux stagiaires ; rechargez la page (F5) sur
/stagiaireset/stagiaires/nouveau: aucune erreur 404. - Dans l'onglet Réseau : les requêtes partent vers
/api/…sur le même domaine, sans requêteOPTIONS(pas de CORS). - Plantez l'API (
kill -9 $(pm2 pid gestion-stagiaires-api)) et vérifiez qu'elle revient d'elle-même.

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 surmain. - 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
Dockerfilepour l'API, un service nginx qui sert le build Angular, MariaDB, le tout dans undocker-compose.yml. - Déploiement continu : un job GitHub Actions qui, après la CI sur
main, se connecte en SSH au serveur et lancedeployer.sh, protégé par un environment avec validation manuelle. - Sauvegarde quotidienne de la base avec
mariadb-dumpet une tâchecron, 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ère | Points |
|---|---|
| Workflow GitHub Actions complet (service MariaDB, lint, build API + Angular, migrations, e2e) et vert ; erreurs du TP 12 corrigées | 4 |
| 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 seed | 3 |
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 serveur | 2 |
nginx : Angular, try_files, /api, cache, HTTPS et redirection | 4 |
| Script de mise à jour utilisé pour une vraie mise à jour | 2 |
README (déploiement, badge), commits et étiquette v1.1.0 | 1 |
| Total | 20 |
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !