Статья 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. Бэкап
Заголовок раздела «Шаг 1. Бэкап»Обновление меняет тысячи пакетов. Если оно прервётся, восстановить систему руками сложно. Перед началом:
- Сохраните данные за пределами сервера: базы данных (дамп), каталоги сайтов,
/etc, тома Docker. Подробно: бэкапы. - Если в панели доступен снимок (snapshot) диска, сделайте его. Откат к снимку занимает минуты.
Минимальный набор, который стоит сохранить в любом случае:
tar -czf /root/etc-$(date +%F).tar.gz /etcdpkg --get-selections > /root/packages-$(date +%F).txtИ скачайте эти файлы к себе.
Шаг 2. Обновите текущую систему
Заголовок раздела «Шаг 2. Обновите текущую систему»do-release-upgrade откажется работать, пока не установлены все обновления текущей версии. Мы проверили это на Ubuntu 22.04.5:
Checking for a new Ubuntu releasePlease install all available updates for your release before upgrading.Обновите систему полностью. Официальная документация Ubuntu рекомендует включить и фазированные обновления:
sudo apt updatesudo apt full-upgrade -o APT::Get::Always-Include-Phased-Updates=truesudo apt autoremovefull-upgrade в отличие от upgrade может удалять и заменять пакеты, если этого требуют зависимости. Затем проверьте, нужна ли перезагрузка, и перезагрузите:
ls /run/reboot-required && sudo rebootПосле перезагрузки убедитесь, что обновлений не осталось:
apt list --upgradableListing...Шаг 3. Проверьте, доступна ли 24.04
Заголовок раздела «Шаг 3. Проверьте, доступна ли 24.04»sudo apt install ubuntu-release-upgrader-coredo-release-upgrade -cChecking for a new Ubuntu releaseNew 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 обновление отключено.
Шаг 4. Сторонние репозитории
Заголовок раздела «Шаг 4. Сторонние репозитории»Во время обновления все сторонние репозитории (PPA, Docker, Node.js, PostgreSQL, Nginx от разработчиков) отключаются. По данным документации Ubuntu, это самая частая причина проблем после обновления. Заранее запишите, что у вас подключено:
ls /etc/apt/sources.list.d/Особое внимание к PPA ondrej/php, с которых ставился PHP. После обновления версии PHP из такого PPA и из Ubuntu могут перемешаться.
Шаг 5. Запуск в tmux или screen
Заголовок раздела «Шаг 5. Запуск в tmux или screen»Если SSH-соединение оборвётся посреди обновления, процесс может прерваться. Запускайте его внутри tmux:
sudo apt install tmuxtmux new -s upgradesudo do-release-upgradeЕсли соединение оборвалось, подключитесь снова и вернитесь в сессию: tmux attach -t upgrade. С screen команды такие: screen -S upgrade и screen -r upgrade.
При запуске по SSH установщик предупреждает о риске и запускает запасной sshd на порту 1022. Если вы используете файрвол, откройте этот порт на время обновления (sudo ufw allow 1022/tcp) и закройте после.
Шаг 6. Вопросы во время обновления
Заголовок раздела «Шаг 6. Вопросы во время обновления»Установщик покажет, сколько пакетов будет обновлено, и попросит подтверждение. Дальше могут быть вопросы:
- 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. - В конце установщик попросит перезагрузку. Согласитесь.
Шаг 7. Проверка после обновления
Заголовок раздела «Шаг 7. Проверка после обновления»lsb_release -auname -rsystemctl --failedsystemctl --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. Отключите его или смените адрес |