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

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

    # apt install ppem-agent

    Файл конфигурации агента 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. В навигационной панели перейдите в Главная.

    3. Если на странице отображается инструкция по установке агента, скопируйте ключ из инструкции.

    4. Если инструкции нет, выполните следующие действия:

      1. В навигационной панели перейдите в ИнфраструктураАгенты.

      2. В столбце Ключ аутентификации для любого агента нажмите либо Скопировать ключ, чтобы скопировать ключ, либо Показать, чтобы посмотреть ключ.

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

      Чтобы включить прослушивание всех сетевых адресов и портов, не указывайте значения для этих параметров.

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

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