Распространение агентов через Ansible

Распространение агентов на конечные устройства с помощью Ansible осуществляется только в ОС Linux состоит из следующих этапов:

Подготовка сервера Ansible

Для распространения агентов необходим сервер Ansible — АРМ администратора, на котором запускается плейбук и хранятся установочные файлы.

Для корректной работы АРМ администратора необходимо выполнение следующих требований:

  • Установлен пакет ansible-core версии 2.17.

  • Установлен пакет python3 версии 3.10—​3.12.

Настройку сервера необходимо выполнять с помощью ИТ-службы вашей организации.

При отсутствии центрального сервера Ansible можно выполнить нижеприведенную инструкцию на машине, с которой происходило развертывание кластера Kubernetes для системы.

Более подробная информация о релизах и поддержке доступна в официальной документации Ansible.

Для установки Ansible выполните следующие действия на АРМ администратора:

  1. Установите пакет 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 *
  2. Проверьте корректность установки 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:

  1. Распакуйте архив с плейбуком deploy-evo-agent-master.tar.gz и перейдите в созданную директорию:

    tar -xzvf deploy-evo-agent-master.tar.gz
    cd deploy-evo-agent-master/
  2. Перейдите в директорию 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.
  3. Заполните параметры для доступа к машинам по 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> — пароль пользователя, при необходимости.

  4. Перейдите в директорию с распакованным плейбуком:

    cd deploy-evo-agent-master/
  5. Проверьте корректность настройки инвентаризации и возможность подключения к хостам по SSH:

    ansible evo_agent -m ping
    Пример успешного ответа от хоста
    myhost1.mydomain.local | SUCCESS => {
        "changed": false,
        "ping": "pong"
    }
  6. Разместите установочные пакеты агента в соответствующих директориях распакованного проекта:

    • .deb-пакет — в roles/deploy_evo_agent/files/deb/;

    • .rpm-пакет — в roles/deploy_evo_agent/files/rpm/.

  7. Разместите файл корневого сертификата шлюза в директорию roles/deploy_ca_cert/files/.

    Во избежание конфликта имен при отправке сертификатов на управляемые хосты к их именам по умолчанию добавляется префикс RVision_EVO_Agent_. При необходимости этот префикс можно изменить в файле roles/deploy_ca_cert/defaults/main.yml.
  8. Откройте файл deploy_evo_agent.yml и заполните переменные шлюза:

    • dea_gateway_address — FQDN или IP-адрес шлюза агентов, например: gateway.local;

    • dea_gateway_port — порт шлюза агентов.

  9. Запустите установку агента.

    Для выполнения задач плейбуку потребуется повышение привилегий 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 в домашней директории агента. Включенный режим мандатного контроля целостности (МКЦ) может блокировать конфигурирование, из-за чего выполнение плейбука завершится с ошибкой.

Была ли полезна эта страница?

Обратная связь