Adminsys Dev

Déployer une application web avec Docker simplement : le guide

Docker n'est pas compliqué : ce qui l'est, c'est de déployer sans comprendre. Retour d'expérience sur la conteneurisation d'un site web, docker-compose pour débutants et les pièges qui coûtent des nuits blanches.

Déployer une application web avec Docker simplement : le guide

La première fois que j'ai voulu déployer une application web avec Docker, j'ai passé une nuit blanche. Pas parce que c'était difficile. Parce que j'avais copié un docker-compose.yml trouvé sur un blog, sans comprendre une seule ligne, et que le conteneur redémarrait en boucle. À 3 h du matin, j'ai fini par lire les logs. Le problème tenait en huit caractères : un chemin de volume mal écrit.

Depuis, j'ai déployé une bonne trentaine de projets en conteneurs, du petit site vitrine PHP jusqu'à des applications Node avec base de données. Et j'ai une conviction que je défendrai bec et ongles : Docker n'est pas compliqué. Ce qui est compliqué, c'est de croire qu'on peut déployer sans comprendre ce qu'on fait. Cet article part de là. On va voir comment conteneuriser un site web proprement, comment utiliser docker-compose pour débutant sans se noyer, et surtout comment éviter les pièges qui m'ont coûté des heures.

Points clés à retenir

  • Un Dockerfile décrit comment construire une image ; un docker-compose.yml décrit comment lancer plusieurs conteneurs ensemble.
  • Pour héberger une application en ligne, il faut penser volumes persistants, variables d'environnement et reverse proxy — pas juste « ça tourne sur ma machine ».
  • Une image Docker Nginx PHP bien configurée pèse souvent moins de 100 Mo si on part d'une base alpine.
  • Le piège numéro un n'est pas technique : c'est de déployer sans avoir testé la persistance des données.
  • Un guide déploiement conteneur sérieux commence toujours par la question : « que se passe-t-il si le conteneur redémarre ? »

Pourquoi Docker change vraiment la donne quand on déploie

Le problème que Docker résout, on le connaît tous : « ça marche sur ma machine ». Un serveur qui a PHP 8.1, l'autre PHP 8.3, une librairie système qui a bougé entre-temps, et hop, plus rien ne démarre. J'ai vécu exactement ce scénario chez un client dont l'application tournait depuis deux ans sur un serveur bricolé à la main — l'histoire complète est racontée dans déployer sans galérer, et elle vaut le détour.

Image et conteneur : la distinction qu'il faut vraiment intégrer

Une image, c'est un modèle figé. Un conteneur, c'est une instance qui tourne à partir de ce modèle. Vous pouvez lancer dix conteneurs à partir d'une même image, comme vous ouvrez dix onglets à partir du même site.

Cette distinction paraît anodine. Elle ne l'est pas. Quand j'ai compris qu'une image est immuable et que tout ce qui change au runtime doit passer par des volumes ou des variables d'environnement, j'ai arrêté de perdre des données à chaque redéploiement. Avant, je modifiais des fichiers directement dans le conteneur. Grave erreur. Au redémarrage suivant, tout avait disparu.

Pourquoi c'est encore plus vrai en 2026

Les serveurs mutualisés classiques sont de moins en moins adaptés aux applications modernes (Node, Python, Go…). Les hébergeurs sérieux proposent presque tous une option « déploiement par conteneur ». Et côté CI/CD, la quasi-totalité des pipelines s'appuient sur des images Docker. Bref : apprendre à conteneuriser une application, ce n'est plus un bonus, c'est la base.

Point clé : Docker ne rend pas le déploiement magique. Il le rend reproductible. Nuance importante.

Votre premier conteneur, pas à pas (sans copier-coller aveugle)

Prenons un cas concret : une petite application PHP qui sert des pages statiques et quelques scripts. Rien de fou. Mais c'est exactement le genre de projet où Docker brille.

Votre premier conteneur, pas à pas (sans copier-coller aveugle)

Écrire un Dockerfile qui tient debout

Un Dockerfile, c'est une recette. Chaque ligne est une instruction. Voici la version minimale que j'utilise encore aujourd'hui pour une image Docker Nginx PHP :

FROM php:8.3-fpm-alpine

WORKDIR /var/www/html

COPY . .

RUN chown -R www-data:www-data /var/www/html

EXPOSE 9000

Rien de compliqué. Trois choses à retenir :

  • Partir d'une base alpine réduit le poids de l'image de 60 à 80 % par rapport à une base Debian classique.
  • Chown systématique vers www-data. Sans ça, Nginx renvoie des 403 incompréhensibles.
  • Ne pas copier les fichiers inutiles (node_modules, .git, .env local). Un fichier .dockerignore fait gagner des minutes à chaque build.

