¿Cómo usar Docker para desarrollar localmente sin que se rompa todo?

MO Monica Torres MX 📗 Estudiante 👁 84 ⚑ Denunciar Programación

Llevo un mes intentando meter Docker en mi flujo de trabajo pero cada vez que levanto los contenedores me tira errores de permisos o puertos que ya están en uso. Trabajo en Windows con WSL2 y tengo un proyecto Node con PostgreSQL. ¿Hay alguna forma de hacer esto sin que sea tan complicado?

5 respuestas

★ Mejor respuesta

Sinceramente los permisos no son tanto el quilombo como se ve al principio, la mayoría de gente acá está enfocada en los puertos y está bien, pero lo que nadie menciona es que en WSL2 tenés que darle permisos al usuario de Docker sin meter `sudo` en todo. Corrés `sudo usermod -aG docker $USER` una sola vez, cierras y reabrís la terminal, y listo - después Docker funciona sin que tengas que estar peleando con permisos cada vez que levantás un contenedor. Después de eso, la configuración con docker-compose se vuelve mucho más tranquila porque no estás lidiando con errores de permisos que te confunden con los de puertos.

Sergio MX 🛠️ Especialista 💬 70 respuestas ⚑

Los errores de puertos que ya están en uso son lo más común y molesto. Primero revisa qué está ocupando los puertos: en Windows/WSL2 ejecuta `netstat -ano | findstr :5432` (o el puerto que uses) para ver qué proceso lo tiene. Si es otro contenedor que quedó colgado, mata el contenedor con `docker rm -f nombre_contenedor`. El tema de permisos generalmente viene de que WSL2 intenta montar volúmenes sin los permisos correctos en Windows, así que en tu `docker-compose.yml` especifica explícitamente los puertos y no uses bind mounts complicados al principio; mejor copia el código en la imagen o usa volúmenes nombrados que Docker maneja mejor.

Para tu setup de Node + PostgreSQL, lo más limpio es un `docker-compose.yml` donde definas los servicios sin enredarte mucho. Mapea puertos diferentes si algo ya está usando los estándar (ej: `5433:5432` para Postgres), asegúrate de que tu Node pueda resolver el hostname del contenedor de BD (usa el nombre del servicio en docker-compose, como `postgres:5432`), y reinicia todo limpio: `docker-compose down -v` mata los contenedores y volúmenes, luego `docker-compose up`. Ojo con los volúmenes nombrados vs bind mounts en WSL2; los bind mounts a veces se comportan raro con permisos, así que para desarrollo local considera simplemente no montar el código si no lo necesitas, o usa volúmenes nombrados que WSL2 maneja mejor.

La parte que la mayoría no hace: checkea los logs. `docker-compose logs -f` te muestra qué pasa adentro en tiempo real; ahí ves si la aplicación realmente se conecta, si la BD está lista, todo. Y una cosa que ahorra muchas horas, especialmente en Windows: a veces WSL2 y Docker tienen conflictos raros, así que si sigue siendo un caos, prueba con Docker Desktop directamente (no WSL2) o asegúrate de que tu versión de WSL2 esté actualizada. La mayoría de gente que abandona Docker en Windows es porque no actualiza WSL2 o mezcla configuraciones.

SO sol1984 MX 🛠️ Especialista 💬 80 respuestas ⚑

Antes de ponerte a matar procesos, asegúrate de que tu `docker-compose.yml` tiene nombres claros para los servicios y que los puertos en el archivo no están hardcodeados. Lo que te salva acá es usar variables de entorno: en lugar de poner `5432:5432` directo, define un `.env` con `DB_PORT=5432` y en el compose usas `${DB_PORT}:5432`. Así cuando necesites cambiar de puerto (porque algo ya lo ocupa) solo tocas el archivo de configuración en un lugar, no andes buscando en el código. También, en WSL2 a veces los contenedores se quedan colgados; antes de reiniciar todo, probá `docker system prune -a` para limpiar lo viejo que está causando quilombo.

sofia_sol MX 🛠️ Especialista 💬 81 respuestas ⚑

La forma más rápida de evitar estos quilombos es usar variables de entorno en tu `docker-compose.yml` en lugar de hardcodear los puertos, así puedes cambiarlos sin tocar el archivo cada vez. En mi caso tenía el mismo lío con PostgreSQL y Node corriendo en WSL2, y lo que me salvó fue simplemente crear un archivo `.env` con `DB_PORT=5432` y `NODE_PORT=3000`, después referenciarlos en el compose como `${DB_PORT}:5432` - si el puerto está ocupado cambio una sola línea en el `.env` y listo, sin que reviente todo. También te recomiendo agregar `restart: unless-stopped` en tus servicios para que se reinicien automáticamente si algo falla, y sobre los permisos en WSL2, ejecuta Docker directamente desde WSL en lugar de desde PowerShell, porque así evitas los problemas raros de permisos entre Windows y Linux. Una última cosa: si seguís con rollos de contenedores que no quieren morir, `docker-compose down -v` te limpia absolutamente todo incluyendo volúmenes, así empezás del cero sin fantasmas.

No es que Docker sea complicado, es que WSL2 en Windows tiene sus propias trampas y nadie las menciona. Lo que te va a ahorrar horas es simplemente dejar de pensar en puertos y permisos como problemas separados: la mayoría de los quilombos vienen de que los contenedores no pueden hablar entre sí porque usas localhost en lugar del nombre del servicio dentro de la red de Docker.

En tu `docker-compose.yml`, en la cadena de conexión de Node a PostgreSQL no pongas `localhost:5432`, usa directamente `postgres:5432` (o el nombre que le des al servicio). Y en `.env` o variables del contenedor, configura la conexión así. Eso resuelve el 80% de los dramas de permisos que ves: no es que no tengas acceso, es que estás apuntando mal. Si aún así querés mover los puertos, exportalos en `ports: ["7654:5432"]` pero dentro del contenedor siempre usa el nombre del servicio, no el puerto del host.

Tu respuesta

Iniciar sesiónpara responder.