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

Статья 17 из 141

Начало работы

Обновление Ubuntu 22.04 до 24.04 на VPS через do-release-upgrade

Ubuntu 22.04 и 24.04 относятся к LTS-версиям. Обновление между ними выполняется на месте командой do-release-upgrade, переустанавливать сервер не нужно. Процесс занимает 20-60 минут и почти всегда проходит гладко, но ломает то, что зависит от версий пакетов: PHP, Python, сторонние репозитории. Ниже порядок, при котором любую ошибку можно откатить.

Если на сервере мало данных и всё описано в Docker Compose, часто быстрее поставить чистую 24.04 и перенести сервисы: переезд на новый сервер.

Что Зачем
Свободно 5 ГБ на диске загрузка и распаковка пакетов (df -h /)
Свежий бэкап данных на случай неудачного обновления
Доступ к VNC-консоли если сервер не загрузится или пропадёт SSH
1-2 часа без нагрузки сервисы будут перезапускаться

Обновление меняет тысячи пакетов. Если оно прервётся, восстановить систему руками сложно. Перед началом:

  1. Сохраните данные за пределами сервера: базы данных (дамп), каталоги сайтов, /etc, тома Docker. Подробно: бэкапы.
  2. Если в панели доступен снимок (snapshot) диска, сделайте его. Откат к снимку занимает минуты.

Минимальный набор, который стоит сохранить в любом случае:

Окно терминала
tar -czf /root/etc-$(date +%F).tar.gz /etc
dpkg --get-selections > /root/packages-$(date +%F).txt

И скачайте эти файлы к себе.

do-release-upgrade откажется работать, пока не установлены все обновления текущей версии. Мы проверили это на Ubuntu 22.04.5:

Checking for a new Ubuntu release
Please install all available updates for your release before upgrading.

Обновите систему полностью. Официальная документация Ubuntu рекомендует включить и фазированные обновления:

Окно терминала
sudo apt update
sudo apt full-upgrade -o APT::Get::Always-Include-Phased-Updates=true
sudo apt autoremove

full-upgrade в отличие от upgrade может удалять и заменять пакеты, если этого требуют зависимости. Затем проверьте, нужна ли перезагрузка, и перезагрузите:

Окно терминала
ls /run/reboot-required && sudo reboot

После перезагрузки убедитесь, что обновлений не осталось:

Окно терминала
apt list --upgradable
Listing...
Окно терминала
sudo apt install ubuntu-release-upgrader-core
do-release-upgrade -c
Checking for a new Ubuntu release
New release '24.04.5 LTS' available.
Run 'do-release-upgrade' to upgrade to it.

Если ответ No new release found, посмотрите настройку в /etc/update-manager/release-upgrades. Для LTS-серверов там должно быть:

[DEFAULT]
Prompt=lts

Со значением never обновление отключено.

Во время обновления все сторонние репозитории (PPA, Docker, Node.js, PostgreSQL, Nginx от разработчиков) отключаются. По данным документации Ubuntu, это самая частая причина проблем после обновления. Заранее запишите, что у вас подключено:

Окно терминала
ls /etc/apt/sources.list.d/

Особое внимание к PPA ondrej/php, с которых ставился PHP. После обновления версии PHP из такого PPA и из Ubuntu могут перемешаться.

Если SSH-соединение оборвётся посреди обновления, процесс может прерваться. Запускайте его внутри tmux:

Окно терминала
sudo apt install tmux
tmux new -s upgrade
sudo do-release-upgrade

Если соединение оборвалось, подключитесь снова и вернитесь в сессию: tmux attach -t upgrade. С screen команды такие: screen -S upgrade и screen -r upgrade.

При запуске по SSH установщик предупреждает о риске и запускает запасной sshd на порту 1022. Если вы используете файрвол, откройте этот порт на время обновления (sudo ufw allow 1022/tcp) и закройте после.

Установщик покажет, сколько пакетов будет обновлено, и попросит подтверждение. Дальше могут быть вопросы:

  • Restart services during package upgrades without asking? Ответьте Yes, иначе вопросов будет много.
  • Изменённый файл конфигурации (например, sshd_config или nginx.conf). По умолчанию сохраняется ваша версия (keep the local version currently installed). Это безопасный выбор. Можно нажать D, чтобы посмотреть разницу.
  • Remove obsolete packages? Обычно y. Если сомневаетесь, ответьте N и уберите их позже через apt autoremove.
  • В конце установщик попросит перезагрузку. Согласитесь.
Окно терминала
lsb_release -a
uname -r
systemctl --failed

systemctl --failed должна показать 0 loaded units listed. Если нет, смотрите журнал проблемной службы: journalctl -u имя -b.

Проверьте, что работает SSH на нужном порту и файрвол включён: sudo ufw status. Затем пройдите по списку:

Что Что меняется в 24.04 Что сделать
PHP 8.1 заменяется на 8.3 Конфиги из /etc/php/8.1/ перенесите в /etc/php/8.3/, в Nginx поменяйте сокет на php8.3-fpm.sock, включите php8.3-fpm. См. PHP-FPM и Nginx
Python 3.10 заменяется на 3.12 Виртуальные окружения ссылаются на старый интерпретатор и перестают работать. Пересоздайте: python3 -m venv venv и pip install -r requirements.txt
pip вне venv в 24.04 pip install в систему запрещён (externally-managed-environment) Ставьте пакеты в venv или через pipx
Docker репозиторий download.docker.com отключён Поменяйте в его файле jammy на noble, выполните apt update && apt upgrade. Контейнеры и тома сохраняются. См. Docker
PostgreSQL из Ubuntu 14 заменяется на 16, старый кластер остаётся Перенесите данные через pg_upgradecluster. Сначала сделайте дамп. См. PostgreSQL
Сторонние PPA отключены Включите заново, только если у PPA есть сборки для noble
Свои службы systemd обычно работают Проверьте systemctl --failed и логи

Отключённые репозитории остаются в /etc/apt/sources.list.d/ в выключенном виде. Включайте их по одному и после каждого делайте sudo apt update, чтобы сразу увидеть ошибку.

  • Обновление прервалось. Вернитесь в tmux attach -t upgrade. Если процесса нет, выполните sudo dpkg --configure -a, затем sudo apt -f install и sudo apt full-upgrade.
  • Сервер не загружается или нет SSH. Подключитесь через VNC-консоль и смотрите journalctl -b -p err.
  • Восстановить не получается. Откатитесь к снимку или переустановите систему и разверните данные из бэкапа.
Симптом Причина / решение
Please install all available updates for your release before upgrading Не все обновления установлены. Выполните apt full-upgrade и перезагрузитесь
No new release found Prompt=never в /etc/update-manager/release-upgrades или текущая версия не 22.04
Not enough free disk space Освободите место: apt clean, journalctl --vacuum-size=200M, docker system prune
Сайт отдаёт 502 после обновления Nginx обращается к сокету старого PHP-FPM. Поменяйте путь на php8.3-fpm.sock
Python-бот не стартует, No such file or directory для venv venv создан под Python 3.10. Пересоздайте его
apt update ругается на репозиторий Сторонний репозиторий без сборки для noble. Отключите его или смените адрес