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

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

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

Приведены команды для операционной системы Debian Linux. При использовании другой версии операционной системы используйте соответствующие команды.

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

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

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

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

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

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

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

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

$ sudo -s

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

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

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

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

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

# apt install ppem ppem-gui

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

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

# sudo -u postgres createdb -O ppem ppem

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

# sudo -u postgres createuser --pwprompt ppem

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

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

# psql -h localhost -U ppem -d ppem

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

В конфигурационном файле менеджера /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 по строкам параметров подключения.

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

# systemctl start ppem
# systemctl enable ppem

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

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

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

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

# apt install ppem-agent

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

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

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

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

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

# psql -h localhost -U ppem_agent -d ppem

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

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

Укажите параметры агента в конфигурационном файле /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"

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

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