71.3. Привязки экземпляров #

Перед выполнением инструкций из этого раздела создайте хранилище.

71.3.1. Привязка экземпляра к хранилищу #

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

Чтобы привязать экземпляр к хранилищу:

  1. В навигационной панели перейдите в Резервное копирование → Хранилища.

    Чтобы просмотреть привязки к S3-хранилищу, выберите вкладку S3 хранилища.

  2. Нажмите на имя хранилища.

  3. В правом верхнем углу страницы нажмите Привязать экземпляр.

    Отобразятся следующие параметры хранилища:

    • Локальное хранилище или S3 хранилище: уникальное имя хранилища.

    • Catalog: путь к каталогу хранилища, в котором размещены резервные копии.

    • Системный пользователь: пользователь операционной системы, которому принадлежит каталог резервных копий.

  4. Укажите параметры новой привязки экземпляра (помеченные звёздочкой параметры являются обязательными):

    • Идентификатор: уникальное имя привязки экземпляра.

    • Экземпляр: экземпляр, который привязан к хранилищу.

      Если экземпляр размещён не на сервере с локальным хранилищем, укажите следующие параметры:

      • IP удалённого сервера и Порт: IP-адрес и номер порта удалённого сервера, на котором установлен привязанный экземпляр.

      • Пользователь: пользователь операционной системы, которому принадлежат файлы и каталоги экземпляра, и от имени которого запускается служба экземпляра. В большинстве случаев это пользователь postgres.

      • Параметры SSH: параметры подключения по SSH. В утилите pg_probackup эти параметры указываются с помощью параметра удалённого режима --ssh-options.

        Чтобы добавить параметр, нажмите Добавить, затем укажите параметр и его значение.

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

      Такие экземпляры получают пометку Удалённый режим.

    • Параметры хранения: параметры хранения в каталоге резервных копий.

      Доступные параметры:

      • Полные резервные копии, шт. : максимальное количество полных резервных копий.

        Например, если вы вводите 3, в каталоге могут быть не более трёх полных резервных копий.

        Чтобы отключить это ограничение, введите 0. В этом случае максимальное количество полных резервных копий в каталоге не ограничено.

      • Окно восстановления, дни: количество суток, покрываемое резервными копиями.

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

        Чтобы отключить это ограничение, введите 0. В этом случае резервные копии могут быть удалены из каталога в любой момент.

      • Резервные копии для PITR, шт.: минимальное количество резервных копий на каждой линии времени. Резервные копии на каждой линии времени необходимы для восстановления на определённый момент времени (PITR).

        Например, если вы вводите 3, в каталоге всегда должны быть как минимум три резервные копии на каждой линии времени.

        Чтобы отключить это ограничение, введите 0. В этом случае восстановление на определённый момент времени невозможно.

      • Просроченные копии: политика управления устаревшими резервными копиями.

        Возможные значения:

        • Объединять: при возможности объединять устаревшие резервные копии с новыми.

        • Удалять: удалять устаревшие резервные копии из каталога.

        Все флажки можно установить одновременно.

      Полные резервные копии, шт., Окно восстановления, дни и Резервные копии для PITR, шт. применяются, только если в разделе Просроченные копии вы установили флажок Объединять и/или Удалять.

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

      Например, если в поле Полные резервные копии, шт вы вводите 3, а в поле Окно восстановления, дни — 7, будут сохранены не более трёх полных резервных копий, а также все резервные копии, необходимые для восстановления данных за последние семь дней, включая текущий день.

      Применяется следующий приоритет:

      • в первую очередь применяются параметры резервной копии;

      • во вторую очередь применяются параметры экземпляра;

      • в третью очередь применяются параметры хранилища.

      За подробной информацией о параметрах хранения обратитесь к официальной документации Postgres Pro по pg_probackup.

  5. Нажмите Сохранить.

71.3.2. Просмотр привязок экземпляров #

  1. В навигационной панели перейдите в Резервное копирование → Хранилища.

    Чтобы просмотреть привязки к S3-хранилищу, выберите вкладку S3 хранилища.

  2. Нажмите на имя хранилища.

