29.5. Установка агентов #

  1. Для взаимодействия с менеджером агенту требуется API-ключ.

    Чтобы получить ключ, используйте веб-приложение PPEM:

    1. В веб-браузере перейдите по следующему URL:

      http://адрес_хоста_менеджера_PPEM:8080/
    2. На странице авторизации введите имя пользователя admin, заданное по умолчанию, и пароль admin, затем нажмите Войти.

    3. В навигационной панели перейдите в Главная.

    4. На странице отобразится инструкция по установке агента. Скопируйте ключ из инструкции.

    5. Если инструкция по установке агента случайно закрылась:

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

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

  2. Задайте в инвентаре следующие переменные для хостов, на которых будет установлен агент:

    ppem_agent_system_user (string, необязательная переменная)

    Имя пользователя операционной системы, который будет использоваться службой агента.

    Если указан пользователь, не являющийся root, то этот пользователь будет создан автоматически.

    Значение по умолчанию: root.

    ppem_agent_system_group (string, необязательная переменная)

    Имя группы пользователей операционной системы, которая будет назначена пользователю, указанному в ppem_agent_system_user. Эта группа используется службой агента.

    Значение по умолчанию: значение переменной ppem_agent_system_user.

    ppem_agent_systemd_service_enabled (boolean, необязательная переменная)

    Указывает, нужно ли запускать службу агента автоматически после загрузки сервера.

    Значение по умолчанию: true — служба будет запускаться автоматически.

    ppem_agent_config (dict, обязательная переменная)

    Параметры конфигурации для агента.

    Укажите следующие обязательные параметры:

    Другие параметры являются необязательными.

  3. Запустите плейбук Ansible, который устанавливает агентов на хосты, указанные в инвентаре. Например, так:

    ansible-playbook pgpro.ppem.ppem_agent -l agents -i inventory.yml

29.5.1. Задачи роли агента #

При запуске плейбука роль выполняет следующие задачи:

  1. Проверяет корректность переменных в инвентаре.

  2. При необходимости настраивает репозиторий пакетов Postgres Pro.

  3. При необходимости устанавливает пакеты агента.

  4. Настраивает окружение на хосте:

    1. Создаёт пользователя и группу для агента, если в инвентаре указан пользователь, не являющийся root.

    2. Настраивает systemd-службу для агента.

    3. Создаёт файл конфигурации для агента.

    4. При необходимости добавляет службу агента в автозагрузку и запускает службу.

FAQ