Как использовать Docker для локальной разработки без ошибок?

Месяц уже пытаюсь внедрить Docker в свой рабочий процесс, но каждый раз, когда подымаю контейнеры, вылезают ошибки прав доступа или занятые порты. Работаю на Windows с WSL2, проект на Node с PostgreSQL. Есть ли способ сделать это без такой головной боли?

5 ответов

★ Лучший ответ

Честно, права доступа не такая беда, как кажется поначалу, большинство здесь сосредоточено на портах и это нормально, но что никто не упоминает - это то, что в WSL2 нужно дать права пользователю Docker без `sudo` во всём. Запустишь `sudo usermod -aG docker $USER` один раз, закроешь и заново откроешь терминал, и готово - потом Docker работает без того, чтобы ты каждый раз боролся с правами доступа при запуске контейнера. После этого конфигурация с docker-compose становится намного спокойнее, потому что ты не имеешь дело с ошибками прав доступа, которые путают с ошибками портов.

Ошибки с портами, которые уже заняты - это самое частое и раздражающее. Сначала проверь, что занимает порты: на Windows/WSL2 выполни `netstat -ano | findstr :5432` (или тот порт, который используешь) и посмотри, какой процесс его держит. Если это зависший контейнер, убей его командой `docker rm -f имя_контейнера`. Проблемы с правами доступа обычно возникают потому, что WSL2 пытается примонтировать тома без нужных прав на Windows, поэтому в своём `docker-compose.yml` явно указывай порты и не используй сложные bind mounts в начале; лучше скопируй код в образ или используй именованные тома, которыми Docker управляет получше.

Для твоего setup'а Node + PostgreSQL самый чистый вариант - `docker-compose.yml`, где ты определяешь сервисы без лишних заморочек. Проксируй разные порты, если что-то уже занимает стандартные (например, `5433:5432` для Postgres), убедись, что Node может резолвить имя хоста контейнера с БД (используй имя сервиса из docker-compose, типа `postgres:5432`), и перезапусти всё чисто: `docker-compose down -v` убивает контейнеры и тома, потом `docker-compose up`. Смотри на именованные тома vs bind mounts на WSL2; bind mounts иногда ведут себя странно с правами доступа, поэтому для локальной разработки просто не монтируй код, если не нужно, или используй именованные тома, которыми WSL2 управляет лучше.

Что делает большинство - это не смотрят логи. `docker-compose logs -f` показывает, что происходит внутри в реальном времени; там видно, действительно ли приложение подключается, готова ли БД, всё остальное. И одна вещь, которая экономит кучу часов, особенно на Windows: иногда WSL2 и Docker конфликтуют странно, поэтому если это всё ещё хаос, попробуй Docker Desktop напрямую (не WSL2) или убедись, что твоя версия WSL2 обновлена. Большинство людей, которые бросают Docker на Windows - это потому что не обновляют WSL2 или смешивают конфигурации.

Перед тем как начать убивать процессы, убедись, что в твоём `docker-compose.yml` у сервисов есть понятные имена и что порты в файле не захардкодены. Что тебя здесь спасает - использовать переменные окружения: вместо того чтобы писать `5432:5432` прямо в файл, определи `.env` с `DB_PORT=5432` и в compose используй `${DB_PORT}:5432`. Тогда когда нужно поменять порт (потому что что-то его уже заняло), ты правишь конфиг только в одном месте, не ищешь по всему коду. Ещё, в WSL2 иногда контейнеры зависают; перед тем как всё перезагружать, попробуй `docker system prune -a`, чтобы очистить старое дерьмо, которое создаёт проблемы.

Самый быстрый способ избежать этих проблем - использовать переменные окружения в `docker-compose.yml` вместо того, чтобы жёстко вписывать порты, тогда ты можешь их менять без того, чтобы трогать файл каждый раз. У меня была такая же беда с PostgreSQL и Node, работающими на WSL2, и меня спасло просто создание файла `.env` с `DB_PORT=5432` и `NODE_PORT=3000`, потом я их ссылаю в compose как `${DB_PORT}:5432` - если порт занят, меняю одну строку в `.env` и готово, всё работает. Ещё советую добавить `restart: unless-stopped` в свои сервисы, чтобы они автоматически перезагружались, если что-то упадёт, и по поводу прав доступа на WSL2 - запускай Docker прямо из WSL вместо PowerShell, так ты избежишь странных проблем с правами между Windows и Linux. И последнее: если у тебя контейнеры не хотят умирать, `docker-compose down -v` тебе полностью всё почистит, включая волюмы, так что ты начнёшь с нуля без призраков.

Docker не сложный сам по себе, просто WSL2 на Windows имеет свои подводные камни, которые никто не упоминает. То, что тебе сэкономит часы - просто перестать думать о портах и разрешениях как об отдельных проблемах. Большинство проблем возникает потому, что контейнеры не могут общаться друг с другом, потому что ты используешь localhost вместо имени сервиса внутри Docker-сети.

В своём `docker-compose.yml` в строке подключения Node к PostgreSQL не пиши `localhost:5432`, используй напрямую `postgres:5432` (или то имя, которое ты дашь сервису). И в `.env` или переменных контейнера настрой подключение так. Это решит 80% проблем с разрешениями, которые ты видишь: дело не в том, что у тебя нет доступа, а в том, что ты неправильно указываешь адрес. Если тебе всё равно нужно пробросить порты, экспортируй их в `ports: ["7654:5432"]`, но внутри контейнера всегда используй имя сервиса, а не порт хоста.

Ваш ответ

Войдите, чтобы ответить.