Перейти к основному содержимому

Откат до предыдущей версии

Обновлено: 23 октября 2026

Принципы и правила отката:

  • откат возможен только к той версии приложения, в которую уже встроен механизм миграций и отката. Первая версия, в которой появился такой механизм, поддерживает возврат только к состоянию baseline (начальной контрольной точке);
  • откат затрагивает только схему БД ядра (connect-lite) и не изменяет БД компонентов веб-интерфейса (web-backend и web);
  • не следует использовать параметр ROLLBACK_FORCE=true, поскольку он отключает защитные проверки перед откатом;
  • нельзя запускать откат до того, как закончится миграция: после команды docker compose up сервис edna-connect-lite-migration должен перейти в статус Exited;
  • процедура отката одинакова для завершенных и незавершенных (прерванных ошибкой) обновлений;
  • повторный запуск отката безопасен: система выведет сообщение Nothing to rollback, ничего не изменит, а в случае успеха завершится с кодом 0.
warning

Откат удаляет из БД все таблицы и поля, добавленные новой версией, вместе с их данными.

Порядок отката​

Все команды выполняйте из корневой папки релиза, в которой лежат файлы docker-compose.yaml и .env. Если на сервере установлена утилита Compose V1 (docker-compose), то в приведенных ниже командах подставляйте ее имя вместо docker compose.

Порядок отката:

  1. Остановите сервисы.
docker compose stop
к сведению

Если в docker-compose.yaml описана БД, то она также будет остановлена, однако на следующем шаге автоматически запустится.

  1. Откатите БД:

2.1. В параметре ROLLBACK_TAG укажите в формате x.y.z целевую версию, на которую откатываетесь. При этом переменная BACKEND_IMAGE в файле .env должна указывать на образ версии, с которой выполняется откат.

warning

Режим отката задается только параметром MODE=rollback, его нельзя прописывать в файлах .env и docker-compose.yaml.

Пример команды для возврата на версию 5.10.5.

docker compose run --rm -e MODE=rollback -e ROLLBACK_TAG=5.10.5 -e ROLLBACK_PREVIEW=false edna-connect-lite-migration
к сведению

Вы можете предварительно просмотреть SQL-запросы, которые откатывают БД. Для этого выполните команду без блока -e ROLLBACK_PREVIEW=false.

2.2. Проверьте, что откат БД выполнен успешно, т.е. с кодом 0.

echo $?

Любой другой код означает ошибку.

к сведению

Команду echo $? нужно выполнить сразу после команды отката.

  1. Запустите приложение:

3.1. Отредактируйте файл .env, указав BACKEND_IMAGE целевой версии.

3.2. Запустите сервисы.

docker compose up -d

Сначала отработает миграция целевой версии, затем стартует приложение.

3.3. Проверьте статус миграции и приложения.

docker compose ps -a

Если откат выполнен успешно, то будут получены статусы:

  • edna-connect-lite-migration — Exited (0) (в docker-compose — Exit 0);
  • edna-connect-lite — Up. Если код миграции не 0, обратитесь в edna.
  1. Очистите кеш и перезапустите приложение.
docker compose exec edna-connect-lite sh -c "rm -rf /data/* /data/.*"
docker compose restart edna-connect-lite
к сведению

Сообщение утилиты rm об отказе удалить . или .., а также ненулевой код первой команды — нормальный результат, кеш при этом будет очищен.

Ошибки и рекомендации по их устранению​

Если на шаге 2 получен отличный от нуля код, значит при откате БД произошла ошибка. Помимо кода, выводится сообщение с описанием характера ошибки.

Сообщение об ошибкеОписаниеРекомендация по устранению
Missing required argument --rollback.tagНе задана целевая версия (не передано значение параметра ROLLBACK_TAG)Укажите версию и повторите команду (шаг 2.1)
Invalid --rollback.tagНеверный формат значения целевой версииУкажите значение в формате x.y.z и повторите команду (шаг 2.1)
Tag [...] is unknown to this application image. Known tags: ...Указанной версии нет в образеСписок версий, включенных в образ, приведен в сообщении об ошибке Укажите корректное значение целевой версии и повторите команду (шаг 2.1)
Unknown application modeОшибочное значение параметра MODEУкажите корректное значение MODE=rollback и повторите команду (шаг 2.1)
--mode must be passed exactly onceОшибочное значение параметра MODEУкажите корректное значение MODE=rollback и повторите команду (шаг 2.1)
... are unknown to this application imageНеверный образ для отката. Частая причина ошибки — преждевременное изменение параметра BACKEND_IMAGE в файле .envУкажите в файле .env образ версии, на которую выполнялось обновление, и повторите команду (шаг 2.1). Если указан правильный образ, но ошибка повторилась, обратитесь в edna
Rollback history is brokenСостояние БД не позволяет безопасно откатитьсяОбратитесь в edna

Перечисленные выше ошибки выдаются до начала отката БД. Если приведенная в таблице рекомендация не помогла, а новая версия работает без критических ошибок, вы можете временно использовать ее. В этом случае файл .env править не нужно.

docker compose up -d

Если произошла ошибка отката, которой нет в таблице, то приложение не следует запускать, поскольку БД могла частично откатиться. Для определения причин такой ошибки обратитесь в edna.