Распространение агентов через Ansible
Распространение агентов на конечные устройства с помощью Ansible осуществляется только в ОС Linux состоит из следующих этапов:
Подготовка сервера Ansible
Для распространения агентов необходим сервер Ansible — АРМ администратора, на котором запускается плейбук и хранятся установочные файлы.
Для корректной работы АРМ администратора необходимо выполнение следующих требований:
-
Установлен пакет ansible-core версии 2.17.
-
Установлен пакет python3 версии 3.10—3.12.
| Настройку сервера необходимо выполнять с помощью ИТ-службы вашей организации. |
При отсутствии центрального сервера Ansible можно выполнить нижеприведенную инструкцию на машине, с которой происходило развертывание кластера Kubernetes для системы.
| Более подробная информация о релизах и поддержке доступна в официальной документации Ansible. |
Для установки Ansible выполните следующие действия на АРМ администратора:
-
Установите пакет ansible-core версии 2.17 с помощью пакетного менеджера
pip:python3 -m pip install ansible-core==2.17Для установки пакетов можно воспользоваться архивом для Python 3 версии 3.12.12 —
python3-pip_packages.tar.gz.Распакуйте его и запустите установку:
tar -xzvf python3-pip_packages.tar.gz cd python3-pip_packages/ python3 -m pip install * -
Проверьте корректность установки Ansible:
ansible --versionЕсли установка прошла успешно, в результате выполнения команды будет выведена версия Ansible.
|
Более подробная информация по установке доступна в официальной документации Ansible. |
Подготовка управляемых хостов
Для управляемых хостов необходимо соблюдение следующих требований:
-
Установлен пакет python3 версии 3.7—3.12.
-
Установлены утилиты для работы с сертификатами:
-
update-ca-certificates— для дистрибутивов семейства Debian. -
update-ca-trust— для дистрибутивов семейства RedHat.
-
-
Установлены и доступны пакетные менеджеры:
-
apt— для дистрибутивов семейства Debian. -
dnfилиyum— для дистрибутивов семейства RedHat.
-
-
Подключены локальные или сетевые репозитории, необходимые для корректной работы модулей Ansible.
-
Настроен SSH-доступ по паролю или ключам. Учетная запись, используемая для подключения по SSH, должна иметь права на повышение привилегий через sudo.
-
Подготовлен корневой CA-сертификат шлюза для установки агента. Инструкция по созданию сертификата приведена в разделе Добавление TLS-сертификата на хосте агента. Подготовленный файл должен полностью совпадать с сертификатом, установленным на сервере шлюза. Данный сертификат требуется только при использовании защищенного соединения со шлюзом.
Установка агента на устройства
| Перед развертыванием агентов в промышленной эксплуатации обязательно протестируйте плейбук в тестовом окружении. |
Установка агента осуществляется с помощью архива проекта Ansible — deploy-evo-agent-master.tar.gz.
Для настройки и запуска установки выполните следующие действия на сервере Ansible:
-
Распакуйте архив с плейбуком
deploy-evo-agent-master.tar.gzи перейдите в созданную директорию:tar -xzvf deploy-evo-agent-master.tar.gz cd deploy-evo-agent-master/ -
Перейдите в директорию
inventory/и заполните файлhosts.yml, указав адреса управляемых хостов.Примеры заполнения файла
hosts.ymlС указанием IP-адресов:
evo_agent: hosts: 192.168.1.1: 192.168.1.2:С указанием FQDN:
evo_agent: hosts: myhost1.mydomain.local: myhost2.mydomain.local:С указанием псевдонимов:
evo_agent: hosts: alpha: ansible_host: 192.168.1.1Более подробная информация о правилах формирования файлов инвентаризации приведена в официальной документации Ansible. -
Заполните параметры для доступа к машинам по SSH в одном из конфигурационных файлов. Выбор файла зависит от требуемой области применения настроек:
-
inventory/group_vars/all.yml— для применения параметров ко всем хостам из файла инвентаризации. -
inventory/group_vars/evo_agent.yml— для применения параметров к хостам из группыevo_agent.В целях безопасности рекомендуется задавать параметры в файле evo_agent.yml. Это позволит применить учетные данные исключительно к целевой группе хостов.
ansible_ssh_user: <ssh_user> ansible_ssh_pass: <ssh_pass>Здесь:
-
<ssh_user>— имя пользователя для подключения по SSH. -
<ssh_pass>— пароль пользователя, при необходимости.
-
-
Перейдите в директорию с распакованным плейбуком:
cd deploy-evo-agent-master/ -
Проверьте корректность настройки инвентаризации и возможность подключения к хостам по SSH:
ansible evo_agent -m pingПример успешного ответа от хостаmyhost1.mydomain.local | SUCCESS => { "changed": false, "ping": "pong" } -
Разместите установочные пакеты агента в соответствующих директориях распакованного проекта:
-
.deb-пакет — в
roles/deploy_evo_agent/files/deb/; -
.rpm-пакет — в
roles/deploy_evo_agent/files/rpm/.
-
-
Разместите файл корневого сертификата шлюза в директорию
roles/deploy_ca_cert/files/.Во избежание конфликта имен при отправке сертификатов на управляемые хосты к их именам по умолчанию добавляется префикс RVision_EVO_Agent_. При необходимости этот префикс можно изменить в файлеroles/deploy_ca_cert/defaults/main.yml. -
Откройте файл
deploy_evo_agent.ymlи заполните переменные шлюза:-
dea_gateway_address— FQDN или IP-адрес шлюза агентов, например:gateway.local; -
dea_gateway_port— порт шлюза агентов.
-
-
Запустите установку агента.
Для выполнения задач плейбуку потребуется повышение привилегий sudo. Если на управляемых хостах не настроено беспарольное повышение привилегий, укажите при запуске флаг -Kдля интерактивного ввода пароля.-
Запуск с настроенным беспарольным доступом sudo:
cd deploy-evo-agent-master/ ansible-playbook deploy_evo_agent.yml -
Запуск с интерактивным вводом пароля:
cd deploy-evo-agent-master/ ansible-playbook deploy_evo_agent.yml -K
Во время установки происходит настройка шлюза агента путем изменения файла etc/rpoint.confв домашней директории агента. Включенный режим мандатного контроля целостности (МКЦ) может блокировать конфигурирование, из-за чего выполнение плейбука завершится с ошибкой. -
Была ли полезна эта страница?