Это руководство охватывает оба маршрута: pg_upgradecluster на Ubuntu и Debian, где обертка выбирает новейшую установленную версию и запускает pg_upgrade для вас, и ручное pg_upgrade на Rocky Linux и RHEL, где вы управляете им. Он охватывает сценарий обновления расширений и восстановление статистики.

Резервное копирование, прежде чем трогать что-либо

pg_upgrade перемещает ваши данные на место, поэтому единственное удаление - это резервная копия, которую вы берете перед запуском. Два резервных копия стоит иметь перед серьезным обновлением:

  • Логическая pg_dumpall каждой базы данных, которая удваивается как доказательство того, что 16 все еще могут читать свои собственные данные.

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

Логическая дамп дешевле, и вы можете взять ее, пока 16 продолжает обслуживать трафик.

1
sudo -u postgres sh -c 'pg_dumpall > /var/lib/postgresql/pg16-all.sql'

Сохраните контрольную сумму рядом с файлом и сравните ее еще раз, прежде чем вы когда-либо будете полагаться на дамп:

1
md5sum /var/lib/postgresql/pg16-all.sql

В контрольной группе контрольная сумма:

1
964e38e2b23b7ea4c4708c81f5ff30fb  /var/lib/postgresql/pg16-all.sql

Остановите кластер:

1
sudo tar -C / -czf /var/lib/postgresql/pg16-cluster.tgz var/lib/postgresql/16/main etc/postgresql/16

Этот архив содержит как каталог данных, так и дерево конфигураций под /etc, поэтому восстановление восстанавливает весь кластер. Если диск содержит обе копии, возьмите обе.

Обновление кластера на Ubuntu и Debian

Собственные репозитории Ubuntu 24.04 останавливаются на PostgreSQL 16, поэтому 18 из репозитория. Сценарий настройки - это две команды и ключи к кодовому имени вашего дистрибутива:

1
2
sudo apt install postgresql-common
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh

Сценарий объявляет кодовое имя, которое он будет использовать, и записывает файл repo:

1
2
3
4
5
This script will enable the PostgreSQL APT repository on apt.postgresql.org on
your system. The distribution codename used will be noble-pgdg.
...
Writing /etc/apt/sources.list.d/pgdg.sources ...
You can now start installing packages from apt.postgresql.org.

Затем установите сервер и вытащите пакет, соответствующий версии, для каждого запущенного расширения, потому что pg_upgradecluster запускает пакет предварительной проверки и отказывается начинать, пока он отсутствует:

1
sudo apt install postgresql-18

Например, если вы используете pgvector, вам нужен postgresql-18-pgvector, установленный рядом с вашим существующим postgresql-16-pgvector, и тот же шаблон применяется к каждому пакету расширения.

Перед обновлением подтвердите, с чего вы начинаете: запущенный кластер, его версию и настройку контрольной суммы, потому что настройка контрольной суммы решает, что произойдет позже:

1
2
3
pg_lsclusters
psql --version
sudo /usr/lib/postgresql/16/bin/pg_controldata /var/lib/postgresql/16/main | grep -i checksum

А теперь запустите обновление. Передайте старую версию и название кластера и ничего больше; обертка обнаруживает новейшую установленную версию самостоятельно:

1
sudo pg_upgradecluster 16 main

Когда заканчивается, 16 остановлены на порту 5433, а 18 владеют 5432.

Проверьте, что данные действительно переместились, прежде чем вы что-либо уроните:

1
2
3
sudo -u postgres psql -d appdb -tAc 'SELECT count(*) FROM events'
sudo -u postgres psql -d appdb -c '\dx' | grep -E 'pg_trgm|pgcrypto|vector'
systemctl status postgresql@18-main --no-pager | head -5

Режим Dump безопасен и медленен, потому что он копирует каждую строку в новых каталогах. Режим ссылки жестко связывает старые файлы таблицы в новый кластер, поэтому данные никогда не копируются:

1
sudo pg_upgradecluster --method=link 16 main

Режим Link оставляет вспомогательные скрипты в /var/log/postgresql/pg_upgradecluster-16-18-main./, и скрипт обновления расширения - это тот, который вы фактически будете использовать. Дамп-режим не нуждается ни в одном из них, потому что его восстановление обновляет расширения на пути. Каталог принадлежит Postgres с режимом 700, что имеет значение, когда вы пытаетесь прочитать его за минуту.

Обновление Rocky Linux и RHEL

Системы семейства RHEL не имеют обертки pg_upgradecluster, поэтому вы напрямую управляете pg_upgrade и принимаете решения, которые обертка сделала бы для вас. Все нижеперечисленное работает на Rocky Linux 10 с поддержкой SELinux, и это также относится к RHEL и AlmaLinux. Названия пакетов - единственное, что меняется между RHEL, Alma и Rocky.

Начните с репозитория PGDG и отключите модуль AppStream postgresql, чтобы он не отключал пакеты PGDG:

