Глава 18. Настройка менеджера

  1. Подключите репозиторий пакетов PPEM:

    # wget -O pgpro-repo-add.sh https://repo.postgrespro.ru/ppem/ppem/keys/pgpro-repo-add.sh
    # sh pgpro-repo-add.sh
  2. Установите менеджер:

    # apt install ppem ppem-gui

    Файл конфигурации менеджера ppem-manager.yml будет загружен на ваше локальное устройство.

    Путь к файлу конфигурации — /etc/ppem-manager.yml.

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

    # sudo -u postgres createuser --pwprompt ppem

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

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

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

    # psql -h localhost -U ppem -d ppem

    При проблемах с подключением убедитесь, что в файл конфигурации pg_hba.conf добавлено правило HBA, разрешающее пользователю СУБД подключаться к базе данных, а также указан метод авторизации.

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

  6. В файле конфигурации менеджера /etc/ppem-manager.yml:

    • Укажите имя хоста для подключения с помощью параметра repo.host:

      repo:
        host: "localhost"
    • Укажите имя базы данных репозитория с помощью параметра repo.name:

      repo:
        name: "ppem"
    • Укажите имя и пароль пользователя СУБД с помощью параметров repo.user и repo.password:

      repo:
        user: "ppem"
        password: "пароль_пользователя_СУБД"

    Примечание

    Для подключения менеджера к базе данных репозитория вместо параметров выше можно использовать URL. URL необходимо указать в параметре repo.url:

    repo:
      url: "postgres://ppem:пароль_пользователя_СУБД@localhost/ppem"

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

  7. (Необязательно) Чтобы разместить объекты базы данных в схеме, отличной от используемой по умолчанию схемы public, укажите имя пользовательской схемы в файле конфигурации менеджера /etc/ppem-manager.yml с помощью параметра repo.schema:

    repo:
      schema: "myschema"

    Пользовательская схема будет создана автоматически. При необходимости её также можно создать вручную:

    # sudo -u postgres psql -d ppem -c "CREATE SCHEMA myschema AUTHORIZATION ppem;"

    Обратите внимание, что параметр repo.schema можно изменить только до запуска репозитория. Если необходимо сменить схему после запуска, потребуется пересоздать базу данных репозитория. При этом существующие объекты базы данных автоматически перенесены не будут.

  8. Запустите службу менеджера и добавьте её в автозагрузку сервера:

    # systemctl start ppem
    # systemctl enable ppem

Веб-приложение будет установлено на сервере.