Перейти к содержимому
M
Все статьи
Администрирование 9 мин чтения

Git для рабочего Moodle: обновление ядра, плагины и откат без копирования

Как вести рабочий Moodle через git: установка по тегу, хранение плагинов, порядок обновления ядра, таблица команд и откат вместе с базой.

Как вести рабочий Moodle через git: установка по тегу, хранение плагинов, порядок обновления ядра, таблица команд и откат вместе с базой.

Обновление Moodle копированием архива поверх старых файлов держится на удаче: забытый файл, оставшийся от прошлой версии, или перезаписанная правка плагина обнаруживаются уже на рабочем сайте. Git превращает обновление в предсказуемую операцию: видно, что изменилось, можно вернуться к прежней версии кода и точно известно, какая версия стоит. Рассказываю, как я организую рабочую установку, обновляю ядро и плагины и откатываюсь, если что-то пошло не так.

Принцип: код под git, данные отдельно

Рабочий Moodle состоит из трёх частей: код (каталог с исходниками), каталог данных moodledata и база данных. Git управляет только первой. Откат кода без отката базы не работает: Moodle не умеет «понижать» версию базы, и при попытке запустить старый код на обновлённой базе он откажется стартовать. Поэтому у отката всегда два шага: вернуть код и восстановить базу из копии, сделанной перед обновлением. Об этом стоит помнить, когда читаете любую инструкцию про «откат через git».

Первичная установка через git

Код ядра берётся из официального репозитория (github.com/moodle/moodle), ветка соответствует выпуску: например, MOODLE_405_STABLE. Для рабочего сайта удобнее ставить конкретный тег релиза, а не следить за веткой, чтобы обновление было осознанным.

git clone https://github.com/moodle/moodle.git /var/www/moodle
cd /var/www/moodle
git fetch --tags
git checkout v4.5.2   # пример: конкретный релиз
git status

Номер релиза в примере взят для иллюстрации: посмотрите актуальные теги в репозитории и в разделе релизов. Файл config.php в репозиторий не входит — его создаёт установщик, и git его игнорирует.

Как хранить плагины

У сторонних плагинов своё место, и способ хранения решает, насколько удобно обновляться. Варианты:

СпособПлюсыМинусы
Отдельный клон каждого плагина в его папке (local/myplugin)у каждого плагина своя история, легко переключить на нужную ветку или тегпапку плагина нужно добавить в список игнорируемых файлов репозитория ядра (.git/info/exclude)
Подмодули git в репозитории-обёрткеверсия ядра и плагинов закрепляется одним коммитом, окружение воспроизводится на любом серверетребует привычки к подмодулям
Установка из каталога через админкупросто для администраторанет истории, откат только вручную; плагин, поставленный из архива, не отличить от изменённого
Копирование архива вручнуюработает вездеверсия неизвестна, всё держится на памяти

Для проектов, где плагинов много и их дорабатывают, я использую либо клон каждого, либо репозиторий-обёртку с подмодулями. Собственные плагины хранятся в своих репозиториях, поэтому для их передачи на сервер достаточно git pull нужной ветки.

Обновление ядра: порядок действий

  1. Проверить требования. Версия PHP, база данных, расширения и совместимость плагинов (совместимость версий). Прыгать нужно по поддерживаемому пути между версиями: с очень старой версии прямого обновления на новую может не быть, и тогда идут через промежуточный релиз.
  2. Сделать резервные копии. База данных, каталог moodledata, код. Это не формальность — откат без копии невозможен (стратегия резервного копирования).
  3. Включить режим обслуживания.
  4. Получить новый код.
  5. Обновить плагины. Версии под новое ядро.
  6. Запустить обновление базы.
  7. Очистить кэши, выключить режим обслуживания, проверить сайт.
cd /var/www/moodle
php admin/cli/maintenance.php --enable

git fetch --tags
git status                  # убедиться, что нет несохранённых правок
git checkout v4.5.3         # пример: следующий релиз

# при необходимости (в новых ветках) — зависимости:
# composer install --no-dev --classmap-authoritative

php admin/cli/upgrade.php --non-interactive
php admin/cli/purge_caches.php
php admin/cli/maintenance.php --disable

Нужен ли composer install на рабочем сервере, зависит от версии Moodle: смотрите заметки к релизу и раздел установки в документации выбранной ветки. Команды запускайте от имени того же пользователя, под которым работает веб-сервер, иначе файлы кэша окажутся с неверным владельцем.

Таблица команд

ЗадачаКоманда
Посмотреть, какая версия кода стоитgit describe --tags
Увидеть несохранённые правки в ядреgit status, git diff
Получить новые теги и веткиgit fetch --tags
Перейти на релизgit checkout vX.Y.Z
Обновить базу данных после смены кодаphp admin/cli/upgrade.php --non-interactive
Очистить кэшиphp admin/cli/purge_caches.php
Закрыть сайт на время работphp admin/cli/maintenance.php --enable
Открыть сайтphp admin/cli/maintenance.php --disable
Вернуться на прежний релиз кодаgit checkout vпрежний (после восстановления базы)