Sur mon dernier projet, ce simple ajustement a fait passer le build de 47 secondes à 12 secondes. Multiplié par vingt builds par jour, ça compte.

Lancer et tester le conteneur

Une fois le Dockerfile écrit, on construit l'image :

docker build -t mon-app-php .

Puis on la lance :

docker run -p 8080:80 mon-app-php

Si vous voyez votre application sur http://localhost:8080, vous avez déjà fait 70 % du travail. Le reste, c'est de la configuration.

Et là, franchement, je vais être direct : ne sautez pas cette étape. J'ai trop souvent vu des gens passer directement au déploiement en production sans tester en local. Résultat : des heures perdues à débugger sur un serveur distant, à 200 km de son canapé.

Docker Compose : quand un seul conteneur ne suffit plus

Une application réelle, ce n'est presque jamais un seul conteneur. Il y a le serveur web, la base de données, parfois un cache Redis, un worker pour les tâches en arrière-plan. C'est là que docker-compose pour débutant devient votre meilleur ami.

Docker Compose : quand un seul conteneur ne suffit plus

Un docker-compose.yml lisible

Voici un exemple que j'ai utilisé récemment pour une application PHP + MySQL + Nginx :

services:
  app:
    build: .
    volumes:
      - ./src:/var/www/html
    environment:
      DB_HOST: db
      DB_NAME: monapp
    depends_on:
      - db

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - app

  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: monapp
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

Trois services, un seul fichier, une commande pour tout lancer :

docker compose up -d

Le -d signifie « détaché » : les conteneurs tournent en arrière-plan. Sans lui, votre terminal reste bloqué, ce qui surprend la première fois.

Le piège des volumes que j'ai mis six mois à comprendre

La ligne db_data:/var/lib/mysql est probablement la plus importante du fichier. Sans elle, votre base de données disparaît à chaque docker compose down. Oui, disparaît. Tout. Tables, données, utilisateurs.

Je l'ai appris à mes dépens sur un projet en préproduction. Trois jours de données importées, perdues en une commande. Depuis, je vérifie systématiquement la présence d'un volume nommé avant tout déploiement. C'est devenu un réflexe.

Point clé : un docker-compose.yml sans volumes persistants est une bombe à retardement.

Mettre l'application en ligne pour de vrai : les trois erreurs que j'ai faites

Sur votre machine, tout marche. Sur le serveur, rien ne va. Classique. Voici ce que j'ai appris — souvent à la dure.

Mettre l'application en ligne pour de vrai : les trois erreurs que j'ai faites

Erreur n°1 : oublier le reverse proxy

En local, vous exposez le port 80 directement. En production, vous avez probablement d'autres services sur la même machine (un site vitrine, une API, un panneau d'admin). Sans reverse proxy, c'est le conflit de ports garanti.

La solution : Traefik ou Nginx en frontal qui route le trafic selon le nom de domaine. Traefik est plus simple à configurer avec Docker car il lit directement les labels des conteneurs. Nginx est plus classique, mieux documenté, et souvent plus rapide à débugger quand on connaît.

Mon choix personnel : Traefik pour les projets à plusieurs services, Nginx pour les déploiements simples. Question de goût.

Erreur n°2 : balancer les secrets en clair

Un mot de passe MySQL dans un docker-compose.yml versionné sur Git, c'est la faute la plus fréquente. J'en ai vu un chez un client, en clair, dans un dépôt public. Le serveur avait été scanné en moins de 48 heures.

La bonne approche : un fichier .env non versionné, chargé automatiquement par Docker Compose. Et en production, des secrets gérés par l'hébergeur ou par Docker Swarm. Point.

Erreur n°3 : négliger le HTTPS

Un certificat Let's Encrypt, c'est gratuit et automatisable. Traefik le fait tout seul. Nginx demande un peu plus de configuration mais rien d'insurmontable. Ne pas le faire en 2026, c'est se tirer une balle dans le pied côté SEO et côté confiance utilisateur. Si vous voulez creuser la partie hébergement, l'article sur choisir un hébergeur performant complète bien le sujet.

Comparatif : les options pour héberger une application en ligne

Option Complexité Coût mensuel typique Idéal pour
VPS + Docker Compose Moyenne 5 à 20 € Projets maîtrisés, budget serré
Plateforme managée (type PaaS) Faible 15 à 80 € Équipes sans DevOps dédié
Kubernetes managé Élevée 50 € et + Applications à forte charge
Serveur mutualisé classique Faible 3 à 10 € Sites vitrines sans besoin Docker

Pour un développeur seul ou une petite équipe, le VPS avec Docker Compose reste, à mon avis, le meilleur rapport contrôle/prix. Je campe sur cette position.

Les optimisations qui font la différence (et celles qui ne servent à rien)

