trfore.omada_install

Rôle Ansible : omada_install

Installer le contrôleur SDN Omada sur RedHat/CentOS et Debian/Ubuntu.

Ce rôle installe le dernier logiciel du contrôleur SDN Omada en utilisant le dernier fichier tar disponible sur https://www.tp-link.com/us/support/download/omada-software-controller/.

Si vous souhaitez télécharger manuellement le fichier tar sur votre hôte de contrôle Ansible, téléchargez Omada_SDN_Controller_v5.*.*_Linux_x64.tar.gz dans votre répertoire files et définissez les deux variables suivantes dans votre playbook :

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

Voir la section 'Exemples de Playbooks' pour des exemples opérationnels. Ce rôle ne configure pas le contrôleur Omada, il utilise les valeurs de configuration par défaut. Il configure le service pour s'exécuter en tant qu'utilisateur non-root, vous pouvez changer cela en définissant omada_non_root: false.

Installer le Rôle

Vous pouvez installer ce rôle avec la ligne de commande Ansible Galaxy :

ansible-galaxy role install trfore.omada_install

Plateformes et Versions Testées

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

Exigences

Édition Communautaire de MongoDB, mongodb-org >=4.4.0, un rôle pour l'installer via un gestionnaire de paquets est disponible - trfore.mongodb_install.
Apache Commons Daemon, jsvc >= 1.1.0, un rôle pour installer la dernière version binaire est disponible - trfore.jsvc.

Vous pouvez installer ces rôles en créant un fichier requirements.yml et en exécutant ansible-galaxy install -r requirements.yml.

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

REMARQUE : Pour les cibles Ubuntu 20.04, ce rôle installe OpenJDK 11. Bien que jsvc soit disponible via APT, il est < 1.1.0 et ne fonctionnera qu'avec OpenJDK 8. Si vous préférez utiliser cette version plus ancienne, définissez omada_dependencies comme suit dans votre playbook (voir la section 'Exemples de Playbooks' ci-dessous) :
```
omada_dependencies: ["curl", "openjdk-8-jre-headless", "jsvc"]
```

Variables de Rôle

Les variables disponibles sont énumérées ci-dessous, avec leurs valeurs par défaut (voir defaults/main.yml):

Variable	Par défaut	Description	Requis
omada_tar_src	URL	Fichier tar Omada SDN, URL ou chemin relatif	Non
omada_tar_src_remote	`true`	Booléen, `true` si le téléchargement se fait depuis une URL	Non
omada_tar_dir	`/var/tmp`	Répertoire temporaire sur l'hôte cible pour extraire et installer Omada SDN	Non
omada_tar_folder	Automatique	Déterminé à partir de la variable `omada_tar_src`	Automatique
omada_non_root	`true`	Booléen, configure Omada SDN pour s'exécuter en tant qu'utilisateur non-root	Non
omada_remove_tar_folder	`false`	Booléen, supprime le répertoire temporaire sur l'hôte distant	Non

Les variables spécifiques au système d'exploitation sont énumérées ci-dessous, avec leurs valeurs par défaut (voir vars/main.yml):

Variable	Par défaut	Description	Requis
omada_dependencies	`["curl", "openjdk-11-jre-headless"]`	Paquet requis pour Omada SDN (Debian)	Non
omada_dependencies	`["curl", "java-11-openjdk-headless.x86_64"]`	Paquet requis pour Omada SDN (RHEL)	Non

Dépendances

Apache Commons Daemon, jsvc >= 1.1.0
Édition Communautaire de MongoDB mongodb-org >=4.4.0

Exemples de Playbooks

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

    - name: Installer le binaire jsvc
      role: trfore.jsvc

    - name: Installer Omada SDN
      role: trfore.omada_install

  post_tasks:
    - name: Tester si Omada SDN fonctionne
      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 vous téléchargez manuellement le fichier tar.

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

    - name: Installer le binaire jsvc
      role: trfore.jsvc

    - name: Installer Omada SDN
      role: trfore.omada_install

Si vous souhaitez installer OpenJDK JRE 8 et jsvc en utilisant APT (Uniquement Ubuntu 20.04)

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

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