Физическая копия PostgreSQL через pg_basebackup

Задача и общий подход

Материал посвящён теме «Физическая копия PostgreSQL через pg_basebackup» с акцентом на безопасности и ограничению доступа.

Резервирование PostgreSQL учитывает согласованность данных, роли, расширения и версию. Простое копирование каталога работающей базы не равно корректному дампу.

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

Когда применять этот порядок

Этот сценарий подходит для следующих ситуаций:

• плановое внедрение или перенос компонента категории «PostgreSQL» на новый VPS
• изменение портов, домена, сертификата, маршрута или способа публикации сервиса
• разбор инцидента, когда локальная и внешняя проверки дают разные результаты
• подготовка к обновлению пакета или восстановлению после неудачного изменения

Что должно получиться

После выполнения руководства по теме «Физическая копия PostgreSQL через pg_basebackup» результат должен быть измеримым:

• получить воспроизводимую конфигурацию, проверяемую командами
• зафиксировать логи и признаки успешного запуска
• сохранить резервную точку и понятный сценарий отката
• исключить зависимость от временных правил и ручных действий

Резервная точка

Сохраните именно те файлы и параметры, которые собираетесь менять.

TS=$(date +%F-%H%M%S)
mkdir -p /root/iiadmin-change-$TS
cp -a /path/to/config /root/iiadmin-change-$TS/
systemctl status SERVICE --no-pager > /root/iiadmin-change-$TS/status-before.txt
ss -lntup > /root/iiadmin-change-$TS/listeners-before.txt

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

Подготовка перед изменениями

Подготовительный этап снижает риск потерять доступ и смешать несколько причин одной неисправности.

• Сохраните копии изменяемых файлов с датой и временем.
• Проверьте свободное место, DNS и системное время.
• Используйте встроенную проверку синтаксиса конфигурации.
• Зафиксируйте текущие порты, процессы и состояние службы.
• Подготовьте команду отката до применения изменений.

Пошаговая настройка

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

systemctl status postgresql --no-pager
df -h /var/lib/postgresql /var/backups

sudo -u postgres pg_dump -Fc -d appdb -f /var/backups/appdb-$(date +%F).dump

pg_restore -l /var/backups/appdb-YYYY-MM-DD.dump | head -n 50

sudo -u postgres pg_dumpall --globals-only > /var/backups/postgres-globals-$(date +%F).sql

sudo -u postgres createdb appdb_restore_test
sudo -u postgres pg_restore -d appdb_restore_test /var/backups/appdb-YYYY-MM-DD.dump

Имена доменов, адреса, порты и пути в примерах условные. Перед выполнением замените их фактическими значениями.

Проверка результата

Проверка должна охватывать конфигурацию, процесс, listener и реальный запрос.

• дамп с кодом 0
• pg_restore читает архив
• сохранены роли
• тестовое восстановление успешно
• копия вынесена наружу

systemctl is-active SERVICE
systemctl status SERVICE --no-pager
journalctl -u SERVICE -n 80 --no-pager
ss -lntup

Типичные ошибки

Чаще всего восстановление усложняют следующие действия:

• проверка только локального подключения без внешнего теста
• изменение нескольких компонентов одной командой без промежуточных тестов
• перезапуск службы до проверки синтаксиса
• удаление рабочей конфигурации до успешного запуска новой
• использование устаревшей команды без проверки версии пакета
• игнорирование различий правил IPv4 и IPv6

Безопасность

После получения рабочего результата уменьшите количество исключений и временных разрешений.

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

Диагностика, если не заработало

Диагностика строится как последовательное исключение уровней, а не случайный набор перезапусков.

1. Подтвердите симптом точной командой и запишите время.
2. Проверьте конфигурацию штатным тестом.
3. Проверьте процесс и последние записи журнала.
4. Убедитесь, что нужный адрес и порт слушаются.
5. Сравните локальный запрос с запросом извне.
6. Только затем проверяйте firewall, DNS и маршрут.
7. Меняйте одну переменную и повторяйте тот же тест.

Для темы «Физическая копия PostgreSQL через pg_basebackup» важно не путать открытый firewall с запущенным сервисом: правило доступа не создаёт listener, а активный процесс не гарантирует доступность извне.

Дальнейшее сопровождение

Рабочая конфигурация со временем устаревает и требует контроля.

• документируйте нестандартные пути и зависимости
• контролируйте таймеры, сертификаты и автоматические задания
• храните резервную копию вне VPS
• после обновления повторяйте тест конфигурации и портов
• периодически выполняйте тестовое восстановление

Откат изменений

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

1. не восстанавливать поверх рабочей базы
2. создать тестовую базу
3. сравнить объекты
4. переключать приложение после проверки
5. сохранить исходный кластер

