Comment utiliser Docker pour développer en local sans que ça casse tout ?

Ça fait un mois que j'essaie d'intégrer Docker dans mon workflow mais à chaque fois que je lance les conteneurs j'obtiens des erreurs de permissions ou de ports déjà utilisés. Je bosse sur Windows avec WSL2 et j'ai un projet Node avec PostgreSQL. Y a une façon de faire sans que ce soit aussi compliqué ?

5 réponses

★ Meilleure réponse

Les permissions ne sont pas autant la galère qu'elles le semblent au début. La plupart des gens ici sont focalisés sur les ports et c'est normal, mais ce que personne ne mentionne c'est qu'avec WSL2 tu dois donner les permissions à l'utilisateur Docker sans mettre du `sudo` partout. Tu lances `sudo usermod -aG docker $USER` une seule fois, tu fermes et tu rouvres le terminal, et voilà - après Docker fonctionne sans que tu doives te battre avec les permissions chaque fois que tu lances un conteneur. Après ça, la configuration avec docker-compose devient beaucoup plus tranquille parce que tu n'es pas en train de gérer des erreurs de permissions qui te mélangent avec celles des ports.

Les erreurs de ports déjà en utilisation sont les plus courantes et embêtantes. D'abord, vérifie ce qui occupe les ports : sous Windows/WSL2, exécute `netstat -ano | findstr :5432` (ou le port que tu utilises) pour voir quel processus l'utilise. Si c'est un conteneur qui traîne, tue-le avec `docker rm -f nom_conteneur`. Le problème de permissions vient généralement du fait que WSL2 essaie de monter des volumes sans les bonnes permissions sous Windows, donc dans ton `docker-compose.yml` spécifie explicitement les ports et n'utilise pas de bind mounts compliqués au départ ; c'est mieux de copier le code dans l'image ou d'utiliser des volumes nommés que Docker gère mieux.

Pour ton setup Node + PostgreSQL, le plus propre c'est un `docker-compose.yml` où tu définis les services sans te compliquer la vie. Mappe des ports différents si quelque chose utilise déjà les standards (ex : `5433:5432` pour Postgres), assure-toi que ton Node peut résoudre le hostname du conteneur de BD (utilise le nom du service dans docker-compose, comme `postgres:5432`), et relance tout proprement : `docker-compose down -v` tue les conteneurs et volumes, puis `docker-compose up`. Attention aux volumes nommés vs bind mounts sous WSL2 ; les bind mounts se comportent parfois bizarrement avec les permissions, donc pour du développement local, considère simplement de ne pas monter le code si tu n'en as pas besoin, ou utilise des volumes nommés que WSL2 gère mieux.

Ce que la plupart des gens ne font pas : vérifie les logs. `docker-compose logs -f` te montre ce qui se passe dedans en temps réel ; là tu vois si l'app se connecte vraiment, si la BD est prête, tout. Et une chose qui économise des heures, surtout sous Windows : parfois WSL2 et Docker ont des conflits bizarres, donc si c'est toujours le chaos, essaie Docker Desktop directement (pas WSL2) ou assure-toi que ta version de WSL2 est à jour. La plupart des gens qui abandonnent Docker sous Windows, c'est parce qu'ils ne mettent pas WSL2 à jour ou qu'ils mélangent les configurations.

Avant de te mettre à tuer des processus, assure-toi que ton `docker-compose.yml` a des noms clairs pour les services et que les ports dans le fichier ne sont pas en dur. Ce qui t'aide vraiment ici, c'est d'utiliser des variables d'environnement : au lieu de mettre `5432:5432` directement, définis un `.env` avec `DB_PORT=5432` et dans le compose tu utilises `${DB_PORT}:5432`. Comme ça quand tu dois changer de port (parce qu'un truc l'occupe déjà) tu ne touches que le fichier de configuration à un endroit, tu n'as pas besoin de fouiller partout dans le code. Aussi, sur WSL2 les conteneurs restent parfois bloqués ; avant de redémarrer tout, essaye `docker system prune -a` pour nettoyer les vieilles affaires qui causent des problèmes.

La façon la plus rapide d'éviter ces galères, c'est d'utiliser des variables d'environnement dans ton `docker-compose.yml` au lieu de hardcoder les ports, comme ça tu peux les changer sans modifier le fichier à chaque fois. De mon côté, j'avais le même problème avec PostgreSQL et Node qui tournaient sur WSL2, et ce qui m'a sauvé, c'est simplement créer un fichier `.env` avec `DB_PORT=5432` et `NODE_PORT=3000`, puis les référencer dans le compose comme `${DB_PORT}:5432` - si le port est occupé, je change une seule ligne dans le `.env` et voilà, sans que tout s'écroule. Je te recommande aussi d'ajouter `restart: unless-stopped` dans tes services pour qu'ils se redémarrent automatiquement si quelque chose échoue, et pour les permissions sur WSL2, exécute Docker directement depuis WSL plutôt que depuis PowerShell, parce que comme ça tu évites les problèmes bizarres de permissions entre Windows et Linux. Une dernière chose : si tu continues à avoir des soucis avec des conteneurs qui ne veulent pas mourir, `docker-compose down -v` te nettoie absolument tout en incluant les volumes, comme ça tu recommences de zéro sans fantômes.

Ce n'est pas que Docker soit compliqué, c'est que WSL2 sur Windows a ses propres pièges et personne ne les mentionne. Ce qui va t'épargner des heures, c'est simplement arrêter de penser aux ports et aux permissions comme à des problèmes séparés : la plupart des galères viennent du fait que les conteneurs ne peuvent pas communiquer entre eux parce que tu utilises localhost au lieu du nom du service dans le réseau Docker.

Dans ton `docker-compose.yml`, dans la chaîne de connexion de Node à PostgreSQL ne mets pas `localhost:5432`, utilise directement `postgres:5432` (ou le nom que tu donnes au service). Et dans `.env` ou les variables du conteneur, configure la connexion comme ça. Ça résout 80% des problèmes de permissions que tu vois : ce n'est pas que tu n'as pas accès, c'est que tu pointes mal. Si tu veux quand même exposer les ports, exporte-les dans `ports: ["7654:5432"]` mais à l'intérieur du conteneur utilise toujours le nom du service, pas le port du host.

Votre réponse

Se connecterpour répondre.