5.5. Экземпляры #
В этом разделе описано, как управлять экземплярами, и приведены следующие инструкции:
Создание экземпляра
Агенты автоматически обнаруживают установленные на сервере хосты, экземпляры, объекты экземпляров и другие компоненты и создают их в веб-приложении. Автоматическое обнаружение можно настроить в файле конфигурации агента ppem-agent.yml.
Примечание
Автоматическое обнаружение и ряд других возможностей не поддерживаются при установке PPEM с усиленными мерами безопасности.
В PPEM доступны следующие способы создания экземпляров:
Создание нового экземпляра
Создание нового экземпляра подразумевает создание основного каталога данных (data catalog) и запуск службы экземпляра на сервере.
Чтобы создать новый экземпляр:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
В правом верхнем углу страницы нажмите Добавить экземпляр.
Выберите Создать новый экземпляр, затем нажмите Далее.
Укажите параметры нового экземпляра (помеченные звёздочкой параметры являются обязательными):
Имя.
Сервер: сервер, на котором установлен экземпляр.
Системный пользователь: пользователь операционной системы, которому будут принадлежать файлы и каталоги экземпляра, и от имени которого будет запущена служба экземпляра. В большинстве случаев это пользователь
postgres.Убедитесь, что указанный пользователь существует в операционной системе.
Основной каталог данных: путь к каталогу на сервере, в который будут помещены основные каталоги и файлы экземпляра.
Адрес подключения и Порт подключения: сетевой адрес и номер порта, которые экземпляр будет использовать для приёма клиентских подключений.
Метод аутентификации: метод аутентификации, который экземпляр будет использовать для проверки пользователей при приёме клиентских подключений.
Возможные значения:
scram-sha-256.
md5.
trust: не выполнять аутентификацию.
Рекомендуется выбирать это значение только для тестовой среды.
Супер-пользователь БД и Пароль супер-пользователя БД: имя и пароль суперпользователя СУБД, который будет создан, и от имени которого агент будет подключаться к экземпляру.
Имя суперпользователя СУБД по умолчанию —
postgres.Теги: теги, которые будут назначены экземпляру.
Пресет конфигурации: пресет конфигурации, который будет применён к экземпляру.
Возможные значения:
—: не применять к экземпляру пресет конфигурации.
Settings for 1C: применить к экземпляру пресет конфигурации для 1C.
Settings for OLTP: применить к экземпляру пресет конфигурации для OLTP (Online Transaction Processing).
Вы можете применить другой пресет конфигурации к экземпляру позднее.
Запустить экземпляр после создания: указывает, следует ли запустить службу экземпляра после его создания.
Нажмите Выполнить.
Добавление существующего экземпляра
Добавление существующего экземпляра может потребоваться, если у агента выключена функция автоматического обнаружения установленных на сервере экземпляров.
Перед выполнением этой инструкции убедитесь, что экземпляр запущен на сервере и готов принимать клиентские подключения.
Чтобы добавить существующий экземпляр:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
В правом верхнем углу страницы нажмите Добавить экземпляр.
Выберите Добавить существующий экземпляр, затем нажмите Далее.
На этапе Параметры экземпляра укажите параметры экземпляра (помеченные звёздочкой параметры являются обязательными):
Имя.
Сервер: сервер, на котором установлен экземпляр.
Основной каталог данных: путь к каталогу на сервере, в который будут помещены основные каталоги и файлы экземпляра.
Адрес подключения и Порт подключения: сетевой адрес и номер порта, которые экземпляр использует для приёма клиентских подключений.
Супер-пользователь БД и Пароль супер-пользователя БД: имя и пароль суперпользователя СУБД, от имени которого агент будет подключаться к экземпляру.
Имя суперпользователя СУБД по умолчанию —
postgres.Теги: теги, которые будут назначены экземпляру.
Нажмите Выполнить.
Создание экземпляра из резервной копии
За подробной информацией обратитесь к Резервное копирование.
Перед выполнением этой инструкции создайте резервную копию.
Чтобы создать экземпляр из резервной копии:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
В правом верхнем углу страницы нажмите Добавить экземпляр.
Выберите Создать новый экземпляр из резервной копии, затем нажмите Далее.
Укажите параметры резервной копии, из которой будет создан экземпляр (помеченные звёздочкой параметры являются обязательными):
Каталог: каталог хранилища, в котором размещена резервная копия.
Экземпляр: экземпляр, для которого создана резервная копия.
Период: период времени, в который была создана резервная копия.
Резервная копия: резервная копия, из которой будет создан экземпляр.
Нажмите Далее, затем укажите параметры нового экземпляра (помеченные звёздочкой параметры являются обязательными):
Имя.
Сервер: сервер, на котором установлен экземпляр.
Системный пользователь: пользователь операционной системы, которому будут принадлежать файлы и каталоги экземпляра, и от имени которого будет запущена служба экземпляра. В большинстве случаев это пользователь
postgres.Рекомендуется убедиться, что указанный пользователь существует в операционной системе.
Основной каталог данных: путь к каталогу на сервере, в который будут помещены основные каталоги и файлы экземпляра.
Адрес подключения и Порт подключения: сетевой адрес и номер порта, которые экземпляр будет использовать для приёма клиентских подключений.
Теги: теги, которые будут назначены экземпляру.
Резервная копия: резервная копия, из которой будет создан экземпляр.
Значение подставляется автоматически.
Размер РК: размер резервной копии, из которой будет создан экземпляр.
Значение подставляется автоматически.
Точка восстановления: состояние, которое будет восстановлено для экземпляра.
Возможные значения:
—: восстановить последнее состояние экземпляра в рамках резервной копии.
Время: восстановить состояние экземпляра на указанную дату и время в рамках резервной копии.
Для этого значения в поле Время укажите дату и время.
LSN: восстановить состояние экземпляра, соответствующее указанному последовательному номеру в WAL.
Для этого значения в поле LSN введите последовательный номер в WAL.
Транзакция: восстановить состояние экземпляра, соответствующее указанному номеру транзакции.
Для этого значения в поле Транзакция введите номер транзакции.
Для полей Время, LSN и Транзакция укажите следующие параметры:
Восстановить включая указанное значение: указывает, следует ли восстановить состояние для экземпляра до указанного значения включительно.
Например, если в поле Транзакция вы вводите
123456и устанавливаете флажок Восстановить включая указанное значение, для экземпляра восстанавливается состояние, соответствующее транзакции 123456. В противном случае для экземпляра восстанавливается состояние, соответствующее транзакции 123455.Действие после восстановления: указывает, какое действие следует выполнить на сервере после восстановления состояния для экземпляра.
Возможные значения:
Приостановить восстановление (pause): приостановить создание экземпляра из резервной копии. Позволяет убедиться перед созданием экземпляра, что для него было восстановлено правильное состояние.
Завершить восстановление (promote): создать экземпляр из резервной копии и начать принимать клиентские подключения.
Выключить инстанс (shutdown): создать экземпляр из резервной копии и остановить сервер.
Частичное восстановление: указывает, какие базы данных будут восстановлены в экземпляре или наоборот исключены из процесса восстановления.
Возможные значения:
Не использовать: восстановить все базы данных в экземпляре.
Исключить некоторые БД: исключить указанные базы данных из процесса восстановления.
Восстановить некоторые БД: восстановить указанные базы данных в экземпляре.
Для полей Исключить некоторые БД и Восстановить некоторые БД укажите уникальное имя базы данных с помощью Базы данных, затем нажмите Добавить базу данных.
Проверка доступного пространства: позволяет проверить, достаточно ли на сервере дискового пространства для создания экземпляра из резервной копии.
Чтобы запустить проверку, нажмите Проверить.
Нажмите Выполнить.
Просмотр экземпляров
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Отобразится таблица экземпляров со следующими столбцами:
Название:
Уникальное имя экземпляра.
Версия PostgreSQL: версия и редакция Postgres Pro на сервере экземпляра.
Каталог данных: путь к каталогу на сервере, в котором размещаются основные каталоги и файлы экземпляра.
Порт: номер порта, который экземпляр использует для приёма клиентских подключений.
Сервер::
FQDN сервера экземпляра.
IP-адрес сервера экземпляра.
Статус экземпляра.
Возможные значения:
Неизвестен: статус экземпляра неизвестен.
Подготовка инициализации: происходит подготовка к инициализации экземпляра.
Инициализация: происходит инициализация экземпляра.
Инициализация завершена: инициализация экземпляра завершена.
Восстановление: происходит создание экземпляра из резервной копии.
Восстановлено: экземпляр создан из резервной копии.
Восстановление отменено: создание экземпляра из резервной копии было отменено.
Запуск: происходит запуск экземпляра.
Запущен: экземпляр запущен.
Остановка: происходит остановка экземпляра.
Остановлен: экземпляр остановлен.
Перезапуск: происходит перезапуск экземпляра.
Перезагрузка: происходит перезагрузка экземпляра.
Ошибка: произошла ошибка, связанная с экземпляром.
Расписание удаляется: происходит удаление экземпляра.
Базовое резервное копирование: происходит создание резервной копии для экземпляра.
Агент не отвечает: агент, установленный на сервере экземпляра, не отвечает.
Роль.
Возможные значения:
primary: экземпляр является ведущим узлом в кластере репликации и реплицирует данные на резервные узлы.
standby: экземпляр является резервным узлом в кластере репликации и принимает реплицированные данные от ведущего узла.
cascade: экземпляр является резервным узлом в кластере потоковой репликации, принимает реплицированные данные от ведущего узла и одновременно реплицирует данные на другие резервные узлы.
maintenance: экземпляр является отдельным узлом и не добавлен в кластер репликации.
За подробной информацией о репликации данных обратитесь к официальной документации Postgres Pro.
БД:
Базы данных: уникальные имена баз данных.Транзакций в секунду: количество транзакций в секунду в базе данных.Соединения: количество клиентских подключений к базам данных.
Теги: назначенные экземпляру теги.
Проверка целостности каталога экземпляра
Проверка целостности каталога позволяет убедиться, что основные файлы экземпляра не были повреждены в процессе хранения.
Чтобы проверить целостность каталога экземпляра:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
рядом с экземпляром.Нажмите Запустить.
Чтобы просмотреть результат, в навигационной панели перейдите в Консоль заданий и нажмите Показать журнал рядом с заданием, которое было автоматически создано для проверки целостности каталога экземпляра.
Остановка и запуск экземпляра
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
или 
рядом с экземпляром.Чтобы остановить экземпляр, нажмите Остановить.
Перезапуск экземпляра
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
рядом с экземпляром.Нажмите Перезапустить.
Создание резервной копии
За подробной информацией обратитесь к Резервное копирование.
Чтобы создать резервную копию:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
рядом с экземпляром.Укажите параметры новой резервной копии (помеченные звёздочкой параметры являются обязательными):
Экземпляр: экземпляр, для которого будет создана резервная копия.
Значение подставляется автоматически.
Хранилище копий: хранилище, в которое будет помещена резервная копия.
Можно выбрать локальное или S3-хранилище. Локальное хранилище должно находиться на одном сервере с экземпляром, для которого вы создаёте резервную копию.
Пользователь и Пароль: имя и пароль пользователя СУБД, от имени которого будет выполнено резервное копирование.
База данных: база данных для подключения к экземпляру.
Режим копирования: режим резервного копирования.
Возможные значения:
full
page
ptrack
delta
За подробной информацией о режимах резервного копирования обратитесь к официальной документации Postgres Pro по pg_probackup.
Количество потоков: количество параллельных потоков, которые будут запущены при создании резервной копии.
Время ожидания (сек): таймаут в секундах для ожидания архивирования сегментов WAL и потоковой передачи.
Создать автономную резервную копию: указывает, следует ли создать потоковую (stream) резервную копию с записями WAL, необходимыми для последующего восстановления экземпляра.
Слот репликации: слот репликации, который будет использован для передачи записей WAL.
Создать временный слот репликации: указывает, следует ли создать временный слот репликации для передачи записей WAL экземпляра, для которого вы создаёте резервную копию.
Если этот флажок установлен, сегменты WAL остаются доступны, даже если при создании резервной копии происходит их переключение.
Нажмите Далее, затем при необходимости укажите дополнительные параметры:
Внешние каталоги: путь к каталогу экземпляра, который будет дополнительно включён в резервную копию.
Включить каталог log: указывает, следует ли включить в резервную копию каталог с журналами активности экземпляра.
Не проверять копию: указывает, следует ли пропустить автоматическую проверку созданной резервной копии.
Если этот флажок установлен, резервная копия создаётся быстрее.
Растягивать выполнение контрольной точки: указывает, следует ли начать резервное копирование только после выполнения запланированной контрольной точки.
Отключить проверку на уровне блоков: указывает, следует ли отключить проверку контрольных сумм на уровне блоков для ускорения проверки целостности при резервном копировании.
Уровень сжатия: уровень сжатия файлов при резервном копировании.
Можно указать значение от 0 до 9, где 0 — выключить сжатие файлов, а 9 — использовать максимальное сжатие файлов.
Алгоритм сжатия: алгоритм, используемый при сжатии файлов.
Возможные значения:
zlib
lz4
zstd
pglz
Этот параметр доступен, только если в поле Уровень сжатия вы вводите значение больше 0.
Закрепление: параметры закрепления резервной копии.
Возможные значения:
Не закреплять: не закреплять резервную копию.
При выборе этого значения используются параметры, указанные в разделе Параметры хранения.
ttl: резервную копию невозможно удалить из хранилища на протяжении указанного количества дней после её создания.
Для этого значения в поле Срок хранения, дни введите количество дней.
expire-time: резервную копию невозможно удалить из хранилища до указанной даты и времени.
Для этого значения в поле Срок хранения до укажите дату и время.
Параметры хранения: параметры хранения резервных копий в созданном для экземпляра каталоге хранилища.
Доступные параметры:
Полные резервные копии: максимальное количество полных резервных копий.
Например, если вы указываете
3, в каталоге могут быть не более трёх полных резервных копий.Чтобы отключить это ограничение, укажите
0. В этом случае максимальное количество полных резервных копий в каталоге не ограничено.Точка восстановления: количество суток, покрываемое резервными копиями. Например, если вы указываете
7, в каталоге всегда должны быть резервные копии, необходимые для восстановления данных за последние семь дней, включая текущий день.Чтобы отключить это ограничение, укажите
0. В этом случае резервные копии могут быть удалены из каталога в любой момент.РК для PITR: минимальное количество резервных копий на каждой линии времени. Резервные копии на каждой линии времени необходимы для восстановления на определённый момент времени (PITR).
Например, если вы указываете
3, в каталоге всегда должны быть как минимум три резервные копии на каждой линии времени.Чтобы отключить это ограничение, укажите
0. В этом случае восстановление на определённый момент времени невозможно.Просроченные копии: политика управления устаревшими резервными копиями.
Возможные значения:
Объединять: при возможности объединять устаревшие резервные копии с новыми.
Удалять: удалять устаревшие резервные копии из каталога.
Удалить просроченные WAL: удалять WAL устаревших резервных копий из каталога.
Все флажки можно установить одновременно.
Полные резервные копии, Точка восстановления и РК для PITR применяются, только если для параметра Просроченные копии вы устанавливаете флажок Объединять и/или Удалять.
При удалении устаревших резервных копий из каталога одновременно учитываются значения Полные резервные копии и Точка восстановления . Например, если в поле Полные резервные копии вы вводите
3и в поле Точка восстановления —7, сохраняется не более трёх полных резервных копий, а также все резервные копии, необходимые для восстановления данных за последние 7 дней, включая текущий день.Параметры хранения также можно настроить для экземпляра, а также для хранилища при его создании или редактировании.
Применяется следующий приоритет:
в первую очередь применяются параметры резервной копии
во вторую очередь применяются параметры экземпляра
в третью очередь применяются параметры хранилища
За подробной информацией о параметрах хранения обратитесь к официальной документации Postgres Pro по pg_probackup.
Нажмите Выполнить РК.
Применение пресета конфигурации к экземпляру
К экземпляру можно применить другой пресет конфигурации.
Важно
При применении пресета конфигурации экземпляр может автоматически перезапуститься, если это необходимо, чтобы изменения вступили в силу.
Чтобы применить пресет конфигурации к экземпляру:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
рядом с экземпляром.Выберите новый пресет конфигурации.
Нажмите Применить.
Редактирование экземпляра
При редактировании экземпляра его можно выбрать экземпляром репозитория.
Чтобы отредактировать экземпляр:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
рядом с экземпляром.Отредактируйте параметры экземпляра.
Нажмите Сохранить.
Выбор экземпляра репозитория
База данных репозитория размещается в экземпляре. Этот экземпляр, как и другие экземпляры, можно создать в веб-приложении.
Вам нужно вручную указать в веб-приложении, в каком из экземпляров размещается база данных репозитория.
Чтобы выбрать экземпляр репозитория:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
рядом с экземпляром.Установите флажок Экземпляр репозитория EM.
Нажмите Сохранить.
Удаление экземпляра
Важно
После удаления экземпляра из веб-приложения его также необходимо удалить на сервере. В противном случае экземпляр снова будет автоматически создан в веб-приложении.
При установке PPEM с усиленными мерами безопасности, если вы удалили автоматически созданный экземпляр, он больше не будет автоматически создаваться. В этом случае для восстановления экземпляр необходимо добавить вручную.
Чтобы удалить экземпляр:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
Нажмите
рядом с экземпляром.(Необязательно) Чтобы удалить основной каталог данных экземпляра на сервере, установите флажок Удалить с каталогом данных.
Подтвердите операцию и нажмите Удалить.