Просмотр кода страницы Установка OneAgent с помощью Ansible

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

== Требования ==

* Ansible >= 2.9.0, < 2.10.0
* OneAgent версии 1.199+
* Dynatrace версии 1.204+
* Сценарий доступа к файлам установщика OneAgent

== Зависимости ==

* pywinrm 0.4.1+

== Загрузите коллекцию Dynatrace Ansible ==
1. Выберите «Развернуть Dynatrace» в меню навигации, а затем выберите «Начать установку».

2. Выберите коллекцию Ansible, чтобы загрузить архив коллекции.

Это безопасный архив, размещенный в вашей среде Dynatrace.
 

== Установите коллекцию Dynatrace Ansible ==
1. Сохраните коллекцию Ansible Dynatrace

Сохраните tar-архив коллекции Ansible в каталоге на узле управления Ansible.

2. Установите коллекцию Ansible Dynatrace

Чтобы установить коллекцию Ansible, перейдите в каталог, в котором вы сохранили архив коллекции Ansible, и выполните следующую команду:
 ansible-galaxy collection install astromkey-oneagent-ansible-1.0.0.20200101-060000.tar.gz
Коллекция состоит из одной роли Ansible, которая развертывает OneAgent с использованием специальной конфигурации. Конфигурация гарантирует, что служба OneAgent остается в рабочем состоянии. Дополнительные сведения см. в разделе Использование коллекций в документации Ansible.

== Настройка коллекции Ansible Dynatrace ==
Для сценария Ansible требуется доступ к соответствующим файлам установщика OneAgent.

* Если ваш управляющий узел Ansible имеет доступ к вашей среде Dynatrace, вы можете настроить сценарий для загрузки файлов установщика непосредственно из среды Dynatrace.
* Кроме того, вы можете самостоятельно загрузить соответствующие файлы установщика — с помощью веб-интерфейса Dynatrace — и загрузить их на узел управления. Это обеспечивает сценарий локальными копиями установщиков.

=== Вариант 1. Используйте прямую загрузку из среды Dynatrace. ===
Сценарий использует Deployment API для загрузки установщиков для конкретной платформы на управляемые узлы. Вам нужно будет указать переменные, чтобы предоставить роли Ansible информацию, необходимую для аутентификации вызова API в вашей среде:

* <code>oneagent_environment_url</code>:
** 
** '''Managed''': <nowiki>https://{ваш-домен}/e/{идентификатор-вашей-среды}</nowiki>
* <code>oneagent_paas_token</code>
** Токен PaaS вашей среды

Мы рекомендуем безопасно хранить и токен PAAS, и идентификатор среды, используя такие механизмы шифрования, как Ansible Vault. Дополнительные сведения см. в разделе Шифрование содержимого с помощью Ansible Vault.

=== Вариант 2. Используйте локальные установщики ===
Используйте веб-интерфейс Dynatrace для загрузки необходимых файлов установщика OneAgent, а затем загрузите их на узел управления. Затем сценарий Ansible скопирует файлы установщика на управляемые узлы во время выполнения.

Используйте переменную <code>oneagent_local_installer</code>, чтобы предоставить роли Ansible путь к файлу установщика. Например:
 oneagent_local_installer: /path/of/oneagent_linux_installer.sh
Обратите внимание, что для Windows, Linux и AIX требуются специальные программы установки. Исходные имена установщиков, загруженные с Dynatrace, включают обозначения целевых платформ. Если вы меняете имена установщиков, убедитесь, что сценарий может их различать.

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

Пример использования см. в файле <code>local_installer.yml</code> в разделе Примеры.