Une fois que ça tourne, on veut que ça tourne mieux. Mais tout n'a pas le même impact.

Ce qui marche vraiment

  • Multi-stage builds pour séparer la compilation de l'exécution. Sur une image Node, on passe souvent de 800 Mo à 150 Mo.
  • Cache des couches Docker en ordonnant les instructions : COPY du package.json avant COPY du reste, pour ne pas reconstruire à chaque changement de code.
  • Healthchecks dans le docker-compose.yml. Ça évite que Nginx démarre avant que PHP soit prêt — un grand classique des 502 au démarrage.
  • Logs centralisés avec rotation. Sinon, votre disque se remplit en trois semaines.

Ce qui ne sert à rien (ou presque)

Passer à Kubernetes pour une application qui reçoit 200 visites par jour. Non. J'ai vu une startup de quatre personnes y consacrer deux mois. Résultat : une facture cloud multipliée par cinq et une équipe épuisée. Docker Compose faisait parfaitement le job.

Autre classique : compresser les images à outrance avec des outils exotiques. Un alpine bien configuré suffit dans 90 % des cas. Le gain marginal ne justifie pas la complexité ajoutée.

Point clé : optimisez ce qui est mesurable. Le reste, c'est de la décoration.

Et si vous voulez sécuriser correctement votre déploiement, un audit sécurité régulier reste la meilleure habitude à prendre.

Ce qu'il faut retenir avant de lancer votre premier déploiement

Docker ne rend pas le déploiement simple par magie. Il le rend prévisible. Et c'est exactement ce dont on a besoin quand on met une application entre les mains d'utilisateurs réels.

Si je devais résumer mon approche en trois principes : comprendre chaque ligne de son Dockerfile, tester en local avant de pousser en production, et vérifier la persistance des données avant tout docker compose down. Le reste, c'est de la pratique.

Concrètement, voici votre prochaine action : ouvrez un projet que vous avez déjà déployé à la main, écrivez un Dockerfile minimal, lancez-le en local. Rien d'autre. Prenez une heure. Vous verrez, la deuxième fois, tout s'enchaîne naturellement. C'est comme le vélo : la première chute fait mal, mais on ne l'oublie jamais.

Questions fréquentes

Docker est-il vraiment nécessaire pour un petit site vitrine ?

Honnêtement, non. Pour un site WordPress avec 500 visites par mois, un hébergement mutualisé classique fera parfaitement l'affaire. Docker devient pertinent dès qu'il y a plusieurs services, une application custom, ou un besoin de reproductibilité entre environnements. Le seuil, dans mon expérience, se situe autour de deux ou trois composants à orchestrer.

Quelle différence entre docker-compose et Docker Swarm ?

Docker Compose orchestre des conteneurs sur une seule machine. Docker Swarm (ou Kubernetes) orchestre sur plusieurs serveurs, avec répartition de charge et tolérance aux pannes. Pour 95 % des projets que je croise, Compose suffit largement. Swarm ne se justifie que si vous avez plusieurs serveurs et un besoin réel de haute disponibilité.

Comment mettre à jour mon application sans perdre les données ?

Trois étapes : vérifier que les volumes sont bien déclarés dans le docker-compose.yml, faire un docker compose pull ou build pour récupérer la nouvelle image, puis docker compose up -d pour redémarrer. Les volumes nommés survivent au redémarrage, contrairement aux bind mounts mal configurés. Testez toujours sur un environnement de préproduction avant.

Faut-il un serveur dédié pour héberger une application en ligne avec Docker ?

Pas nécessairement. Un VPS à 5 € par mois suffit pour une petite application. Ce qui compte, c'est la RAM (2 Go minimum pour faire tourner plusieurs conteneurs confortablement) et le disque (SSD, 20 Go minimum). Le serveur dédié ne devient utile qu'à partir d'une charge significative, souvent plusieurs milliers de visites quotidiennes.

Comment déboguer un conteneur qui refuse de démarrer ?

La commande qui m'a sauvé le plus de nuits : docker logs nom-du-conteneur. Elle affiche la sortie du conteneur, y compris les erreurs au démarrage. Si le conteneur s'arrête trop vite pour laisser le temps de lire, utilisez docker run -it image sh pour entrer dedans manuellement et reproduire le problème. Neuf fois sur dix, le message d'erreur est explicite — il faut juste le lire.

Marion Rossignol

Marion Rossignol

Marion Rossignol est une développeuse et architecte reconnue pour son expertise en JavaScript moderne, en architecture web et en pratiques DevOps et CI/CD. Elle accompagne des équipes techniques dans la conception de solutions robustes et évolutives, en mettant l'accent sur l'automatisation et la qualité logicielle. Passionnée par la transmission, elle partage régulièrement ses connaissances à travers des articles et des conférences.

Voir tous les articles →

Articles similaires