Dans un BTS CIEL ou SIO, tu vas souvent d\u00e9velopper des services r\u00e9seau capables d\u2019\u00e9changer des donn\u00e9es avec d\u2019autres applications. Les API REST occupent aujourd\u2019hui une place centrale dans les architectures modernes. On les retrouve dans les applications web, les outils d\u2019administration, les plateformes cloud, les objets connect\u00e9s ou encore les infrastructures DevOps.<\/p>\n\n\n\n
Flask permet de cr\u00e9er rapidement une API en Python avec une architecture simple et l\u00e9g\u00e8re. Docker apporte ensuite un environnement isol\u00e9 et reproductible pour ex\u00e9cuter cette API de mani\u00e8re fiable sur n\u2019importe quel serveur Linux.<\/p>\n\n\n\n
Dans cette fiche, tu vas apprendre \u00e0 :<\/p>\n\n\n\n
L\u2019objectif consiste \u00e0 mettre en \u0153uvre une API Flask dans un conteneur Docker comme on le ferait dans un environnement professionnel.<\/p>\n\n\n\n
Flask est un micro-framework Python destin\u00e9 au d\u00e9veloppement web et aux API REST.<\/p>\n\n\n\n
Tu peux :<\/p>\n\n\n\n
Exemple d\u2019utilisation :<\/p>\n\n\n\n
Docker permet d\u2019ex\u00e9cuter une application dans un conteneur isol\u00e9.<\/p>\n\n\n\n
Le conteneur embarque :<\/p>\n\n\n\n
Tu \u00e9vites ainsi les probl\u00e8mes de compatibilit\u00e9 entre machines.<\/p>\n\n\n\n
sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\napt update<\/code> : met \u00e0 jour la liste des paquets<\/li>\n\n\n\napt upgrade<\/code> : installe les nouvelles versions<\/li>\n\n\n\n-y<\/code> : valide automatiquement<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n4.2 Installation de Docker<\/h2>\n\n\n\nsudo apt install docker.io -y<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\ndocker.io<\/code> : paquet Docker officiel Debian\/Ubuntu<\/li>\n\n\n\n-y<\/code> : \u00e9vite la confirmation interactive<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n4.3 V\u00e9rification du service<\/h2>\n\n\n\nsudo systemctl status docker<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nsystemctl<\/code> pilote les services systemd<\/li>\n\n\n\nstatus<\/code> affiche l\u2019\u00e9tat du service Docker<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n4.4 Activation automatique au d\u00e9marrage<\/h2>\n\n\n\nsudo systemctl enable docker<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nenable<\/code> active le d\u00e9marrage automatique du service<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n4.5 Ajouter son utilisateur au groupe docker<\/h2>\n\n\n\nsudo usermod -aG docker $USER<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nusermod<\/code> modifie un utilisateur<\/li>\n\n\n\n-aG<\/code> ajoute un groupe sans supprimer les autres<\/li>\n\n\n\ndocker<\/code> : groupe autoris\u00e9 \u00e0 utiliser Docker<\/li>\n<\/ul>\n\n\n\nRecharge ensuite la session :<\/p>\n\n\n\n
newgrp docker<\/code><\/pre>\n\n\n\n
\n\n\n\n5. Architecture du projet Flask<\/h1>\n\n\n\n5.1 Arborescence<\/h2>\n\n\n\nflask-api\/
\u251c\u2500\u2500 app.py
\u251c\u2500\u2500 requirements.txt
\u251c\u2500\u2500 Dockerfile
\u2514\u2500\u2500 .dockerignore<\/code><\/pre>\n\n\n\n
\n\n\n\n6. Cr\u00e9ation de l\u2019API Flask<\/h1>\n\n\n\n6.1 Cr\u00e9ation du dossier<\/h2>\n\n\n\nmkdir flask-api
cd flask-api<\/code><\/pre>\n\n\n\n
\n\n\n\n6.2 Cr\u00e9ation du fichier app.py<\/h2>\n\n\n\nfrom flask import Flask, jsonify, request
app = Flask(__name__)
@app.route(\"\/\")
def accueil():
return jsonify({\"message\": \"API Flask op\u00e9rationnelle\"})
@app.route(\"\/ping\")
def ping():
return jsonify({\"response\": \"pong\"})
@app.route(\"\/addition\", methods=[\"POST\"])
def addition():
data = request.get_json()
a = data.get(\"a\", 0)
b = data.get(\"b\", 0)
resultat = a + b
return jsonify({
\"a\": a,
\"b\": b,
\"resultat\": resultat
})
if __name__ == \"__main__\":
app.run(host=\"0.0.0.0\", port=5000)<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\n@app.route()<\/code> cr\u00e9e une route HTTP<\/li>\n\n\n\nGET<\/code> r\u00e9cup\u00e8re des informations<\/li>\n\n\n\nPOST<\/code> envoie des donn\u00e9es<\/li>\n\n\n\njsonify()<\/code> retourne du JSON valide<\/li>\n\n\n\n0.0.0.0<\/code> \u00e9coute sur toutes les interfaces r\u00e9seau<\/li>\n\n\n\n5000<\/code> correspond au port Flask par d\u00e9faut<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n6.3 Cr\u00e9ation du fichier requirements.txt<\/h2>\n\n\n\nflask<\/code><\/pre>\n\n\n\nCe fichier liste les d\u00e9pendances Python.<\/p>\n\n\n\n
\n\n\n\n7. Cr\u00e9ation du conteneur Docker<\/h1>\n\n\n\n7.1 Cr\u00e9ation du Dockerfile<\/h2>\n\n\n\n
Le fichier Dockerfile<\/code> d\u00e9crit comment construire le conteneur.<\/p>\n\n\n\n
\n\n\n\n8. Construction et lancement du conteneur<\/h1>\n\n\n\n8.1 Construction de l\u2019image Docker<\/h2>\n\n\n\ndocker build -t flask-api .<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nbuild<\/code> construit l\u2019image<\/li>\n\n\n\n-t<\/code> ajoute un nom<\/li>\n\n\n\n.<\/code> utilise le dossier courant<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n8.2 V\u00e9rification des images<\/h2>\n\n\n\ndocker images<\/code><\/pre>\n\n\n\n
\n\n\n\n8.3 Lancement du conteneur<\/h2>\n\n\n\ndocker run -d -p 5000:5000 --name flask-api flask-api<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nrun<\/code> d\u00e9marre un conteneur<\/li>\n\n\n\n-d<\/code> lance en arri\u00e8re-plan<\/li>\n\n\n\n-p 5000:5000<\/code> :\n\n- port h\u00f4te : 5000<\/li>\n\n\n\n
- port conteneur : 5000<\/li>\n<\/ul>\n<\/li>\n\n\n\n
--name<\/code> attribue un nom<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n9. Tests de l\u2019API<\/h1>\n\n\n\n9.1 Tester la route principale<\/h2>\n\n\n\ncurl http:\/\/127.0.0.1:5000\/<\/code><\/pre>\n\n\n\nR\u00e9sultat :<\/p>\n\n\n\n
{\"message\":\"API Flask op\u00e9rationnelle\"}<\/code><\/pre>\n\n\n\n
\n\n\n\n9.2 Tester la route ping<\/h2>\n\n\n\ncurl http:\/\/127.0.0.1:5000\/ping<\/code><\/pre>\n\n\n\n
\n\n\n\n9.3 Tester la route POST<\/h2>\n\n\n\ncurl -X POST http:\/\/127.0.0.1:5000\/addition \\
-H \"Content-Type: application\/json\" \\
-d '{\"a\":10,\"b\":5}'<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\n-X POST<\/code> force la m\u00e9thode POST<\/li>\n\n\n\n-H<\/code> ajoute un header HTTP<\/li>\n\n\n\n-d<\/code> envoie des donn\u00e9es JSON<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n10. Gestion r\u00e9seau et pare-feu<\/h1>\n\n\n\n10.1 Ports utilis\u00e9s<\/h2>\n\n\n\nService<\/th> Port<\/th><\/tr><\/thead> Flask<\/td> 5000\/tcp<\/td><\/tr> HTTP standard<\/td> 80\/tcp<\/td><\/tr> HTTPS<\/td> 443\/tcp<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n10.2 Autoriser le port avec UFW<\/h2>\n\n\n\nsudo ufw allow 5000\/tcp<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nallow<\/code> autorise le trafic<\/li>\n\n\n\n5000\/tcp<\/code> cible Flask<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n10.3 V\u00e9rifier les r\u00e8gles<\/h2>\n\n\n\nsudo ufw status verbose<\/code><\/pre>\n\n\n\n
\n\n\n\n10.4 Cas production<\/h2>\n\n\n\n
En environnement r\u00e9el :<\/p>\n\n\n\n
\n- Flask ne doit pas \u00eatre expos\u00e9 directement ;<\/li>\n\n\n\n
- on utilise g\u00e9n\u00e9ralement :\n
\n- Nginx ;<\/li>\n\n\n\n
- Apache ;<\/li>\n\n\n\n
- Traefik ;<\/li>\n\n\n\n
- HAProxy.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n11. Fichiers importants<\/h1>\n\n\n\nFichier<\/th> R\u00f4le<\/th><\/tr><\/thead> \/opt\/flask-api\/app.py<\/code><\/td>code principal Flask<\/td><\/tr> \/opt\/flask-api\/requirements.txt<\/code><\/td>d\u00e9pendances Python<\/td><\/tr> \/opt\/flask-api\/Dockerfile<\/code><\/td>construction du conteneur<\/td><\/tr> \/var\/lib\/docker\/<\/code><\/td>stockage Docker<\/td><\/tr> \/etc\/docker\/daemon.json<\/code><\/td>configuration Docker<\/td><\/tr> \/var\/log\/docker.log<\/code><\/td>logs Docker selon configuration<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n12. Bloc de configuration complet<\/h1>\n\n\n\n12.1 Synth\u00e8se Markdown pour ta fiche bristol<\/h2>\n\n\n\n# API Flask avec Docker
## Installation Docker
```bash
sudo apt update
sudo apt install docker.io -y
sudo systemctl enable docker
sudo systemctl start docker
```
## Construction image
```bash
docker build -t flask-api .
```
## Lancement conteneur
```bash
docker run -d -p 5000:5000 --name flask-api flask-api
```
## V\u00e9rification
```bash
docker ps
docker logs flask-api
```
## Test API
```bash
curl http:\/\/127.0.0.1:5000\/
```
## Pare-feu
```bash
sudo ufw allow 5000\/tcp
```<\/code><\/pre>\n\n\n\n12.2 Bloc de configuration Docker complet<\/h2>\n\n\n\nFROM python:3.12-slim
WORKDIR \/app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py .
EXPOSE 5000
CMD [\"python\", \"app.py\"]<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nFROM<\/code> d\u00e9finit l\u2019image de base<\/li>\n\n\n\nWORKDIR<\/code> cr\u00e9e le dossier de travail<\/li>\n\n\n\nCOPY<\/code> copie les fichiers<\/li>\n\n\n\nRUN<\/code> ex\u00e9cute des commandes<\/li>\n\n\n\nEXPOSE<\/code> documente le port<\/li>\n\n\n\nCMD<\/code> lance l\u2019application<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n13. Explications d\u00e9taill\u00e9es<\/h1>\n\n\n\n13.1 Pourquoi utiliser Docker avec Flask<\/h2>\n\n\n\n
Docker apporte plusieurs avantages :<\/p>\n\n\n\n
\n- environnement identique partout ;<\/li>\n\n\n\n
- d\u00e9ploiement rapide ;<\/li>\n\n\n\n
- isolation ;<\/li>\n\n\n\n
- portabilit\u00e9 ;<\/li>\n\n\n\n
- facilit\u00e9 de sauvegarde ;<\/li>\n\n\n\n
- int\u00e9gration DevOps.<\/li>\n<\/ul>\n\n\n\n
Tu peux lancer le m\u00eame conteneur :<\/p>\n\n\n\n
\n- sur Debian ;<\/li>\n\n\n\n
- Ubuntu ;<\/li>\n\n\n\n
- Proxmox ;<\/li>\n\n\n\n
- cloud ;<\/li>\n\n\n\n
- Raspberry Pi.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n13.2 Pourquoi utiliser Flask<\/h2>\n\n\n\n
Flask reste tr\u00e8s adapt\u00e9 aux projets BTS :<\/p>\n\n\n\n
\n- syntaxe simple ;<\/li>\n\n\n\n
- rapide \u00e0 apprendre ;<\/li>\n\n\n\n
- peu de d\u00e9pendances ;<\/li>\n\n\n\n
- id\u00e9al pour comprendre HTTP et REST.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n14. Exemples concrets<\/h1>\n\n\n\n14.1 API de supervision r\u00e9seau<\/h2>\n\n\n\n
Routes possibles :<\/p>\n\n\n\n
\/api\/ping
\/api\/status
\/api\/temperature
\/api\/cpu<\/code><\/pre>\n\n\n\n
\n\n\n\n14.2 API pour un serveur MQTT<\/h2>\n\n\n\n
Tu peux interfacer :<\/p>\n\n\n\n
\n- Mosquitto ;<\/li>\n\n\n\n
- Node-RED ;<\/li>\n\n\n\n
- MariaDB ;<\/li>\n\n\n\n
- Grafana.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n14.3 API pour WordPress<\/h2>\n\n\n\n
WordPress peut interroger l\u2019API Flask :<\/p>\n\n\n\n
\n- r\u00e9cup\u00e9ration JSON ;<\/li>\n\n\n\n
- supervision ;<\/li>\n\n\n\n
- affichage dynamique.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n15. Commandes utiles et d\u00e9pannage<\/h1>\n\n\n\n15.1 Voir les conteneurs actifs<\/h2>\n\n\n\ndocker ps<\/code><\/pre>\n\n\n\n
\n\n\n\n15.2 Voir tous les conteneurs<\/h2>\n\n\n\ndocker ps -a<\/code><\/pre>\n\n\n\n
\n\n\n\n15.3 Arr\u00eater un conteneur<\/h2>\n\n\n\ndocker stop flask-api<\/code><\/pre>\n\n\n\n
\n\n\n\n15.4 Red\u00e9marrer<\/h2>\n\n\n\ndocker restart flask-api<\/code><\/pre>\n\n\n\n
\n\n\n\n15.5 Supprimer un conteneur<\/h2>\n\n\n\ndocker rm flask-api<\/code><\/pre>\n\n\n\n
\n\n\n\n15.6 Voir les logs<\/h2>\n\n\n\ndocker logs flask-api<\/code><\/pre>\n\n\n\nOptions utiles :<\/p>\n\n\n\n
\n-f<\/code> : suivi temps r\u00e9el<\/li>\n\n\n\n--tail 50<\/code> : affiche les 50 derni\u00e8res lignes<\/li>\n<\/ul>\n\n\n\nExemple :<\/p>\n\n\n\n
docker logs -f --tail 50 flask-api<\/code><\/pre>\n\n\n\n
\n\n\n\n15.7 Acc\u00e9der au shell du conteneur<\/h2>\n\n\n\ndocker exec -it flask-api bash<\/code><\/pre>\n\n\n\nExplications<\/h3>\n\n\n\n\nexec<\/code> lance une commande<\/li>\n\n\n\n-it<\/code> ouvre un terminal interactif<\/li>\n\n\n\n