Глава 18. Настройка агента

Глава 18. Настройка агента
Пред.	Наверх	Часть III. Быстрый старт	Начало	След.

Установите агент:
```
# apt install ppem-agent
```
Файл конфигурации агента ppem-agent.yml будет загружен на ваше локальное устройство.
Создайте пользователя СУБД, от имени которого агент будет подключаться к базе данных управляемого сервера СУБД:
```
# sudo -u postgres createuser -s --pwprompt ppem_agent
```
При выполнении этой команды укажите пароль пользователя СУБД.
Убедитесь, что пользователь СУБД может подключиться к базе данных репозитория:
```
# psql -h localhost -U ppem_agent -d ppem
```
При проблемах с подключением убедитесь, что в файл конфигурации pg_hba.conf добавлено правило HBA, разрешающее пользователю СУБД подключаться к базе данных, а также указан метод авторизации.
За подробной информацией обратитесь к официальной документации Postgres Pro по файлу конфигурации pg_hba.conf.
Получите API-ключ для настройки агента:
1. Войдите в веб-приложение.
2. В навигационной панели перейдите в Главная.
3. Если на странице отображается инструкция по установке агента, скопируйте ключ из инструкции.
4. Если инструкции нет, выполните следующие действия:
  1. В навигационной панели перейдите в Инфраструктура → Агенты.
  2. В столбце Ключ аутентификации для любого агента нажмите либо , чтобы скопировать ключ, либо , чтобы посмотреть ключ.
В файле конфигурации агента ppem-agent.yml укажите параметры агента:
```
agent:
  name: "имя_агента"
  manager:
    url: "URL_для_подключения_к_менеджеру"
    api_key: "ключ_API_для_подключения_к_менеджеру"
  instance:
    connection_defaults:
      user: "имя_пользователя_СУБД"
      password: "пароль_пользователя_СУБД"
http:
  server:
    address: "сетевой_адрес_для_входящих_подключений"
    port: "порт_для_входящих_подключений"
```
Где:
- 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: сетевой адрес и номер порта для входящих сетевых подключений.
  Чтобы включить прослушивание всех сетевых адресов и портов, не указывайте значения для этих параметров.
Запустите службу агента и добавьте её в автозагрузку сервера:
```
# systemctl start ppem-agent
# systemctl enable ppem-agent
```