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

Переход с версии 11.x на 12.x

Эта страница предназначена для помощи в миграции экземпляра с YunoHost 11.x (работающего на Debian Bullseye) на YunoHost 12 (работающего на Debian Bookworm).

Важные примечания​

  • Команда YunoHost приложила все усилия, чтобы миграция прошла максимально гладко, и в течение нескольких месяцев проводила тестирование в различных конфигурациях.

  • Пожалуйста, сделайте резервную копию ваших данных и сервера! Эта миграция — сложная процедура, и учесть все возможные подводные камни довольно трудно. В любом случае, будьте терпеливы и внимательны во время миграции.

— Пожалуйста, не спешите думать, что вам нужно переустанавливать систему с нуля, считая это «проще» (вздох). (Распространённое мнение — готовность переустановить сервер при малейших сложностях...). Вместо этого, если у вас возникнут проблемы, мы рекомендуем вам попытаться разобраться в ситуации и обратиться за помощью в чат и на форум.

  • Чтобы убедиться в корректной работе миграции, следите за известными проблемами внизу этой страницы.

Процедура миграции​

Для начала необходимо убедиться, что ваша система обновлена. Миграция доступна начиная с версии 11.3.

Рекомендуется запускать миграцию из командной строки, но это также можно сделать из веб-панели администратора.

Из веб-админки​

Чтобы получить доступ к интерфейсу миграций, перейдите в меню «Инструменты» > «Миграции» (Tools > Migrations). Вам необходимо внимательно прочитать и принять условия отказа от ответственности, после чего запустить миграцию.

Обратите внимание, что даже если вы по какой-либо причине закроете страницу веб-панели администратора, миграция продолжится в фоновом режиме (но веб-панель администратора будет частично недоступна).

Из командной строки​

Выполните:

sudo yunohost tools migrations run

затем внимательно прочтите и примите данное заявление об отказе от ответственности.

Во время миграции​

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

Журналы будут отображаться в модальном окне веб-панели администратора в центре страницы. После миграции их также можно будет просматривать, как и любые другие важные операции, в разделе «Инструменты» > «Журналы» (Tools > Logs).

Если миграция в какой-то момент завершится неудачей​

Если миграция не удалась, первым делом следует попробовать перезапустить её. Если это всё ещё не помогает, вам следует обратиться за помощью к сообществу (пожалуйста, предоставьте сообщение об ошибке, полные логи и любые контекстные элементы, которые помогут в отладке проблемы).

После миграции​

Убедитесь, что вы действительно используете Debian Bookworm и YunoHost 12.x​

Перейдите в раздел «Диагностика» (Diagnosis) (категория «Базовая система» (Base system)) или посмотрите в правый нижний угол веб-панели администрирования, чтобы узнать версию YunoHost.

В командной строке можно использовать команды lsb_release -a и yunohost --version.

Запустите новые ожидающие миграции​

После обновления появились ещё несколько миграций:

  • Пересоздание виртуальных окружений (virtualenv) для ваших Python-приложений
  • Миграция с PostgreSQL 13 на 15

Вам следует запустить их как можно скорее, чтобы обеспечить корректную работу ваших приложений.

Принятие новых Условий использования через командную строку​

Для YunoHost 12.x теперь требуется принять новые Условия использования. Ознакомившись с ними и приняв их, вы можете выполнить следующую команду:

yunohost tools migrations run 0031_terms_of_services --accept-disclaimer

Проверка результатов диагностики​

В разделе «Диагностика» веб-интерфейса администрирования убедитесь, что после выполнения миграции не возникло никаких конкретных проблем (например, аварийной остановки какой-либо службы).

Проверьте, работают ли ваши приложения​

Проверьте работоспособность ваших приложений. Если они не работают, попробуйте обновить их (обновление также является хорошей идеей, даже если они и так работают).

Если ваше приложение не работает, а у вас уже была установлена последняя версия, вы можете повторно запустить обновление благодаря опции -F|--force:

yunohost app upgrade --force APP_NAME

Известные на данный момент проблемы после миграции​

Пожалуйста, ознакомьтесь с разделом часто задаваемых вопросов о проблемах issues FAQ.