Utiliser Docker Compose : installer Docker, rédiger le compose, up/down, logs, premier stack Web+BD
Installer Compose et piloter un stack Web+Postgres avec up, down et logs.
Faire tourner Web et PostgreSQL en local sans guerre de versions sur l’hôte. Docker Compose décrit l’app multi-conteneurs dans docker-compose.yml et la pilote en une commande.
Pour Docker Compose installer docker-compose.yml up down logs web base de données : installer Docker+Compose, rédiger le compose, up/down, logs, valider Web+DB. Selon docs.docker.com.
Pour qui Compose
Full-stack / backend
API+BD en local comme l’équipe ; moins de dérive d’environnement.
Ingénieurs curieux ops
Pratiquer up/down/logs/ps avant Kubernetes.
Formateurs
nginx+Postgres en un compose ; down -v pour réinitialiser.
Installer Docker et le plugin Compose
- 1
macOS / Windows: Docker Desktop
Download from
https://docs.docker.com/desktop/(Docker Hub download links redirect there). Install, start Docker Desktop, wait until the engine reports running. Compose V2 ships asdocker compose. - 2
Linux: Docker Engine + compose plugin
Follow
https://docs.docker.com/engine/install/for your distro, then install the Compose plugin perhttps://docs.docker.com/compose/install/linux/(package name oftendocker-compose-plugin). - 3
Verify CLI
Run
docker --versionanddocker compose version. If only hyphenateddocker-composeexists, prefer upgrading to the plugin; legacy binary behavior differs slightly. - 4
Permissions (Linux)
Without sudo, add your user to the
dockergroup per official post-install steps, then log out/in. Do not chmod/var/run/docker.sockto world-writable.
Premier docker-compose.yml (Web + PostgreSQL)
Create a project folder with docker-compose.yml (filename also accepted: compose.yaml). Example: nginx on port 8080 and PostgreSQL 16 with a named volume:
services:
web:
image: nginx:alpine
ports:
- "8080:80"
volumes:
- ./html:/usr/share/nginx/html:ro
depends_on:
- db
db:
image: postgres:16-alpine
environment:
POSTGRES_USER: app
POSTGRES_PASSWORD: devpass
POSTGRES_DB: appdb
volumes:
- db_data:/var/lib/postgresql/data
volumes:
db_data:Put a simple html/index.html on the host. Never commit real passwords; use .env for local secrets and add .env to .gitignore (see Docker docs on env files).
Démarrer, arrêter, logs
| Command | Action | When |
|---|---|---|
docker compose up -d | Start detached | First bring-up |
docker compose ps | Status / ports | Confirm mapping |
docker compose logs -f web | Follow logs | Debug startup |
docker compose stop | Stop containers | Pause without removing |
docker compose down | Remove containers/network | Clean shutdown |
docker compose pull | Refresh images | Before upgrades |
Vérifier le stack Web + base
- 1
HTTP
Open
http://localhost:8080— nginx should serve yourindex.html. - 2
Database
docker compose exec db psql -U app -d appdb -c '\dt'checks Postgres inside the container. - 3
Rebuild after edits
If you add a
build:section later, usedocker compose up -d --build.
Compose orchestrates containers on one Docker host; it is not a cloud substitute. Backups, TLS, and scaling live in platform-specific docs.
Stack local OK : tableau blanc ou voix via accueil wbroom — créer et rejoindre une salle.
Questions utiles
Compose V2 vs docker-compose ?
Les installs récentes utilisent docker compose (V2). Vérifiez avec docker compose version.
down efface les données ?
Les volumes nommés survivent à un down normal ; down -v pour réinitialiser en dev.
Port déjà pris ?
Changez le port hôte dans ports ou inspectez avec lsof.
Prêt pour la prod ?
Guide local : mots de passe par défaut, pas de TLS. En prod : secrets, healthchecks, sauvegardes, tags d’images figés.