После долгих изысканий о том, как лучше организовать инкрементальную сборку проекта в условиях локальной разработки для проекта с Docker-ом, я выбрал такое концептуальное решение:
Наличие Docker-а никак не должно влиять на работу инструментов для сборки проекта (gulp, webpack и т. д.), в частности навязывать новую файловую структуру проекта.
Я думаю, ввиду мнения специалиста @GrayHoax, такая концепция имеет право на существование:
Приложение, завёрнутое в докер ничем не отличается от приложения, выложенного на обычную виртуалку (за исключением способа развертывания).
Проект
В проекте имеется несколько зависимостей (допустим dependency_a
и dependency_b
), доступ которым осуществляется с помощью инструмента Lerna. Для тех, кто с ним не знаком, скажу что судя по всему этот инструмент использует обычные npm-сысылки, а сам лишь только автоматизирует процесс их добавления.
Как бы Вы не критиковали структуру моего проекта за её непохожесть на обычный src/dest-шаблон, без Docker-а сборка проекта работает и собранное full-stack приложение помещается в папку 02-DevelopmentBuild
(для режима локальной разработки).
Теперь нужно поместить этот проект в Docker-контейнер без прямого копирования, причем пути Docker должен правильно понять ссылки dependency_a
и dependency_b
.
Теперь, со следующим docker-compose.yaml
:
version: "3"
services:
logic:
image: node:12.4
command: npm run 'SPA incremental building' && npm run 'Run server'
volumes:
- .:/Application
working_dir: /Application
Кстати, именно этот способ обеспечения доступа к локальным файлом мне порекомендовали в ответе на вопрос Как правильно объявлять Volum-ы в длинном синтаксисе Docker-а?. Увы, этот способ не учитывает npm-ссылки, потому возникает ошибка:
Error: Cannot find module '/packages/dependency_a/bin/dependency_a'.
Директория packages
находится на уровень выше проекта, но возможно это для Lerna это не столько директория, сколько алиас.
На всякий случай покажу, как это выглядит в косоли:
Другими словами, Docker не видит npm-ссылку, актуальную для файловой системы локального компьютера.
Концепция решения
С точки зрения NPM и Lerna у меня всё сделано правильно ввиду того, что без Docker-а сборка проекта работает. Но это "правильно" для Docker-контейнера неактуально.
Docker не должен навязывать условий, соблюдение которых поломает обычную сборку проекта без Docker-а (это что будет если каждый инструмент, будь то Docker, Gulp или Webpack начнут навязывать свои структуры проекта и так далее).
Таким образом, Docker должен предоставлять функционал (API), который позволит объяснить только ему, где же надо искать
dependency_a
и другие.
Попытки решения без понимания
Ввиду того, что я задаю этот вопрос, я не знаю, как надо делать правильно, потому я эксперимента ради попробовал такое решение:
version: "3"
services:
logic:
image: node:12.4
command: npm run 'SPA incremental building' && npm run 'Run server'
volumes:
- .:/Application
- ../../packages/dependency_a:/Application/node_modules/dependency_a
- ../../packages/dependency_b:/Application/node_modules/dependency_a
working_dir: /Application
# ports:
# - "3000:3000"
Естественно, оно нерабочее. Вдобавок к этому, я не совсем понял, что сделал. Наконец, я и сам чувствую, что создание пересекающихся bind-ов (или создание одного поверх другого) - это что-то не то.
Сообщение об ошибке то же, что и раньше.
Анализ статьи о подобной проблеме
Подобная ситуация рассматривается в статье Developing a new Node module in a Docker container without using NPM link. Вот какое решение она предлагает:
RUN mkdir -p /usr/src/node_modules
ENV PATH /usr/src/node_modules/.bin:$PATH
docker-compose.yaml
:
volumes:
- .:/usr/src/app
- ../redux-beacon-slack:/usr/src/node_modules/redux-beacon-slack
Оно мне не подходит в первую очередь потому, что у меня образ другой, не операционной системы, а node:12.4
.
Недопустимые решения
Использовать только опубликованные npm библиотеки
Удобно организованная среда разработки является базовым требованием современной IT-индустрии. Применительно к npm
это значит:
- Не должно быть никаких лишних релизов
npm
-библиотек ("чтобы просто посмотреть отладочную информацию"). - Если мы внесли какое-либо изменение в локально разрабатываемую npm-зависимость, то мы должны в реальном времени получать обратную связь от этого. Например, добавили
console.log()
в зависимость - тут же видим вывод в консоль при запуске основного приложения.
Изменение структуры проекта
ИМХО хороший инструмент должен адаптироваться под структуру уже существующих проектов, а не навязывать свою собственную.
Насчет Dockerfile
Как видите, его в проекте нет. Увидев пример без Docker файла, я решил убрать Dockerfile и добавить его снова только если на то будет рациональная причина.
Часто задаваемый вопрос: зачем мне Docker?
Нужен он мне собственно затем, зачем его и разрабатывали:
- Не зависеть от версии локально установленного NodeJS.
- Избежать полностью ручной установки NodeJS и других инструментов (например, баз данных) при деплое на продакшен.
В данном приложении заменить локальный Node.JS на Docker-образ - это лишь первый шаг, далее я буду добавлять образ с базой данных.
О копировании файлов
На англоязычном StackOverflow первый конкурс на английскую версию этого вопроса закончился без ответа. В комментариях люди что-то постоянно говорили про копирование файлов.
Этот момент я прояснил в вопросах Есть ли в Docker-e концепция доступа к локальным файлам без их прямого копирования? b Как правильно объявлять Volum-ы в длинном синтаксисе Docker-а? и вот какой вердикт: в режиме локальной разработки ничего копировать не надо, потому что такой принцип нарушит инкрементальную сборку, то есть автоматическую пересборку проекта в реальном времени при внесении изменений в исходный код и автоматическую перезагрузку страницы браузера при обновлении сборки. Вместо этого, нужно обеспечить доступ к проекту из Docker-контейнера (это уже достигнуто обычным bind-ом) и теперь объяснить ему, как интерпретировать неактуальные для него npm-сыылки.
это что будет если каждый инструмент...
Но Вы же уже завязались на условия, навязанные Lerna)docker-compose up ...
? Тогда добавьте в файл монтирования абсолютных путей - замените../..
на абсолютный путь начиная с/
. Тут сложность для новичков в том, что docker-compose и docker - разные вещи, в чем то совпадают, и это вносит путаницу. Вdocker-compose.yml
можно указывать относит. и абсол. ссылки.sudo mount --bind my_module node_modules/my_module
. Отмонтироватьsudo umount node_modules/my_module/
. Прочитать об этом можно вman mount
секцияThe bind mounts