1
2
sudo dnf install https://download.postgresql.org/pub/repos/yum/reporpms/EL-$(rpm -E %rhel)-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo dnf -qy module disable postgresql

Затем установите 18 сервер и contrib, а также соответствующую версии сборку любого запущенного вами расширения. Расширения отправляются в виде пакетов с прикрепленной версией, поэтому pgvector устанавливается как pgvector_18 рядом с существующим pgvector_16:

1
sudo dnf install postgresql18-server postgresql18-contrib

Теперь сначала введите новый кластер по умолчанию, хотя через минуту он потерпит неудачу, потому что по умолчанию контрольной суммы стоит увидеть один раз. PostgreSQL 18 включает контрольные суммы данных в initdb, и ваш 16 кластер почти наверняка их выключает. Сама проверка нуждается в текущем каталоге, в который могут писать postgres, поэтому блоки ниже cd в /tmp сначала:

1
2
3
4
sudo -u postgres /usr/pgsql-18/bin/initdb -D /var/lib/pgsql/18/data
sudo systemctl stop postgresql-16
cd /tmp
sudo -u postgres /usr/pgsql-18/bin/pg_upgrade -b /usr/pgsql-16/bin -B /usr/pgsql-18/bin -d /var/lib/pgsql/16/data -D /var/lib/pgsql/18/data --check

Удалив свежий каталог данных и инициализировав снова с контрольными суммами, затем та же проверка проходит:

1
2
3
4
sudo rm -rf /var/lib/pgsql/18/data
sudo -u postgres /usr/pgsql-18/bin/initdb -D /var/lib/pgsql/18/data --no-data-checksums
cd /tmp
sudo -u postgres /usr/pgsql-18/bin/pg_upgrade -b /usr/pgsql-16/bin -B /usr/pgsql-18/bin -d /var/lib/pgsql/16/data -D /var/lib/pgsql/18/data --check

Кластеры совместимы с зеленым светом. Еще одна ловушка стоит между вами и реальным запуском: pg upgrade записывает свои выходные скрипты в текущий каталог и запускает его в качестве постгреев из вашего собственного домашнего каталога. Запустите его из каталога Postgres вместо этого:

1
sudo -u postgres sh -c 'cd /var/lib/pgsql && /usr/pgsql-18/bin/pg_upgrade -b /usr/pgsql-16/bin -B /usr/pgsql-18/bin -d /var/lib/pgsql/16/data -D /var/lib/pgsql/18/data --link'

На выходе называются две команды vacuumdb, которые он хочет, чтобы вы запускали после этого, указывается на update_extensions.sql и оставляет delete_old_cluster.sh в /var/lib/pgsql, когда вы закончите с 16. Запустите новый кластер и включите его при загрузке:

1
2
sudo systemctl enable --now postgresql-18
sudo systemctl start postgres-18

Обновление расширений после обновления

pg_upgrade не обновляет объекты расширения; он оставляет каждое расширение в версии 16. Режим Dump обновляет их во время восстановления, но режим ссылки пишет обновление расширения. sql-скрипт и печатает уведомление, указывающее на него. Найдите выходной каталог и прочитайте сценарий:

1
sudo cat /var/log/postgresql/pg_upgradecluster-16-18-main.*/update_extensions.sql

Каждое расширение, которое может быть обновлено, получает одну линию ALTER EXTENSION, префиксированную с соединением с базой данных, в которой оно живет. Вы не можете указать psql на пути файла напрямую, потому что каталог вывода принадлежит Postgres с режимом 700, и ваша оболочка не может войти в него. Вместо этого введите файл:

1
sudo cat /var/log/postgresql/pg_upgradecluster-16-18-main.*/update_extensions.sql | sudo -u postgres psql -X -f -

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

1
sudo -u postgres psql -d appdb -tAc "SELECT extname||' '||extversion FROM pg_extension WHERE extname='pgcrypto'"

pgcrypto переместился с 1,3 на 1,4, и его новая версия прибыла с пакетом postgresql-18, потому что он поставляется в contrib.

Удалить старый кластер

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

1
sudo pg_dropcluster 16 main

После этого pg_lsclusters перечислит только 18:

1
2
Ver Cluster Port Status Owner    Data directory              Log file
18  main    5432 online postgres /var/lib/postgresql/18/main /var/log/postgresql/postgresql-18-main.log

На Rocky оставленный скрипт удаления pg_upgrade выполняет ту же работу: запустите sudo /var/lib/pgsql/delete_old_cluster.sh, как только вы достигнете 18.

Завершение

Если вам понравился этот пост о том, как обновить PostgreSQL с 16 на 18 в Ubuntu и Rocky Linux, пожалуйста, поделитесь им со своими друзьями в социальных сетях, используя кнопки обмена ниже, или просто оставьте комментарий в разделе комментариев. Спасибо.