В верхней части страницы отобразятся следующие параметры хранилища:

  • При просмотре привязок экземпляров к локальному хранилищу:

    • Каталог: путь к каталогу локального хранилища, в котором размещаются резервные копии.

    • Системный пользователь: пользователь операционной системы, которому принадлежит каталог резервных копий.

  • При просмотре привязок экземпляров к S3-хранилищу:

    • Поставщик: поставщик S3-хранилища.

    • Регион: регион, в котором размещён сервер S3-хранилища.

    • Протокол: протокол, используемый для взаимодействия между менеджером и S3-хранилищем.

    • Сервер: сервер, на котором выполняются команды для взаимодействия между менеджером и S3-хранилищем.

    • Порт: номер порта для подключения менеджера к S3-хранилищу.

    • Каталог: путь к каталогу внутри бакета, в котором размещаются резервные копии.

    • Корзина: имя бакета на сервере S3-хранилища, в котором размещаются резервные копии.

Ниже отобразится таблица привязок экземпляров со следующими столбцами:

  • Имя привязки.

  • Экземпляр: экземпляр, который привязан к хранилищу. Когда к хранилищу привязывается экземпляр, в хранилище создаётся каталог для резервных копий этого экземпляра.

  • Полные резервные копии, шт. : максимальное количество полных резервных копий.

  • Окно восстановления, дни: количество суток, покрываемое резервными копиями.

  • Резервные копии для PITR, шт.: минимальное количество резервных копий на каждой линии времени. Резервные копии на каждой линии времени необходимы для восстановления на определённый момент времени (PITR).

  • Просроченные копии: политика управления устаревшими резервными копиями.

    Возможные значения:

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

    • Объединять: при возможности объединять устаревшие резервные копии с новыми.

    • Удалять: удалять устаревшие резервные копии из каталога.

  • Действия.

    За подробной информацией о доступных действиях обратитесь к соответствующим инструкциям.

71.3.3. Редактирование привязки экземпляра #

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

Чтобы отредактировать привязку экземпляра:

  1. В навигационной панели перейдите в Резервное копирование → Хранилища.

    Чтобы просмотреть привязки к S3-хранилищу, выберите вкладку S3 хранилища.

  2. Нажмите на имя хранилища.

  3. Нажмите рядом с привязкой экземпляра.

  4. Отредактируйте параметры привязки экземпляра.

  5. Нажмите Сохранить.

71.3.4. Удаление привязки экземпляра #

Важно

После удаления привязки экземпляров невозможно восстановить.

Чтобы удалить привязку экземпляра:

  1. В навигационной панели перейдите в Резервное копирование → Хранилища.

    Чтобы просмотреть привязки к S3-хранилищу, выберите вкладку S3 хранилища.

  2. Нажмите на имя хранилища.

  3. Нажмите рядом с привязкой экземпляра.

  4. Подтвердите операцию и нажмите Удалить.

71.3. Instance Binds #

Before performing instructions from this section, create a storage.

71.3.1. Binding an Instance to a Storage #

You cannot bind an instance to the same storage twice. If an instance is bound for the second time, it is unbound from the previous storage.

