Dev Stack

Environnement de développement local partagé entre tous les projets.

Prérequis

• Docker Engine : Debian / macOS / Windows

Installation

# Créer le réseau partagé
docker network create traefik

# Générer le certificat local autosigné via Docker
make cert

# Lancer la stack
docker compose up -d

SSL local

Le stack expose Traefik en HTTPS avec un certificat autosigné wildcard *.localhost.

Pour régénérer le certificat local à tout moment:

make cert

Services

Service	URL	Rôle
Traefik	https://traefik.localhost	Reverse proxy
Portainer	https://portainer.localhost	GUI Docker
MailHog	https://mail.localhost	Catch-all emails

MailHog - Config SMTP pour vos projets

Paramètre	Valeur
Host	mailhog
Port	1025
Username	(vide)
Password	(vide)
Encryption	aucune

⚠️ Le projet doit être connecté au réseau traefik

# dans le docker-compose.yml du projet
networks:
  traefik:
    external: true

🔌 Connecter un projet

services:
  app:
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.monprojet.rule=Host(`monprojet.localhost`)"
    networks:
      - traefik

networks:
  traefik:
    external: true

Windows - Configuration DNS

Les sous-domaines .localhost ne sont pas résolus automatiquement sur Windows.

Ouvrir en administrateur :

C:\Windows\System32\drivers\etc\hosts

Ajouter :

127.0.0.1   traefik.localhost
127.0.0.1   portainer.localhost
127.0.0.1   mail.localhost

Chaque nouveau projet nécessite une nouvelle entrée.

Sur Linux et macOS, rien à faire, ça marche tout seul. ✅

Commandes utiles

# Générer/rafraîchir le certificat local
make cert

# Démarrer
docker compose up -d

# Démarrer avec VS Code (si pas d'IDE)
docker compose --profile ide up -d

# Arrêter
docker compose down

# Arrêter (avec le profil ide)
docker compose --profile ide down

# Voir les logs
docker compose logs -f

# Logs d'un service
docker compose logs -f traefik

# Redémarrer un service
docker compose restart traefik

Contributeurs

• Frize