2.3. Определение копируемого экземпляра #
pg_probackup3 может сохранять резервные копии разных кластеров баз данных в одном каталоге резервных копий. Для создания необходимых подкаталогов необходимо добавить представление резервной копии (экземпляр) каждого кластера баз данных, копию которого вы будете делать, в каталог копий.
Перед созданием нового копируемого экземпляра убедитесь, что pg_probackup3 может подключиться к целевому кластеру баз данных. Чтобы добавить экземпляр, выполните команду:
pg_probackup3 add-instance -Bкаталог_копий-Dкаталог_данных--instance=имя_экземпляра[параметры_ssh]
Здесь:
каталог_данных— каталог, содержащий данные кластера, копию которого вы хотите сделать. Для подготовки и использования pg_probackup3 необходимо иметь право записи в этот каталог.имя_экземпляра— это имя подкаталогов, в которых будут храниться файлы копируемых данных и WAL для этого кластера.параметры_sshдолжны задаваться дополнительно, есликаталог_данныхрасполагается удалённо.
pg_probackup3 создаёт подкаталоги имя_экземпляра в каталогах backups/ и wal/ внутри каталога резервных копий. Каталог backups/ содержит файл конфигурации имя_экземпляраpg_probackup3.conf с параметрами pg_probackup3, относящимися к данному экземпляру копии. Если этой команде передать параметры SSH, они будут добавлены в pg_probackup3.conf.
Более подробно тонкая настройка pg_probackup3 описывается в Раздел 2.4.
Пользователь, запускающий pg_probackup3, должен иметь полный доступ к каталогу_копий и как минимум доступ на чтение всего содержимого каталога_данных. Если вы зададите путь к каталогу копий в переменной окружения BACKUP_PATH, соответствующий параметр в командах pg_probackup3 можно не указывать.
Примечание
Рекомендуется использовать параметр --allow-group-access, чтобы выполнить копирование мог любой пользователь ОС, включённый в группу владельца кластера. В этом случае пользователь должен иметь права на чтение каталога кластера.
2.3. Adding a New Backup Instance #
pg_probackup3 can store backups for multiple database clusters in a single backup catalog. To set up the required subdirectories, you must add a backup representation (instance) of each database cluster you are going to back up to the backup catalog.
Before adding a new backup instance, ensure that pg_probackup3 can connect to the database cluster you are going to back up. To add a new backup instance, run the following command:
pg_probackup3 add-instance -Bbackup_dir-Ddata_dir--instance=instance_name[ssh_options]
Where:
data_diris the data directory of the cluster you are going to back up. To set up and use pg_probackup3, write access to this directory is required.instance_nameis the name of the subdirectories that will store WAL and backup files for this cluster.ssh_optionsare optional parameters that need to be specified only ifdata_diris located on a remote system.
pg_probackup3 creates the instance_name subdirectories under the backups/ and wal/ directories of the backup catalog. The backups/ directory contains the instance_namepg_probackup3.conf configuration file that controls pg_probackup3 settings for this backup instance. If you run this command with the SSH options, the specified parameters will be added to pg_probackup3.conf.
For details on how to fine-tune pg_probackup3 configuration, see Section 2.4.
The user running pg_probackup3 must have full access to backup_dir directory and at least read-only access to data_dir directory. If you specify the path to the backup catalog in the BACKUP_PATH environment variable, you can omit the corresponding option when running pg_probackup3 commands.
Note
It is recommended to use the --allow-group-access option, so that backups can be done by any OS user in the same group as the cluster owner. In this case, the user should have read permissions for the cluster directory.
