MODX + Docker

Всем привет!

Увидел тут в комментариях к одной заметке вопрос про MODX в Docker. Так уж совпало, что я как раз недавно освоил работу с Docker для своих проектов на Vesp, и Pixmill попросили меня сделать что-то такое же и для MODX.



Вызов был принят — и вот результат github.com/bezumkin/modx-docker, можете использовать. Ниже будут пояснения.

Директории

assets — здесь находятся исходники фронтенда, которые собираются через Webpack и кладутся внутрь modx/assets/app.
docker — здесь все настройки, скрипты, логи и БД проекта.
modx — ну а здесь сам MODX, который монтируется внутрь контейнера с PHP.
dist — директория появится при сборке проекта для выгрузки на хостинг.

Установка

Я проверял работу только на MacOS, поэтому все инструкции для него.

Если у вас еще нет докера, то надо установить через Homebrew:

brew install docker --cask

Скачиваем исходники проекта в директорию NewProject:

git clone https://github.com/bezumkin/modx-docker.git ./NewProject

Переходим в рабочую директорию и готовим настройки

cd ./NewProject/docker
cp .env.dist .env

В настройках можно переименовать COMPOSE_PROJECT_NAME, чтобы указать уникальное имя проекта внутри Docker. По умолчанию там modx.

Всё готово, можно запускать контйнеры:

./start.sh

По умолчанию проект запускается в фоновом режиме, но вы можете отслеживать его работу в интерфейсе Docker Desktop. Для остановки нужно выполнить ./stop.sh

Установка MODX

Я приготовил несколько полезных скриптов для автоматизации работы с проектом.

Устанавливаем MODX:

./modx-install.sh

Там всё автоматизированно, никаких вопросов задавать не будут, на предупреждение в консоли не обращайте внимание.

После установки вы получите уже полностью рабочий сайт, доступный по адресу 127.0.0.1:8080. На фронтенде откроется демо-страничка Bootstrap 5. Из дополнений будут установлены только Ace и pdoTools.

Для входа в админку (http://127.0.0.1:8080/manager/) используйте логин admin и пароль adminadmin.

Логика работы

Исходники вашего фронтенда находятся в assets, там всё настроено для работы с Bootstrap 5 через Webpack 5. Все настройки вы можете поменять.

Вместе со скриптами и стилями собирается и manifest.json, который будет прочитан встроенным плагином Assets, чтобы подключить собранные файлы.

Когда контейнеры запущены, node работает в dev режиме с перезагрузкой страницы при изменении исходников.

Кликните, чтобы посмотреть GIFку на 2.2 мб


Для работы с MODX используется всем известный Gitify. С его помощью содержимое системы выгружается в файлы для сохранения в Git.

Заключение

Для получения файлов для выгрузки на хостинг вам нужно выполнить

./modx-build.sh

Этот скрипт

1. Сделает бэкап БД
2. Сохранит элементы и ресурсы в статические файлы
3. Соберёт фронтенд в production режиме (минификация и всё такое)
4. И положит это всё в директорию dist

Дальше вы можете выгрузить содержимое dist на хостинг и развернуть там с помощью Gitify. Наверное, можно даже автоматизировать этот процесс с помощью CI/CD, но я не пробовал, потому что парни из Pixmill разрешают своим клиентам менять всякое в админках сайтов прямо на хостинге. Это ж MODX, тут так принято.

Понятное дело, что вы можете (и должны!) сами настроить себе modx/.gitify под проект, чтобы синхронизировать только нужное. Но это уже сами разбирайтесь, заметка не про работу с Gitify.

Надеюсь всем желающим засунуть MODX в Docker теперь будет немного проще это сделать!

phpmyadmin:
    image: phpmyadmin/phpmyadmin:latest
    environment:
      - VIRTUAL_HOST=phpmyadmin.loc
      - PMA_HOST=mysql
      - PMA_USER=root
      - PMA_PASSWORD=55555555
    networks:
      - frontend
      - backend