29.4. Установка менеджера #

  1. Установите совместимый экземпляр СУБД Postgres Pro на хосте, где будет установлен менеджер.

    Это можно сделать как с помощью Ansible (предпочтительный способ), так и вручную.

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

  2. Создайте и настройте базу данных репозитория. Это можно сделать как с помощью Ansible (предпочтительный способ), так и вручную:

    1. Создайте пользователя СУБД, от имени которого менеджер будет подключаться к базе данных репозитория:

      # sudo -u postgres createuser --pwprompt ppem

      При выполнении этой команды укажите пароль пользователя СУБД.

    2. Создайте базу данных репозитория:

      # sudo -u postgres createdb -O ppem ppem
    3. Убедитесь, что пользователь СУБД может подключиться к базе данных:

      # 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.

    4. При подключении к базе данных репозитория ppem от имени пользователя ppem выдайте право пользователю СУБД на чтение системного каталога pg_statistic:

      GRANT SELECT ON pg_catalog.pg_statistic TO ppem;
    5. Получите URL со строкой подключения к базе данных репозитория (в формате, который поддерживается драйвером PostgreSQL pq для языка Go), например:

      postgres://ppem:пароль_пользователя_субд@localhost/ppem
  3. Задайте в инвентаре следующие переменные для хоста, на котором будет установлен менеджер:

    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 существуют.

  4. Запустите плейбук Ansible, который устанавливает менеджер на хосты, указанные в инвентаре. Например, так:

    ansible-playbook pgpro.ppem.ppem_manager -l manager -i inventory.yml

29.4.1. Задачи роли менеджера #

При запуске плейбука роль выполняет следующие задачи:

  1. Проверяет корректность переменных в инвентаре.

  2. При необходимости настраивает репозиторий пакетов Postgres Pro.

  3. При необходимости устанавливает пакеты менеджера.

  4. Настраивает окружение на хосте:

    1. Создаёт пользователя и группу для менеджера, если в инвентаре указан пользователь, не являющийся root.

    2. Настраивает systemd-службу для менеджера.

    3. При необходимости создаёт файлы публичного сертификата и закрытого ключа.

    4. Создаёт файл конфигурации для менеджера.

    5. При необходимости добавляет службу менеджера в автозагрузку и запускает службу.

FAQ