omada_install

Ansible Роль: omada_install

Установка контроллера Omada SDN на RedHat/CentOS и Debian/Ubuntu.

Эта роль устанавливает последнюю версию программного обеспечения контроллера Omada SDN, используя последнюю версию файла tar с сайта https://www.tp-link.com/us/support/download/omada-software-controller/.

Если вы хотите вручную загрузить файл tar на ваш управляющий хост Ansible, загрузите файл Omada_SDN_Controller_v5.*.*_Linux_x64.tar.gz в вашу директорию files и установите следующие две переменные в вашем плейбуке:

omada_tar_src: Omada_SDN_Controller_v5.*.*_Linux_x64.tar.gz
omada_tar_src_remote: false

Смотрите раздел «Примеры плейбуков» для рабочий примеров. Эта роль не настраивает контроллер Omada, она использует значения конфигурации по умолчанию. Также она запускает сервис от имени пользователя, не обладающего правами root. Вы можете изменить это, установив omada_non_root: false.

Установка роли

Вы можете установить эту роль с помощью CLI Ansible Galaxy:

ansible-galaxy role install trfore.omada_install

Испытанные платформы и версии

MongoDB Community: 4.4.x
Omada SDN: 5.x.x
CentOS Stream 8
Debian 10
Ubuntu 20.04

Требования

MongoDB Community Edition, mongodb-org >=4.4.0, существует роль для его установки через менеджер пакетов - trfore.mongodb_install.
Apache Commons Daemon, jsvc >= 1.1.0, существует роль для установки последней версии - trfore.jsvc.
Вы можете установить эти роли, создав файл requirements.yml и выполнив ansible-galaxy install -r requirements.yml.
```
# requirements.yml
---
roles:
  - name: trfore.jsvc
  - name: trfore.mongodb_install
  - name: trfore.omada_install
```
ЗАМЕТКА: Для целей Ubuntu 20.04 эта роль устанавливает OpenJDK 11. Хотя jsvc доступен через APT, его версия < 1.1.0, и он работает только с OpenJDK 8. Если вы предпочитаете использовать эту более старую версию, установите omada_dependencies в вашем плейбуке следующим образом (см. раздел «Примеры плейбуков» ниже):
```
omada_dependencies: ["curl", "openjdk-8-jre-headless", "jsvc"]
```

Переменные роли

Доступные переменные перечислены ниже, с настройками по умолчанию (см. defaults/main.yml):

Переменная	По умолчанию	Описание	Обязательно
omada_tar_src	URL	Файл tar Omada SDN, URL или относительный путь	Нет
omada_tar_src_remote	`true`	Логическое значение, `true`, если загружается с URL	Нет
omada_tar_dir	`/var/tmp`	Временная директория на целевом хосте для распаковки и установки Omada SDN	Нет
omada_tar_folder	Автоматически	Определяется из переменной `omada_tar_src`	Автоматически
omada_non_root	`true`	Логическое значение, настраивает Omada SDN для запуска от имени неполномочного пользователя	Нет
omada_remove_tar_folder	`false`	Логическое значение, удаляет временную директорию на удаленном хосте	Нет

Переменные, специфичные для ОС, перечислены ниже с значениями по умолчанию (см. vars/main.yml):

Переменная	По умолчанию	Описание	Обязательно
omada_dependencies	`["curl", "openjdk-11-jre-headless"]`	Необходимые пакеты для Omada SDN (Debian)	Нет
omada_dependencies	`["curl", "java-11-openjdk-headless.x86_64"]`	Необходимые пакеты для Omada SDN (RHEL)	Нет

Зависимости

Apache Commons Daemon, jsvc >= 1.1.0
MongoDB Community Edition mongodb-org >=4.4.0

Примеры плейбуков

- hosts: servers
  become: true
  roles:
    - name: Установка MongoDB Community
      role: trfore.mongodb_install

    - name: Установка бинарного файла jsvc
      role: trfore.jsvc

    - name: Установка Omada SDN
      role: trfore.omada_install

  post_tasks:
    - name: Проверка, что Omada SDN работает
      tags: ["omada", "test"]
      ansible.builtin.uri:
        url: https://127.0.0.1:8043/login
        status_code: 200
        validate_certs: false
      register: result
      until: result.status == 200
      retries: 12
      delay: 10

Если вы вручную скачали файл tar.

- hosts: servers
  become: true
  vars:
    omada_tar_src: Omada_SDN_Controller_v5.*.*_Linux_x64.tar.gz
    omada_tar_src_remote: false
  roles:
    - name: Установка MongoDB Community
      role: trfore.mongodb_install

    - name: Установка бинарного файла jsvc
      role: trfore.jsvc

    - name: Установка Omada SDN
      role: trfore.omada_install

Если вы хотите установить OpenJDK JRE 8 и jsvc с помощью APT (только для Ubuntu 20.04)

- hosts: servers
  become: true
  vars:
    omada_dependencies: ["curl", "openjdk-8-jre-headless", "jsvc"]
  roles:
    - name: Установка MongoDB Community
      role: trfore.mongodb_install

    - name: Установка Omada SDN
      role: trfore.omada_install
      when: ansible_distribution == 'Ubuntu'