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

Сервер и эксплуатация

Переход на PostgreSQL 18

Быстрый перенос базы с PostgreSQL 17 на 18 через dump и restore с сохранением старого тома для отката

Смена postgres:17-alpine на postgres:18-alpine не переносит данные. Причин две:

  1. Формат данных несовместим между мажорными версиями. PostgreSQL 18 не откроет каталог, созданный семнадцатой версией, и контейнер упадёт с ошибкой database files are incompatible with server.
  2. В образе 18 изменился путь к данным. Раньше том монтировали в /var/lib/postgresql/data, теперь официальный образ хранит кластер в /var/lib/postgresql/18/docker и объявляет томом весь каталог /var/lib/postgresql. Поэтому в compose путь монтирования тоже меняется.

Самый быстрый и предсказуемый способ — выгрузить базу через pg_dump на старой версии и залить её в чистый том новой. Для базы обычного магазина это занимает минуты.

  • Запланируйте короткое сервисное окно: бот будет остановлен на время переноса.
  • Проверьте, что на диске есть свободное место под дамп и второй том БД: df -h.
  • Перейдите в директорию бота (cd /opt/rwp_shop или ваш фактический путь).

Бот ещё работает — дамп снимается со старого контейнера его же версией pg_dump:

docker compose exec -T db pg_dump -U postgres -d postgres > pg17_dump.sql

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

ls -lh pg17_dump.sql
grep -c "PostgreSQL database dump complete" pg17_dump.sql

Команда должна вывести 1. Если 0 — дамп оборвался (чаще всего кончилось место), не продолжайте.

docker compose down

Без -v. Том со старыми данными должен остаться на месте.

В сервисе db поменяйте три вещи: версию образа, путь монтирования и имя тома.

db:
image: postgres:18-alpine
container_name: rwp_shop_db
restart: unless-stopped
environment:
- POSTGRES_USER=${POSTGRES_USER}
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=${POSTGRES_DB}
- TZ=UTC
ports:
- "127.0.0.1:9999:5432"
volumes:
- rwp_shop_db_data_18:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 3s
timeout: 10s
retries: 3

И в секции volumes внизу файла:

volumes:
rwp_shop_db_data:
rwp_shop_db_data_18:
docker compose up -d db

Дождитесь готовности — команда должна ответить accepting connections:

docker compose exec db pg_isready -U postgres

Убедитесь, что версия действительно новая:

docker compose exec db psql -U postgres -d postgres -c "SHOW server_version;"
docker compose exec -T db psql -U postgres -d postgres < pg17_dump.sql

Отдельные NOTICE в выводе — норма. Строки с ERROR — нет: остановитесь и разберитесь, прежде чем запускать бота.

Проверьте, что данные на месте (число таблиц должно быть больше нуля):

docker compose exec db psql -U postgres -d postgres -c "\dt" | tail -n 5
docker compose up -d

Проверьте, что миграции применились и ошибок подключения нет:

docker compose logs -f bot

Дополнительно проверьте эндпоинт здоровья — в ответе поле postgres должно быть "status": "pass".

После этого зайдите в админ-панель и убедитесь, что видны клиенты, платежи и подписки.

Если что-то пошло не так, вернуться к прежнему состоянию можно за минуту — старый том не изменялся:

docker compose down

Верните в docker-compose.yaml прежние значения:

image: postgres:17-alpine
volumes:
- rwp_shop_db_data:/var/lib/postgresql/data

И поднимите обратно вместе со старой версией образа бота:

docker compose up -d

Когда убедитесь, что всё стабильно (разумно подождать несколько дней), удалите старый том и дамп:

docker volume rm rwp_shop_rwp_shop_db_data
rm pg17_dump.sql

Имя тома в Docker формируется как <имя проекта>_<имя тома> — сверьтесь со списком:

docker volume ls | grep rwp_shop

После удаления старого тома уберите rwp_shop_db_data из секции volumes в compose-файле.

Симптом Причина и решение
database files are incompatible with server PostgreSQL 18 подняли на старом томе. Убедитесь, что в volumes указан новый том и путь /var/lib/postgresql
База пустая после запуска, бот создал схему с нуля Дамп не залили или залили до готовности базы. Остановите бота, удалите новый том, повторите с шага 4
role "postgres" does not exist В .env другое значение POSTGRES_USER. Подставьте его вместо postgres во все команды на этой странице
Дамп оборвался на шаге 1 Чаще всего кончилось место. Проверьте df -h и снимите дамп заново

Остальные ситуации — на странице Устранение неполадок.