Не удаляйте неудачную конфигурацию до выяснения причины: она полезна для diff и разбора инцидента.

Контрольный список

Перед тем как считать тему «Физическая копия PostgreSQL через pg_basebackup» закрытой, пройдите список:

Что дополнительно сверить в документации

При подготовке материала были сопоставлены разделы русскоязычной документации. Для углублённой проверки полезно изучить:

• pg_dump
• Синтаксис
• Описание
• Предупреждение
• Параметры
• Примечание
• Переменные окружения
• Диагностика

Данные, которые нужно сохранить до изменения

Перед работой по теме «Физическая копия PostgreSQL через pg_basebackup» сохраните состояние именно тех компонентов, которые участвуют в схеме: активную конфигурацию, статус процесса, открытые порты, последние ошибки и результат контрольного запроса. Этот набор позволит отличить последствия новой правки от ранее существовавшего поведения.

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

pg_restore -l /var/backups/appdb-YYYY-MM-DD.dump | head -n 50

Финальная проверка с точки зрения реального клиента

Последнюю проверку темы «Физическая копия PostgreSQL через pg_basebackup» выполняйте тем же способом, которым сервисом будет пользоваться человек или приложение: с нужным доменом, протоколом, учётной записью и внешней сетью. Локальная команда остаётся диагностическим этапом, но не заменяет прохождение всей цепочки.

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

sudo -u postgres createdb appdb_restore_test
sudo -u postgres pg_restore -d appdb_restore_test /var/backups/appdb-YYYY-MM-DD.dump

Побочные эффекты и соседние компоненты

Изменение по теме «Физическая копия PostgreSQL через pg_basebackup» может затронуть соседние части схемы: права файлов, DNS, firewall, reverse proxy, сертификаты, автоматические задания или порядок запуска. До работы перечислите эти связи и выберите по одной короткой проверке для каждой критичной зависимости.

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

Результаты регрессионной проверки записывайте теми же командами, которые использовались до изменения. Это делает сравнение объективным и помогает быстро доказать, что соседний компонент не пострадал.

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

Повторная проверка после restart или перезагрузки

Часть настроек работает только в текущем процессе или до следующего reload. После успешного первичного теста повторите проверку после штатного restart, а для критичной инфраструктуры — после плановой перезагрузки сервера в окно работ.

Сравните автозапуск, владельцев файлов, постоянные правила firewall, DNS и фактический listener. Это выявляет зависимость от ручной команды, временного файла или правила, которое не сохраняется.

sudo -u postgres pg_dumpall --globals-only > /var/backups/postgres-globals-$(date +%F).sql

Проверка синтаксиса и мягкое применение

Используйте встроенную команду проверки до reload или restart. Мягкое перечитывание предпочтительно, когда программа его поддерживает и изменение не требует полного перезапуска.

Сразу после применения проверяйте журнал и реальный запрос, а не только код возврата systemctl.

Критерий отката для текущей задачи

Для темы «Физическая копия PostgreSQL через pg_basebackup» заранее определите признаки неудачи: штатная проверка не проходит, процесс не запускается, ожидаемый listener исчез, внешний клиент получает неверный ответ или в журнале растёт число ошибок. После достижения лимита времени выполняйте откат, а не продолжайте добавлять неподтверждённые изменения.

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

• не восстанавливать поверх рабочей базы
• создать тестовую базу
• сравнить объекты
• переключать приложение после проверки

Контрольные точки именно для этой темы

Для темы «Физическая копия PostgreSQL через pg_basebackup» заранее запишите исходные значения и ожидаемый результат. Это позволяет повторить один и тот же тест до изменения, после применения и после возможного отката.

Не считайте задачу завершённой по одному зелёному статусу. Проверка должна охватывать конфигурацию, процесс, сетевой уровень, журнал и прикладной ответ.

• дамп с кодом 0
• pg_restore читает архив
• сохранены роли
• тестовое восстановление успешно
• копия вынесена наружу

sudo -u postgres pg_dump -Fc -d appdb -f /var/backups/appdb-$(date +%F).dump

Логическая и физическая копия PostgreSQL

pg_dump создаёт переносимую логическую копию отдельной базы, а pg_basebackup копирует физический кластер. Эти способы решают разные задачи и предъявляют разные требования к версии и восстановлению.

Обычное копирование каталога работающего PostgreSQL не гарантирует согласованность. Используйте штатный инструмент и фиксируйте версию сервера.

psql --version
sudo -u postgres psql -c '\l'
sudo -u postgres pg_dump --version

Источники и документация

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

• Компания Postgres Professional
• Компания Postgres Professional
• Компания Postgres Professional
• Компания Postgres Professional