29.4. Установка менеджера #
Установите совместимый экземпляр СУБД Postgres Pro на хосте, где будет установлен менеджер.
Это можно сделать как с помощью Ansible (предпочтительный способ), так и вручную.
За подробной информацией об установке обратитесь к официальной документации Postgres Pro.
Создайте и настройте базу данных репозитория. Это можно сделать как с помощью Ansible (предпочтительный способ), так и вручную:
Создайте пользователя СУБД, от имени которого менеджер будет подключаться к базе данных репозитория:
# sudo -u postgres createuser --pwprompt ppem
При выполнении этой команды укажите пароль пользователя СУБД.
Создайте базу данных репозитория:
# sudo -u postgres createdb -O ppem ppem
Убедитесь, что пользователь СУБД может подключиться к базе данных:
# psql -h localhost -U ppem -d ppem
При проблемах с подключением убедитесь, что в файл конфигурации
pg_hba.confдобавлено правило HBA, разрешающее пользователю СУБД подключаться к базе данных, а также указан метод авторизации.Например, чтобы разрешить менеджеру подключаться к базе данных репозитория
ppemот имени пользователяppem, можно настроить следующие правила HBA:host ppem ppem ::1/128 trust host ppem ppem 127.0.0.1/32 trust
За подробной информацией обратитесь к официальной документации Postgres Pro по файлу конфигурации
pg_hba.conf.При подключении к базе данных репозитория
ppemот имени пользователяppemвыдайте право пользователю СУБД на чтение системного каталогаpg_statistic:GRANT SELECT ON pg_catalog.pg_statistic TO ppem;
Получите URL со строкой подключения к базе данных репозитория (в формате, который поддерживается драйвером PostgreSQL pq для языка Go), например:
postgres://ppem:
пароль_пользователя_субд@localhost/ppem
Задайте в инвентаре следующие переменные для хоста, на котором будет установлен менеджер:
ppem_manager_system_user(string, необязательная переменная)Имя пользователя операционной системы, который будет использоваться службой менеджера.
Если указан пользователь, не являющийся root, то этот пользователь будет создан автоматически.
Значение по умолчанию:
root.ppem_manager_system_group(string, необязательная переменная)Имя группы пользователей операционной системы, которая будет назначена пользователю, указанному в
ppem_manager_system_user. Эта группа используется службой менеджера.Значение по умолчанию: значение переменной
ppem_manager_system_user.ppem_manager_systemd_service_enabled(boolean, необязательная переменная)Указывает, нужно ли запускать службу менеджера автоматически после загрузки сервера.
Значение по умолчанию:
true— служба будет запускаться автоматически.ppem_manager_config(dict, обязательная переменная)Параметры конфигурации для менеджера.
В
repo.urlукажите строку подключения для базы данных репозитория, полученную ранее.Другие параметры являются необязательными.
ppem_manager_http_server_tls_cert_file_content(string, необязательная переменная)Содержимое файла публичного сертификата в виде строки.
Эта переменная должна быть указана, если для параметра
cert_fileуказано непустое значение.Роль Ansible записывает указанное содержимое в соответствующий файл. Обратите внимание, что роль не создаёт каких-либо каталогов, поэтому убедитесь, что каталоги по пути
cert_fileсуществуют.ppem_manager_http_server_tls_key_file_content(string, необязательная переменная)Содержимое файла закрытого ключа в виде строки.
Эта переменная должна быть указана, если для параметра
key_fileуказано непустое значение.Роль Ansible записывает указанное содержимое в соответствующий файл. Обратите внимание, что роль не создаёт каких-либо каталогов, поэтому убедитесь, что каталоги по пути
key_fileсуществуют.
Запустите плейбук Ansible, который устанавливает менеджер на хосты, указанные в инвентаре. Например, так:
ansible-playbook pgpro.ppem.ppem_manager -l manager -i inventory.yml
29.4.1. Задачи роли менеджера #
При запуске плейбука роль выполняет следующие задачи:
Проверяет корректность переменных в инвентаре.
При необходимости настраивает репозиторий пакетов Postgres Pro.
При необходимости устанавливает пакеты менеджера.
Настраивает окружение на хосте:
Создаёт пользователя и группу для менеджера, если в инвентаре указан пользователь, не являющийся root.
Настраивает systemd-службу для менеджера.
При необходимости создаёт файлы публичного сертификата и закрытого ключа.
Создаёт файл конфигурации для менеджера.
При необходимости добавляет службу менеджера в автозагрузку и запускает службу.