API Nations — conteneurisation et déploiement Kubernetes
Une API REST de données sur les pays du monde et son interface React, conteneurisées avec Docker, publiées automatiquement sur Docker Hub et déployées sur Kubernetes avec mise à jour progressive (rolling update).
🔗 Démo en ligne : https://api-nations.bartzcyril.fr
Sujet
Projet de formation centré sur l'infrastructure.
- Réorganiser le dépôt en deux services (
backend/,frontend/) et écrire leurs Dockerfiles - Automatiser la construction et la publication des images sur Docker Hub avec GitHub Actions
- Écrire les manifestes Kubernetes (Deployments + Services), avec une variante en rolling update
L'application déployée
- 3 niveaux de détail pour les pays :
/full(toutes les données),/normal(nom, devises, langues, capitale, population…),/short(nom, codes ISO, drapeau) - Recherche de pays
- Authentification JWT et contrôle d'accès par rôle : un administrateur gère la liste des personnes autorisées, seules capables de modifier les données des pays
- Tests unitaires et fonctionnels avec Jest et Supertest
Infrastructure
GitHub (push sur main)
└── GitHub Actions : build des images backend et frontend, push sur Docker Hub
│
Kubernetes ▼
├── Deployment backend (3 réplicas) → Service ClusterIP (interne)
└── Deployment frontend (3 réplicas) → Service LoadBalancer (port 80, exposé)
| Fichier | Rôle |
|---|---|
backend/Dockerfile |
Image Node.js de l'API |
frontend/Dockerfile |
Build multi-étapes : compilation React avec Node, puis service des fichiers statiques par Nginx |
.github/workflows/docker-image.yml |
Build et push des deux images sur Docker Hub (Buildx, QEMU) |
backend-deployment.yaml, frontend-deployment.yaml |
Déploiement de base : 3 réplicas par service |
rolling-update-*-deployment.yaml |
Même déploiement avec stratégie RollingUpdate (maxSurge: 1) pour mettre à jour sans interruption |
Compétences acquises
- Docker : écriture de Dockerfiles, build multi-étapes pour alléger l'image du front (Nginx)
- CI/CD : pipeline GitHub Actions qui construit et publie les images, gestion des secrets (identifiants Docker Hub)
- Kubernetes : Deployments, réplicas, Services
ClusterIPvsLoadBalancer - Déploiement sans interruption avec la stratégie de rolling update
- Haute disponibilité : plusieurs réplicas de chaque service derrière un Service Kubernetes
- Lecture et reprise d'un projet existant écrit par quelqu'un d'autre
Lancer le projet
Avec Docker
docker build -t api-nations-back ./backend
docker build -t api-nations-front ./frontend
Sur Kubernetes (Minikube, kind…)
kubectl apply -f backend-deployment.yaml -f frontend-deployment.yaml
# ou, pour la stratégie de mise à jour progressive :
kubectl apply -f rolling-update-backend-deployment.yaml -f rolling-update-frontend-deployment.yaml
kubectl get pods,services
En local, sans conteneur
cd backend/app
cp .env.example .env # renseigner PORT, JWT_SECRET, URL_ORIGIN
npm install
npm run dev
npm test
cd ../../frontend/app
npm install
npm start