Администрирование (Linux) > Расширенная установка > Развертывание системы с помощью Ansible

Для управления узлами используется плейбук (playbook) – файл со списком задач, которые нужно выполнить. Задачи определены в разделе roles (роли). Подробнее о плейбуках и ролях см. в документации Ansible статьи Working with playbooks и Roles.

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

•dl_role – установка или обновление инструмента Directum Launcher;

•component_role – установка или обновление компонентов, например Platform.

В разделе рассмотрена установка распределенной системы с помощью двух плейбуков. При запуске первого плейбука развертываются сервисы системы Directum RX, при запуске второго – публикуется прикладная разработка. Чтобы развернуть другие компоненты, например Redist.zip или DockerImages.tar.gz, отредактируйте плейбук или создайте новый.

После завершения установки конфигурационные файлы автоматически копируются с управляемых узлов обратно на управляющий. При этом на управляющем узле создаются резервные копии исходных конфигурационных файлов. По умолчанию они сохраняются в папке <Папка с Directum Launcher>/etc. Если нужно указать другой путь, то измените значение переменной config_backup_path в соответствующем конфигурационном файле.

Развертывание сервисов

Чтобы установить сервисы на управляемых узлах:

1.В папке DirectumLauncher/etc/ansible копированием файла dl_playbook.yml.example создайте плейбук в формате YAML, например install_playbook.yml.

2.Укажите значения переменных:

Переменная	Описание
dl_archive_path_win	Путь, по которому хранится архив с Directum Launcher на управляющем узле. Переменная задается для управляемого узла на Microsoft Windows
dl_archive_path_linux	Путь, по которому хранится архив с Directum Launcher на управляющем узле. Переменная задается для управляемого узла на Linux
component_name	Имя компонента для развертывания
component_copy_from_control_node	Признак необходимости копирования компонента с управляющего сервера. Возможные значения: True – скопировать компонент, False – не копировать компонент. Значение по умолчанию True
component_archive_path_win	Путь, по которому хранится архив компонента на управляющем узле. Переменная задается для управляемого узла на Microsoft Windows. Если путь не задан, то используется значение по умолчанию {{ role_path }}/../../../../{{ component_name }}.zip ПРИМЕЧАНИЕ. Имя архива компонента может отличаться от имени компонента, указанного в переменной component_name. В этом случае в переменной component_archive_path_win укажите путь до архива, например /home/user/DirectumLauncher/<Имя архива компонента>.zip
component_archive_path_linux	Путь, по которому хранится архив компонента на управляющем узле. Переменная задается для управляемого узла на Linux. Если путь не задан, то используется значение по умолчанию {{ role_path }}/../../../../{{ component_name }}.tar.gz ПРИМЕЧАНИЕ. Имя архива компонента может отличаться от имени компонента, указанного в переменной component_name. В этом случае в переменной component_archive_path_linux укажите путь до архива, например /home/user/DirectumLauncher/<Имя архива компонента>.tar.gz
component_add_args	Аргументы, которые нужно передать при добавлении компонентов. Например, --force_add принудительно добавит компонент, даже если его актуальная версия уже добавлена. Используется при устранении неисправностей
component_install_args	Аргументы, которые нужно передать при установке компонентов. Например, --force_install принудительно установит компонент, даже если его актуальная версия уже установлена. Используется при устранении неисправностей
component_settings_for_copy	Настройки из config.yml, которые нужно скопировать на управляемые узлы. Указываются в виде списка. Например, переменную можно использовать, чтобы скопировать на управляемые узлы SSL-сертификат для работы по протоколу HTTPS. В этом случае на управляющемм узле ищется сертификат, путь до которого указан в конфигурационном файле в параметре ssl_cert. По аналогичной настройке на управляемом узле определяется путь, куда нужно скопировать сертификат. После этого сертификат копируется с управляющего узла на управляемый по определенным ранее путям
component_post_install_cmd	Выполнить дополнительные действия после установки компонента. Добавьте переменную, например, если после установки нужно перезапустить веб-клиент и сервис предпросмотра. Для этого в списке значений укажите команду webclient up и previewservice up. Пример: component_post_install_cmd: ['webclient up', 'previewservice up']

Пример плейбука

---
- name: Install or Update DL
  hosts: all
  roles:
    - role: dl_role
      vars:
        dl_archive_path_win: "{{ role_path }}/../../../../DirectumLauncher.zip"
        dl_archive_path_linux: "{{ role_path }}/../../../../DirectumLauncher.tar.gz"
    - role: component_role
      vars:
        component_name: "Platform"
        component_archive_path_win: "{{ role_path }}/../../../../{{ component_name }}.zip"
        component_archive_path_linux: "{{ role_path }}/../../../../{{ component_name }}.tar.gz"
        component_settings_for_copy:
          - DATA_PROTECTION_CERTIFICATE_FILE

3.Запустите плейбук. Для этого выполните команду:

./do.sh ansible-playbook DirectumLauncher/etc/ansible/install_playbook.yml

В результате на управляемых узлах:

•архив с Directum Launcher распакуется в папки, указанные в переменной home_dl в файле hosts.yml;

•скопируются конфигурационные файлы;

•добавятся и установятся архивы с указанными компонентами.

Публикация прикладной разработки

Чтобы опубликовать прикладную разработку на выбранном узле:

1.Проверьте, что в папку с Directum Launcher скопированы компоненты прикладной разработки DirectumRX.zip и DirectumRX.tar.gz.

2.В папке DirectumLauncher/etc/ansible копированием файла dl_playbook.yml.example создайте плейбук в формате YAML, например installrx_playbook.yml.

3.В переменной hosts укажите управляемый узел из inventory-файла hosts.yml, где нужно опубликовать прикладную разработку. При этом инструмент Directum Launcher и компоненты платформы на этом узле уже должны быть развернуты.

4.Удалите роль dl_role.

5.В роли component_role в переменной component_name укажите значение DirectumRX. Удалите переменные component_add_args, component_install_args, component_settings_for_copy.

Пример плейбука

---
- name: Install or Update DL
  hosts: linux_host_1
  roles:
    - role: component_role
      vars:
        component_name: "DirectumRX"
        component_archive_path_linux: "{{ role_path }}/../../../../{{ component_name }}.tar.gz"

6.Запустите плейбук. Для этого выполните команду:

./do.sh ansible-playbook DirectumLauncher/etc/ansible/installrx_playbook.yml

В результате архив с прикладной разработкой Directum RX опубликуется на управляемый сервер.

Развертывание системы с помощью плейбука

Развертывание системы с помощью плейбука