4.6. Удалённое восстановление #
Удалённое восстановление в pg_probackup3 — это функция, позволяющая восстанавливать резервные копии напрямую на удалённый хост без необходимости копировать файлы архива вручную. Такой подход существенно сокращает время восстановления и количество ручных операций при аварийном восстановлении, миграции или автоматическом развёртывании. Это особенно полезно в инфраструктурах с централизованным хранением резервных копий, где восстановление выполняется на изолированных удалённых серверах.
Процесс удалённого восстановления включает следующие основные компоненты:
команду send-backup для передачи данных на указанный порт удалённого сервера с использованием многопоточности;
команду receive-backup для получения, распаковки и восстановления данных.
4.6.1. Предварительные требования #
Удалённое восстановление возможно при соблюдении следующих условий:
Утилита pg_probackup3 и библиотека
libpgprobackup.soдолжны быть установлены как на локальном, так и на удалённом хосте.Каталог резервных копий должен быть доступен на локальном хосте.
На удалённом хосте:
Для полного восстановления целевой каталог данных должен быть пустым.
Для инкрементального восстановления (
-I/--incremental-mode) целевой каталог данных должен существовать и содержать данные. Сервер, использующий целевой каталог, должен быть остановлен, и для режимаLSNкаталог не должен содержать файлbackup_label, указывающий на незавершённое резервное копирование. Если целевой каталог пуст, операция автоматически переключается на полное восстановление.Выбранный порт должен быть открыт и доступен для входящих подключений.
Для обеих команд — send-backup и receive-backup — должен быть указан один и тот же порт.
4.6.2. Восстановление резервной копии на удалённом хосте #
Чтобы восстановить экземпляр на удалённом хосте, следуйте инструкциям, приведённым ниже.
На удалённом хосте выполните команду receive-backup, чтобы начать прослушивание порта:
pg_probackup3 receive-backup -D
целевой_каталог_данных-pпортКоманда переходит в режим ожидания входящего подключения.
На локальном хосте выполните команду send-backup, чтобы отправить данные резервной копии на указанный порт удалённого хоста:
pg_probackup3 send-backup -B
каталог_копий--instance=имя_экземпляра-iид_резервной_копии-pпорт-hсервер[-Iинкрементальный_режим] [--no-merge] [параметры_удалённого_архива_wal]Флаг
--no-mergeотключает объединение цепочки резервных копий перед передачей данных. В противном случае цепочка резервных копий автоматически объединяется во временный файл, который удаляется по завершении передачи.Для выполнения удалённого инкрементального восстановления укажите параметр
-I/--incremental-mode.Предупреждение
Для удалённого инкрементального восстановления параметр
-Iдолжен использоваться вместе с флагом--no-merge. В противном случае операция завершится ошибкой.инкрементальный_режимможет быть следующим:CHECKSUM(рекомендуется): считываются все файлы данных в целевом каталоге. Для каждой страницы проверяются заголовок и контрольная сумма. Заменяются только некорректные страницы, а также страницы, в которых контрольная сумма или LSN отличается от значения в соответствующей странице резервной копии. Это самый простой и надёжный инкрементальный режим.LSN: в целевом каталоге данных считывается файлpg_control, чтобы получить LSN и линию времени, с которых начинается повторное выполнение (redo LSN, redo TLI), что позволяет определить точку сдвига — момент, когда состояние каталога данных разошлось с историей цепочки резервных копий. Если точка сдвига находится вне истории цепочки, восстановление прерывается. Если эта точка находится внутри истории, считываются все файлы данных, проверяются заголовок и контрольная сумма каждой страницы, и заменяются только некорректные страницы и те, у которых LSN больше точки сдвига. Этот режим обеспечивает более высокую скорость по сравнению сCHECKSUM, но требует выполнения двух условий:В каталоге данных должны быть включены контрольные суммы данных, чтобы избежать повреждения данных из-за изменения вспомогательных битов. Это условие проверяется в начале инкрементального восстановления — если контрольные суммы отключены, операция прерывается.
Файл
pg_controlдолжен быть синхронизирован с состоянием каталога данных. Для этого условия невозможно настроить автоматическую проверку, поэтому ответственность за актуальность информации вpg_controlлежит на пользователе. Таким образом, режимLSNне рекомендуется использовать в ситуациях, когдаpg_controlповреждён или его содержимому нельзя доверять — например, после выполненияpg_resetwalили после восстановления из резервной копии без воспроизведения WAL.
(Необязательно) Команда
send-backupне поддерживает параметры точки восстановления. Поэтому, если вы восстанавливаете резервную копию, созданную в режимеARCHIVE, и не хотите, чтобы при первом запуске воспроизводились все доступные WAL-файлы, по завершении операцииreceive-backupвручную добавьте следующую строку в файлpostgresql.auto.confв целевом каталогеPGDATA:recovery_target = 'immediate'
4.6.3. Особенности работы #
Если цепочка резервных копий содержит копию типа ARCHIVE, в целевом каталоге PGDATA создаётся пустой файл recovery.signal, который автоматически удаляется по завершении восстановления.
Параметр restore_command формируется из параметра archive_command, который использует archive-push и находится в postgresql.auto.conf или postgresql.conf. Для удалённого архива WAL параметры подключения, указанные с помощью --archive-host, --archive-port и --archive-user в команде send-backup, добавляются к restore_command. Если такой archive_command отсутствует, restore_command необходимо задать вручную.
Если вся цепочка состоит из резервных копий типа STREAM, recovery.signal и restore_command не создаются.