== Переменные ==
Роль OneAgent Ansible поддерживает следующие переменные:
{| class="wikitable"
!Название
!Значение по умолчанию
!Описание
|-
|<code>oneagent_environment_url</code>
|unset
|URL целевой среды Dynatrace (SaaS или Managed).
|-
|<code>oneagent_paas_token</code>
|unset
|Токен PaaS, полученный со страницы развертывания Dynatrace.
|-
|<code>oneagent_local_installer</code>
|unset
|Путь к установщику OneAgent, хранящемуся на узле управления.
|-
|<code>oneagent_installer_arch</code>
|Linux: <code>x86</code>
Windows: <code>x86</code>
AIX: <code>ppc</code>
|Архитектура установщика OneAgent.
|-
|<code>oneagent_version</code>
|<code>latest</code>
|Требуемая версия OneAgent в формате 1.199.247.20200714-111723.
|-
|<code>oneagent_download_dir</code>
|Linux/AIX: <code>$TEMP</code> or <code>/tmp</code>
Windows: <code>%TEMP%</code> or <code>C:\Windows\Temp</code>
|Каталог загрузки установщика. Для Linux и AIX каталог не должен содержать пробелов.
|-
|<code>oneagent_install_args</code>
|unset
|Параметры установки Dynatrace OneAgent, определенные в виде списка элементов.
|-
|<code>oneagent_platform_install_args</code>
|unset
|Дополнительный список параметров установки для конкретной платформы, добавленный к `oneagent_install_args' при запуске на соответствующей платформе.
|-
|<code>oneagent_preserve_installer</code>
|<code>false</code>
|Возможность сохранить установщик на управляемом узле после установки OneAgent.
|-
|<code>oneagent_package_state</code>
|<code>present</code>
|Требуемое состояние пакета OneAgent. Укажите <code>текущую</code> или <code>последнюю</code> версию для установки. Укажите <code>отсутствует</code> для удаления.
|-
|<code>oneagent_reboot_host</code>
|<code>false</code>
|Возможность перезагрузки управляемого узла после установки OneAgent.
|-
|<code>oneagent_validate_certs</code>
|<code>true</code>
|Возможность требовать сертификаты. Если установлено значение false, позволяет загружать OneAgent с сервера с небезопасным SSL-сертификатом (истекшим сроком действия, самоподписанным и т. д.).
|-
|<code>oneagent_reboot_timeout</code>
|3600
|Время ожидания в секундах для перезагрузки управляемого узла.
|}

== Логирование ==
Вместо вывода на STDOUT журналы, созданные Ansible, могут быть собраны в один файл, расположенный на управляемом узле. Есть несколько способов добиться этого с помощью настройки конфигурации Ansible:

* Задайте для переменной среды <code>ANSIBLE_LOG_PATH</code> путь к файлу журнала.
* Укажите переменную <code>log_path</code> в разделе <code>[default]</code> файла настроек конфигурации Ansible.

Подробностью журналов можно управлять с помощью параметра командной строки <code>-v</code>. Многократное повторение параметра увеличивает уровень детализации до уровня отладки соединения, что достигается с помощью <code>-vvvv</code>.

== Примеры ==
Следующий пример playbook:

* Загружает установщик OneAgent определенной версии (<code>oneagent_version</code>) и сохраняет его в пользовательском каталоге (<code>oneagent_download_dir</code>).
* Использует переменную <code>vars_files</code> для указания на безопасный файл учетных  <code>credentials.yml</code>, в котором хранятся ваш идентификатор среды и токен PaaS.
* Указывает сценарию развернуть OneAgent в группах хостов с именами <code>linux_other</code> и <code>linux_arm</code> в вашем инвентаре.
* Указывает сценарию использовать <code>x86</code> в качестве архитектуры по умолчанию для группы хостов <code>linux_other</code>. Группа хостов linux_arm имеет собственный параметр <code>oneagent_installer_arch</code>, указанный в файле инвентаризации.
* Использует переменную <code>oneagent_install_args</code> для указания параметров установки OneAgent, которые назначают хосты группе хостов <code>My.HostGroup_123-456</code> и сетевой зоне <code>my.network.zone</code>.
* Задает другой параметр <code>USER</code>, используя параметр <code>oneagent_platform_install_args</code> для каждой группы хостов в инвентаризации.

 ---
 - name: Download OneAgent installer in specific version to a custom
     directory with additional OneAgent install parameters. Both linux_other
     and linux_arm have different user specified by platform args parameter.
   hosts: linux_other,linux_arm
   collections:
     - dynatrace.oneagent
   vars_files:
     - encrypted_credentials.yml
   vars:
     oneagent_download_dir: /home/user1
     oneagent_version: 1.199.247.20200714-111723
     oneagent_install_args:
       - INSTALL_PATH=/opt/example
       - --set-host-group=My.HostGroup_123-456
       - --set-network-zone=my.network.zone
   tasks:
     - import_role:
         name: oneagent
Вы можете найти больше примеров плейбуков и файлов инвентаризации в каталоге примеров в роли Ansible. В каталоге находятся следующие плейбуки:

* <code>local_installer.yml</code> — установка ЕдиногоАгента с помощью локальной программы установки.
* <code>advanced_config.yml</code> — установка ЕдиногоАгента с пользовательским путем установки и каталогом загрузки.
* <code>oneagentctl_config.yml</code> — конфигурация ЕдиногоАгента с помощью команды <code>oneagentctl</code>.

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

Чтобы узнать о проблемах с путями при установке в Windows, ознакомьтесь с разделом «Форматирование пути для Windows» в документации Ansible.