trfore.omada_install

Descripción general Versiones Perspectivas

Rol de Ansible: omada_install

Instalar el controlador SDN de Omada en RedHat/CentOS y Debian/Ubuntu.

Este rol instala la última versión del software del controlador SDN de Omada usando el último archivo tar desde https://www.tp-link.com/us/support/download/omada-software-controller/.

Si deseas descargar el archivo tar manualmente en tu host de control de Ansible, descarga Omada_SDN_Controller_v5.*.*_Linux_x64.tar.gz en tu directorio files y establece las siguientes dos variables en tu playbook:

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

Consulta la sección 'Ejemplos de Playbooks' para ver ejemplos en funcionamiento. Este rol no configura el controlador de Omada, utiliza los valores de configuración predeterminados. Configura el servicio para que se ejecute como un usuario no root, puedes cambiar esto configurando omada_non_root: false.

Instalar el Rol

Puedes instalar este rol con el CLI de Ansible Galaxy:

ansible-galaxy role install trfore.omada_install

Plataformas y Versiones Probadas

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

Requisitos

MongoDB Community Edition, mongodb-org >=4.4.0, hay un rol para instalarlo a través de un gestor de paquetes - trfore.mongodb_install.
Apache Commons Daemon, jsvc >= 1.1.0, hay un rol para instalar el último binario - trfore.jsvc.

Puedes instalar estos roles creando un archivo requirements.yml y ejecutando ansible-galaxy install -r requirements.yml.

# requirements.yml
---
roles:
  - name: trfore.jsvc
  - name: trfore.mongodb_install
  - name: trfore.omada_install

NOTA: Para objetivos de Ubuntu 20.04, este rol instala OpenJDK 11. Aunque jsvc está disponible a través de APT, es < 1.1.0 y solo funcionará con OpenJDK 8. Si prefieres usar esta versión más antigua, configura omada_dependencies de la siguiente manera en tu playbook (consulta la sección 'Ejemplos de Playbooks' a continuación):
```
omada_dependencies: ["curl", "openjdk-8-jre-headless", "jsvc"]
```

Variables del Rol

Las variables disponibles se enumeran a continuación, junto con valores predeterminados (consulta defaults/main.yml):

Variable	Predeterminado	Descripción	Requerido
omada_tar_src	URL	Archivo tar de Omada SDN, URL o ruta relativa	No
omada_tar_src_remote	`true`	Booleano, `true` si se descarga desde una URL	No
omada_tar_dir	`/var/tmp`	Directorio temporal en el host objetivo para extraer e instalar Omada SDN	No
omada_tar_folder	Automático	Determinado a partir de la variable `omada_tar_src`	Automático
omada_non_root	`true`	Booleano, configura Omada SDN para ejecutarse como un usuario no root	No
omada_remove_tar_folder	`false`	Booleano, eliminar el directorio temporal en el host remoto	No

Las variables específicas del sistema operativo se enumeran a continuación, junto con valores predeterminados (consulta vars/main.yml):

Variable	Predeterminado	Descripción	Requerido
omada_dependencies	`["curl", "openjdk-11-jre-headless"]`	Paquetes requeridos para Omada SDN (Debian)	No
omada_dependencies	`["curl", "java-11-openjdk-headless.x86_64"]`	Paquetes requeridos para Omada SDN (RHEL)	No

Dependencias

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

Ejemplos de Playbooks

- hosts: servers
  become: true
  roles:
    - name: Instalar MongoDB Community
      role: trfore.mongodb_install

    - name: Instalar jsvc Binary
      role: trfore.jsvc

    - name: Instalar Omada SDN
      role: trfore.omada_install

  post_tasks:
    - name: Probar que Omada SDN está en ejecución
      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

Si descargas manualmente el archivo tar.

- hosts: servers
  become: true
  vars:
    omada_tar_src: Omada_SDN_Controller_v5.*.*_Linux_x64.tar.gz
    omada_tar_src_remote: false
  roles:
    - name: Instalar MongoDB Community
      role: trfore.mongodb_install

    - name: Instalar jsvc Binary
      role: trfore.jsvc

    - name: Instalar Omada SDN
      role: trfore.omada_install

Si deseas instalar OpenJDK JRE 8 y jsvc utilizando APT (solo Ubuntu 20.04)

- hosts: servers
  become: true
  vars:
    omada_dependencies: ["curl", "openjdk-8-jre-headless", "jsvc"]
  roles:
    - name: Instalar MongoDB Community
      role: trfore.mongodb_install

    - name: Instalar Omada SDN
      role: trfore.omada_install
      when: ansible_distribution == 'Ubuntu'