Откат

Если обновление прошло с ошибкой или сайт после него неработоспособен, откат делается так: включить режим обслуживания (если сайт открывается), вернуть код на прежний тег, восстановить базу данных из копии, сделанной перед обновлением, и очистить кэши. Если пользователи успели работать на новой версии, их данные за этот период в копию не попали — поэтому окно обновления выбирают тихое, вне занятий. Важно, что команда git checkout сама по себе откатывает только файлы; база останется в состоянии новой версии, и Moodle сообщит, что код старше базы.

Что делать с правками в ядре

Если в ядре есть локальные правки, git покажет их в git status и либо откажется переключать ветку, либо потребует их сохранить. Это признак проблемы: каждая такая правка ломается при очередном обновлении. Я выясняю, что она делала, и переношу эту логику в плагин (о почему править ядро нельзя — в статье про доработку Moodle без правки ядра). Если это невозможно прямо сейчас, правку сохраняют отдельным коммитом в локальной ветке и перепроверяют при каждом обновлении.

Права и владельцы файлов

Частая причина странностей после обновления — файлы, принадлежащие не тому пользователю. Код Moodle обычно принадлежит пользователю, под которым выполняются обновления, и должен быть доступен только на чтение веб-серверу; запись нужна только каталогу данных. Если админка просит обновить плагины, а веб-серверу писать в каталог кода нельзя, обновляйте через git и командную строку — это безопаснее установки через админку.

Обновление плагинов

Для плагинов, которые стоят клонами, обновление выглядит так же, как и для ядра: перейти на нужный тег или ветку, затем выполнить php admin/cli/upgrade.php --non-interactive, потому что новая версия может приносить изменения базы. Перед этим читайте файл с описанием изменений плагина: иногда новая версия требует определённой версии Moodle или переименовывает настройки. Для плагинов собственной разработки я присваиваю теги релизов и обновляю рабочий сервер строго по тегу, а не по ветке, чтобы на сервере всегда было ровно то, что проверено на копии.

cd /var/www/moodle/local/myplugin
git fetch --tags
git checkout v1.4.0
cd /var/www/moodle
php admin/cli/upgrade.php --non-interactive
php admin/cli/purge_caches.php

Чек-лист обновления рабочего сайта

  • Резервная копия базы и каталога данных сделана и проверена на восстановление.
  • Версия PHP и расширения соответствуют целевой версии Moodle.
  • Для каждого стороннего плагина есть версия под новое ядро.
  • Обновление отработано на копии, и время выполнения известно.
  • Окно обновления согласовано, пользователи предупреждены.
  • Известно, как откатываться, и кто принимает решение об откате.
  • После обновления проверены вход, открытие курса, тест, загрузка файла, отправка письма и cron.

Последний пункт — частое упущение: сайт открылся, и обновление считается выполненным, а через сутки обнаруживается, что cron не запускается из-за изменившихся прав на каталог данных. Поэтому проверка работы cron и отправки писем должна быть в списке обязательных.

Автоматизация обновления

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

Типичные ошибки при работе с git на рабочем Moodle

ОшибкаПоследствиеКак избежать
Слежение за веткой MOODLE_..._STABLE на рабочем сервере с автоматическим git pullсайт обновляется без проверки и без копии базыставить конкретный тег и обновляться осознанно
Правка файлов ядра прямо на сервереизменения блокируют переключение версии или теряются при нейвыносить изменения в плагин, а в крайнем случае — в отдельную ветку с коммитом
Откат кода без восстановления базыMoodle отказывается запускаться: версия базы новее кодавсегда делать копию базы до обновления и восстанавливать её при откате
Запуск команд от rootфайлы кэша получают неверного владельцаиспользовать пользователя веб-сервера
Плагин установлен через админку поверх клонарабочий каталог отличается от репозитория, история смешиваетсявыбрать один способ управления для каждого плагина
Забыт режим обслуживанияпользователи работают при частично обновлённой системевключать его первым шагом процедуры

Если процесс всё же сломался посередине, действуйте спокойно: не запускайте обновление повторно «на удачу», сначала прочитайте сообщение скрипта и журнал, затем решайте, откатываться или завершать. Перечень симптомов и мест, где смотреть, собран в статье про отладку Moodle.

Всё это удобно отрабатывать на копии в локальной среде до того, как делать на рабочем сервере. Если вам нужно перевести СДО на управляемый процесс обновления или выполнить сложный переход через несколько версий, пишите на страницу обновления Moodle.

Нужна помощь с Moodle?

Опишите задачу — расскажу, как решить её конкретно в вашем случае. Свяжитесь — разберём вместе.