Быстрый старт

В этом разделе описано, как установить PPEM на сервере в соответствии со схемой развёртывания «всё-в-одном» (all-in-one). В результате выполнения приведённых инструкций вы протестируете процесс установки и получите минимальную работоспособную версию PPEM для демонстрационных целей.

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

• Приведены команды для операционной системы Debian Linux. При использовании другой версии операционной системы используйте соответствующие команды.
• В командах указаны стандартные имена для объектов, например ppem для базы данных репозитория. При необходимости можно указать другие имена.

Процесс установки состоит из следующих этапов:

1. Убедитесь, что выполнены предварительные требования.
2. Настройте менеджер.
3. Настройте агент.

PPEM будет установлен. Вы можете обновить страницу браузера с веб-приложением и начать работу.

Предварительные требования

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

1. Подготовьте сервер, на котором будет установлен PPEM, в соответствии с аппаратными и программными требованиями.

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

3. Запустите новый сеанс от имени суперпользователя:

   $ sudo -s

Настройте менеджер

Чтобы настроить менеджер, выполните следующие действия:

1. Установите репозиторий:

   # wget https://repo.postgrespro.ru/ppem/ppem/keys/pgpro-repo-add.sh
   # sh pgpro-repo-add.sh
   # apt update

2. Установите менеджер:

   # apt install ppem ppem-gui

   На ваше локальное устройство скачается конфигурационный файл менеджера /etc/ppem-manager.yml.

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

   # sudo -u postgres createdb -O ppem ppem

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

   # sudo -u postgres createuser --pwprompt ppem

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

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

   # psql -h localhost -U ppem -d ppem

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

6. В конфигурационном файле менеджера /etc/ppem-manager.yml выполните следующие действия:

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

     repo:
       name: "ppem"

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

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

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

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

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

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

   # systemctl start ppem
   # systemctl enable ppem

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

Настройте агент

Чтобы настроить агент, выполните следующие действия:

1. Установите агент:

   # apt install ppem-agent

   На ваше локальное устройство скачается конфигурационный файл агента /etc/ppem-agent.yml.

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

   # sudo -u postgres createuser -s --pwprompt ppem_agent

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

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

   # psql -h localhost -U ppem_agent -d ppem

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

4. Получите API-ключ для настройки агента, выполнив следующие действия:

   1. Войдите в веб-приложение.
   2. Скопируйте API-ключ из отобразившейся инструкции по установке агентов и сохраните его.

5. Укажите параметры агента в конфигурационном файле /etc/ppem-agent.yml:

   • agent.name: уникальное имя агента.
   • agent.manager.url: URL для подключения агента к менеджеру в формате <схема>://<веб-адрес_менеджера>/<путь_к_версии_API>.
   • agent.manager.api_key: ранее полученный API-ключ для подключения агента к менеджеру.
   • agent.instance.connection_defaults.user и agent.instance.connection_defaults.password: имя и пароль пользователя СУБД.
   • http.server.address и http.server.port: IP-адрес и номер порта для входящих сетевых подключений. Чтобы включить прослушивание всех IP-адресов и портов, не указывайте значения для этих параметров.

   Пример конфигурационного файла /etc/ppem-agent.yml:

   agent:
     name: "local"
     manager:
       url: "https://ppem.example.org/v1"
       api_key: "741c5c39-3ac9-402f-aeba-e2fa05bd3037"
     instance:
       connection_defaults:
         user: "ppem_agent"
         password: "<пароль пользователя СУБД>"
   http:
     server:
       address: "192.0.2.1"
       port: "80"

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

   # systemctl start ppem-agent
   # systemctl enable ppem-agent