To bind an instance to a storage:

  1. In the navigation panel, go to Backup → Storages.

    To view instance binds to an S3 storage, select S3 storages.

  2. Click the name of the storage.

  3. In the top-right corner of the page, click Bind instance.

    The following storage parameters will be displayed:

    • Local storage or S3 storage: The unique name of the storage.

    • Catalog: The path to the storage catalog where backups are placed.

    • System user: The operating system user that owns the backup catalog.

  4. Specify parameters of the new instance bind (parameters marked with an asterisk are required):

    • Identifier: The unique name of the instance bind.

    • Instance: The instance that is bound to the storage.

      If the instance is located on a different server from the local storage, specify the following parameters:

      • Remote server IP and Port: The IP address and port number of the remote server where the bound instance is installed.

      • User: The operating system user that owns files and catalogs of the bound instance and on behalf of which the instance service runs. In most cases, it is the postgres user.

      • SSH parameters: SSH options. In pg_probackup, these options are specified using the --ssh-options remote option.

        To add an option, click Add, and then specify the option and its value.

        You can add multiple options.

      Such instances are marked as Remote mode.

    • Storage parameters: Storage parameters of the backup catalog.

      Available parameters:

      • Full backups, pcs.: The maximum number of full backups.

        For example, if you enter 3, the catalog can contain a maximum of three full backups.

        To disable this limitation, enter 0. In this case, the number of backups in the catalog is not limited.

      • Retention window, days: The number of days (24 hours) covered by backups.

        For example, if you enter 7, the catalog must always contain backups required for restoring the data for the last seven days, including today.

        To disable this limitation, enter 0. In this case, backups can be deleted from the catalog at any moment.

      • PITR backups, pcs.: The minimum number of backups on each timeline. Having backups on all timelines is required for point-in-time recovery (PITR).

        For example, if you enter 3, the catalog must always contain at least three backups on each timeline.

        To disable this limitation, enter 0. In this case, point-in-time recovery is not available.

      • Expired copies: The management policy for expired backups.

        Possible values:

        • Merge: Merge expired backups with new ones if possible.

        • Delete: Delete expired backups from the catalog.

        You can enable all checkboxes simultaneously.

      Full backups, pcs., Retention window, days, and PITR backups, pcs. are applied only if you enable Merge and/or Delete in Expired copies.

      Values of Full backups, pcs. and Retention window, days are considered simultaneously when deleting expired backups from the catalog.

      For example, if you enter 3 in Full backups, pcs. and 7 in Retention window, days, a maximum of three full backups are saved, as well as all backups required for restoring the data for the past seven days, including today.

      The following priority is applied:

      • backup parameters are applied first

      • instance parameters are applied second

      • storage parameters are applied third

      For more information about storage parameters, refer to the official Postgres Pro documentation on pg_probackup.

  5. Click Save.

71.3.2. Viewing Instance Binds #

  1. In the navigation panel, go to Backup → Storages.

    To view instance binds to an S3 storage, select S3 storages.

  2. Click the name of the storage.

The following storage parameters will be displayed at the top of the page:

  • When viewing instance binds to a local storage:

    • Catalog: The path to the local storage catalog where backups are located.

    • System user: The operating system user that owns the backup catalog.

  • When viewing instance binds to an S3 storage:

    • Provider: The provider of the S3 storage.

    • Region: The region where the S3 storage server is located.

    • Protocol: The protocol used for interactions between the manager and S3 storage.

    • Server: The server where commands for interactions between the manager and S3 storage are executed.

    • Port: The port number for connecting the manager to the S3 storage.

    • Catalog: The path to the bucket catalog where backups are located.

    • Bucket: The name of the bucket on the S3 storage server where backups are located.

Below, the table of instance binds with the following columns will be displayed:

  • Bind name.

  • Instance: The instance that is bound to the storage. When an instance is bound to a storage, the backup catalog for this instance is created in the storage.

  • Full backups, pcs.: The maximum number of full backups.

  • Retention window, days: The number of days (24 hours) covered by backups.

  • PITR backups, pcs.: The minimum number of backups on each timeline. Having backups on all timelines is required for point-in-time recovery (PITR).

  • Expired copies: The management policy for expired backups.

    Possible values:

    • Disabled: Do not perform any actions with expired backups.

    • Merge: Merge expired backups with new ones if possible.

    • Delete: Delete expired backups from the catalog.

  • Actions.

    For more information about available actions, refer to the corresponding instructions.

71.3.3. Editing an Instance Bind #

You cannot bind an instance to the same storage twice. If an instance is bound for the second time, it is unbound from the previous storage.

To edit an instance bind:

  1. In the navigation panel, go to Backup → Storages.

    To view instance binds to an S3 storage, select S3 storages.

  2. Click the name of the storage.

  3. Click next to the instance bind.

  4. Edit instance bind parameters.

  5. Click Save.

71.3.4. Deleting an Instance Bind #

Important

Deleted instance binds cannot be restored.

To delete an instance bind:

  1. In the navigation panel, go to Backup → Storages.

    To view instance binds to an S3 storage, select S3 storages.

  2. Click the name of the storage.

  3. Click next to the instance bind.

  4. Confirm the operation and click Delete.

FAQ