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. Восстановление резервной копии на удалённом хосте #

Чтобы восстановить экземпляр на удалённом хосте, следуйте инструкциям, приведённым ниже.

  1. На удалённом хосте выполните команду receive-backup, чтобы начать прослушивание порта:

    pg_probackup3 receive-backup -D целевой_каталог_данных -p порт

    Команда переходит в режим ожидания входящего подключения.

  2. На локальном хосте выполните команду 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.

  3. (Необязательно) Команда 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 не создаются.

FAQ