[MODX/Laravel] DevDocker - удобная разработка под Linux

Всем приветики, в общем ни для кого не секрет что докер — это шикарная магическая штука и где то там его активно используют но не в modx конечно, где код до сих пор пишут в браузере. В общем 4 года я был в поиске оптимального решения как правильно и удобно вести разработку проектов (раньше на MODX, сейчас на фреймворках) и в итоге могу точно заявить, что я нашел идеальное решение! Под катом я расскажу все что я пробовал за 4 года и минусы каждого решения, ну а не терпеливые могут просто посмотреть видео сборки, которая решает их все или перейти сразу к гитхабу:

Видео

GitHub

Проблематика и личный опыт

Храним все на сервере

Есть такая штука в phpStorm как синхронизация локальных файлов с файлами на сервере

File->New project from Existings File

и да, вполне удобная штука если вынести ядро modx локально, выкачивать только asset'ы и cor'ы компонентов, с помощью этого способа я разрабатывал сайты почти 1.5 года и вот какие проблемы меня поджидали

1. Невозможность использовать ресурсы своей машины, хотя их значительно больше чем на сервере, особенно актуально когда нужно единоразово спарсить большой объем данных
2. Медленная работа всего что только можно: сохранение файла = его загрузка на сервер, да, пусть это миллисекунды, но сплюсуйте все эти миллисекунды и получите очень не хилую задержку
3. Зависимость от удаленного сервера: тут все очевидно — нет интернета — работа стоит, проблемы у хостера — работа стоит, закончилось место — работа стоит и еще десятки минусов
4. И самое главное — это генерируемые файлы: да, в modx не много файлов генерируются самим движком, но однако бывает, что это необходимо сделать, например прикрутить элементарный композер и вот тут наша удаленная синхронизация превращается в настоящий ад, пакеты нужно устанавливать и на удаленном сервере отдельно и на локальной машине отдельно, любые генерируемые на сервере файлы нужно выкачивать вручную и т.д. думаю вытекающие проблемы для всех тут очевидны

P.s. но в целом я иногда до сих пор использую этот метод, например когда клиент залетный и нужно поправить что то на пару часиков, поставил скачиваться проект, пока бутерброды делал, все скачалось и не надо в браузере редактировать, можно работать в своем окружении, да и 1.5 года я как то справлялся, в общем не самый плохой метод

Поднимаем свой локальный сервер

Ну тут все просто когда проектов 10 и все сложно когда их 50 или они все разные, берем ручки, запасаемся мануалами, устанавливаем php-fpm, nginx, модули для php, mysql все это дело настраиваем один раз, разворачиваем пару проектов, смотрим какие части динамические из конфигов и что лучше всего разделить на разные includ'ы и все это дело настраиваем второй раз.

За время которое я использовал это решение я пришел вот к такой структуре настройки:

php и php-fpm стартуют от моего юзера чтобы не было проблем с правами, nginx смотрит в папку ~/Work/config где я через обычный редактор прописываю свой конфиг для каждого проекта, а в ~/Work/hosts лежит ссылка на /etc/hosts где я ручками прописываю домены (да, хостс доступен для записи от обычного пользователя) и вот какие проблемы это порадило:

1. Невозможность актализировать hosts, через пару месяцев работы hosts полон десятками не нужных сайтов которых у меня уже давно нет локально, выглядит все это сумбурно и некрасиво
2. Невозможность актуализировать конфиги, папка config разрастается десятками файлов где фиг пойми что из этого нужно, а что нет
3. Для разных проектов нужны разные технологии из за чего домашняя машина обрастает всевозможными редисами, мемкешами, и другими сервисами которые в нужны были для запуска пары залетных проектов
4. Локальный mysql обрастает десятками БД которые уже не нужны, и со временем начинают сыпаться
5. Сложность передачи проекта другому человеку: когда у меня появились ребята которые мне помогали с работой мне было им довольно сложно объяснить как это все настроить у себя, да и не двеопсы они чтобы во всем этом разбираться

Ну и в целом не очень хочется делать из домашней машины полноценный сервер

Привет, Docker

Конечно же это не единственные кейсы которые я пробовал использовать, но это самые долгоиграющие кейсы, я знал о докере и тогда, но для меня это казалось оверкиллом и чем то невероятно сложным, с переходом работы в команду и на laravel мне пришлось его использовать, но как я и предполагал докер не самое удобное решение, нет, оно конечно в разы удобнее чем вышеперечисленные кейсы но он не решал следующие проблемы:

1. nginx конфиги как надо было писать для каждого проекта так и надо, просто теперь они более структурированные
2. В hosts все также надо было добавлять записи
3. Команды довольно длинные и сложные

Но, только у докера я увидел огромную перспективу на автоматизацию, ведь действительно, когда у тебя один проект — один сервер — один набор сервисов автоматизировать можно что угодно, и вот собственно предлагаю свой вариант автоматизации, которым пользуюсь уже не один месяц!

DevDocker

Что он делает? Какие проблемы решает? Ну начнем по порядку, он автоматически добавляет записи в hosts, автоматически разворачивает modx/laravel и базу данных, и для каждого проекта разворачивает свое окружение, вот малый список проблем который он решает:

1. Добавление записей в hosts
2. Автоматическая генерация nginx файлов
3. Одинаковая внутренняя структура файлов, что позволяет не заморачиваться по поводу конфигурирования config.core.php
4. Одинаковые доступы к БД для каждого проекта, что позволяет не искать нужную базу данных и доступы к ней каждый раз
5. Удобный деплой (да, его можно развернуть на сервере одной командой и все будет точно также работать как и у вас на локальной машине, только извне)
6. Упрощение команд через Makefile, все максимально просто и понятно
7. Одну и ту же сборку можно использовать как для старых проектов, так и для новых (просто закидываем старый проект в app и не соглашаемся на развертывание системы при init)
8. Быстрое разворачивание новых проектов

И это наверное лишь малая часть того что становится удобнее, по крайне мере я нашел в этом настоящий кайф, советую просто попробовать, docker упрощает работу, а DevDocker позволяет вам абсолютно не задумываться