29.5. Установка агентов #
Для взаимодействия с менеджером агенту требуется API-ключ.
Чтобы получить ключ, используйте веб-приложение PPEM:
В веб-браузере перейдите по следующему URL:
http://
адрес_хоста_менеджера_PPEM:8080/На странице авторизации введите имя пользователя
admin, заданное по умолчанию, и парольadmin, затем нажмите Войти.В навигационной панели перейдите в Главная.
На странице отобразится инструкция по установке агента. Скопируйте ключ из инструкции.
Если инструкция по установке агента случайно закрылась:
В навигационной панели перейдите в Инфраструктура → Агенты.
В столбце Ключ аутентификации рядом с любым агентом нажмите , чтобы скопировать ключ.
Задайте в инвентаре следующие переменные для хостов, на которых будет установлен агент:
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, обязательная переменная)Параметры конфигурации для агента.
Укажите следующие обязательные параметры:
agent.manager.url: URL менеджера.agent.manager.api_key: API-ключ для подключения к менеджеру.
Другие параметры являются необязательными.
Запустите плейбук Ansible, который устанавливает агентов на хосты, указанные в инвентаре. Например, так:
ansible-playbook pgpro.ppem.ppem_agent -l agents -i inventory.yml
29.5.1. Задачи роли агента #
При запуске плейбука роль выполняет следующие задачи:
Проверяет корректность переменных в инвентаре.
При необходимости настраивает репозиторий пакетов Postgres Pro.
При необходимости устанавливает пакеты агента.
Настраивает окружение на хосте:
Создаёт пользователя и группу для агента, если в инвентаре указан пользователь, не являющийся root.
Настраивает systemd-службу для агента.
Создаёт файл конфигурации для агента.
При необходимости добавляет службу агента в автозагрузку и запускает службу.