Dell-Networking.dellos-system

Systemrolle

Diese Rolle ermöglicht die Konfiguration globaler Systemattribute und ist abstrahiert für dellos6, dellos9 und dellos10. Sie erlaubt speziell die Konfiguration des Hostnamens und des Enable-Passworts für alle drei dellos-Versionen. Zudem unterstützt dellos9 die Konfiguration der Managementroute, des Hash-Algorithmus, der Uhrzeit, der Terminalzeile, des Banners und des Neuladetyps.

Die dellos-system Rolle benötigt eine SSH-Verbindung, um eine Verbindung zu einem Dell EMC Networking-Gerät herzustellen. Du kannst eine der integrierten OS-Verbindungsvariablen verwenden.

Installation

ansible-galaxy install Dell-Networking.dellos-system

Rollenvariablen

  • Die Rolle wird mit der Variable ansible_network_os abstrahiert, die die Werte dellos9, dellos6 und dellos10 annehmen kann.
  • Wenn dellos_cfg_generate auf true gesetzt ist, generiert die Variable die Konfigurationsbefehle in einer Datei.
  • Jede Rollenvariable mit einem entsprechenden Status auf "absent" hebt die Konfiguration dieser Variable auf.
  • Ein leeres Wert für eine Variable hebt die entsprechende Konfiguration auf.
  • Variablen und Werte sind groß- und kleinschreibungsempfindlich.

dellos_system Schlüssel

Schlüssel Typ Beschreibung Unterstützung
hostname Zeichenkette Konfiguriert einen Hostnamen für das Gerät (kein Negationsbefehl) dellos9, dellos6, dellos10
unique_hostname boolean: true,false Konfiguriert einen eindeutigen Hostnamen im Switch dellos9
enable_password Zeichenkette Konfiguriert das Enable-Passwort dellos6, dellos9
mtu ganze Zahl Konfiguriert die maximale Übertragungseinheit (MTU) für alle Schnittstellen dellos6
hardware_forwarding Zeichenkette: scaled-l2, scaled-l3-routes, scaled-l3-hosts Konfiguriert den Hardware-Weiterleitungsmodus dellos10
management_rt Liste Konfiguriert die Managementroute dellos9
management_rt.ip Zeichenkette (erforderlich) Konfiguriert die IP-Zieladresse für die Managementroute (A.B.C.D-Format für IPv4, A:B:C:D::E-Format für IPv6) dellos9
management_rt.ipv4 boolean: true*,false Gibt an, ob die Managementroute eine IPv4- oder IPv6-Adresse ist; wenn false oder undefiniert, wird die IP als IPv6 gesetzt dellos9
management_rt.state Zeichenkette: absent,present* Löscht die Managementroute, wenn auf absent gesetzt dellos9
... ... ... ...

HINWEIS: Ein Sternchen (*) weist auf den Standardwert hin, wenn nichts angegeben ist.

Verbindungsvariablen


Die Ansible Dell EMC Networking Rollen erfordern Verbindungsinformationen, um die Kommunikation mit den Knoten in deinem Inventar herzustellen. Diese Informationen können in den Ansible group_vars oder host_vars Verzeichnissen, im Inventar oder im Playbook selbst vorhanden sein.

Schlüssel Erforderlich Auswahl Beschreibung
ansible_host ja Gibt den Hostnamen oder die Adresse für die Verbindung zum entfernten Gerät über den angegebenen Transport an
ansible_port nein Gibt den Port an, der verwendet wird, um die Verbindung zum entfernten Gerät herzustellen; wenn der Wert nicht angegeben ist, wird die Option ANSIBLE_REMOTE_PORT verwendet, die standardmäßig auf 22 eingestellt ist
ansible_ssh_user nein Gibt den Benutzernamen an, der für die Authentifizierung beim CLI-Login an das entfernte Gerät benötigt wird; wenn kein Wert angegeben ist, wird der Wert der Umgebungsvariablen ANSIBLE_REMOTE_USER verwendet
ansible_ssh_pass nein Gibt das Passwort an, das für die Authentifizierung der Verbindung zum entfernten Gerät benötigt wird
ansible_become nein ja, nein* Weist das Modul an, den privilegierten Modus auf dem entfernten Gerät vor dem Senden von Befehlen zu betreten; wenn der Wert nicht angegeben ist, wird der Wert der Umgebungsvariablen ANSIBLE_BECOME verwendet, und das Gerät versucht, alle Befehle im nicht-privilegierten Modus auszuführen
ansible_become_method nein enable, sudo* Weist das Modul an, das Erhöhungsverfahren für den privilegierten Zugang anzugeben; wenn der Wert nicht angegeben ist, wird der Wert der Umgebungsvariablen ANSIBLE_BECOME_METHOD verwendet
ansible_become_pass nein Gibt das Passwort an, das verwendet wird, um in den privilegierten Modus auf dem entfernten Gerät einzutreten; wenn ansible_become auf nein gesetzt ist, ist dieser Schlüssel nicht anwendbar
ansible_network_os ja dellos6/dellos9/dellos10, null* Lädt die entsprechenden Terminal- und cliconf-Plugins, um mit dem entfernten Gerät zu kommunizieren

HINWEIS: Ein Sternchen (*) weist auf den Standardwert hin, wenn nichts angegeben ist.

Abhängigkeiten

Die dellos-system Rolle basiert auf Modulen, die im Kern des Ansible-Codes enthalten sind. Diese Module wurden in der Ansible-Version 2.2.0 hinzugefügt.

Beispiel-Playbook

Dieses Beispiel verwendet die dellos-system Rolle, um den NTP-Server, den Hostnamen, das Enable-Passwort, die Managementroute, den Hash-Algorithmus, die Uhrzeit, die Terminalzeile, das Banner und den Neuladetyp vollständig einzurichten. Es erstellt eine hosts Datei mit den Schalterdetails und den entsprechenden Variablen. Die hosts-Datei sollte die Variable ansible_network_os mit dem entsprechenden Namen des Dell EMC Networking-OS definieren.

Wenn dellos_cfg_generate auf true gesetzt ist, generiert die Variable die Konfigurationsbefehle als .part-Datei im build_dir-Pfad. Standardmäßig ist die Variable auf false gesetzt. Die Systemrolle schreibt ein einfaches Playbook, das nur die dellos-system Rolle referenziert. Durch das Einschließen der Rolle erhältst du automatisch Zugriff auf alle Aufgaben zur Konfiguration von Systemfeatures.

Beispiel hosts-Datei

leaf1 ansible_host= <ip_address> 

Beispiel host_vars/leaf1

hostname: leaf1
ansible_become: ja
ansible_become_method: xxxxx
ansible_become_pass: xxxxx
ansible_ssh_user: xxxxx
ansible_ssh_pass: xxxxx
ansible_network_os: dellos9
build_dir: ../temp/dellos9
  
dellos_system:
  hostname: host1
  unique_hostname: True
  enable_password: dell
  service_passwd_encryption: true
  banner:
    exec: t hai t
    login:
      ack_enable: true
      ack_prompt: testbanner
      keyboard_interactive: true
      banner_text: cloginbannerc
    motd: t ansibletest t
  hash_algo:
    algo:
      - name: lag
        mode: xor1
        stack_unit: 0
        port_set: 0
        state: present
      - name: ecmp
        mode: xor1
        stack_unit: 0
        port_set: 0
        state: present
    seed:
      - value: 3
        stack_unit: 0
        port_set: 0
        state: present
      - value: 2
        state: present
  load_balance:
    ingress_port: true
    ip_selection: 
       - field: vlan dest-ip
         state: present
    ipv6_selection: 
       - field: dest-ipv6 vlan
         state: present
    tunnel:
      hash_field:
        - name: mac-in-mac
          header: tunnel-header-mac
          state: present
  clock:
    summer_time:
      timezone_name: PST
      type: date
      start_datetime: 2 jan 1993 22:33
      end_datetime: 3 jan 2017 22:33
      offset_mins: 20
    timezone:
      name: IST
      offset_hours: -5
      offset_mins: 20
  reload_type:
    auto_save: true
    boot_type: normal-reload
    boot_type_state: absent
    config_scr_download: true
    dhcp_timeout: 5
    retry_count: 3
    relay: true
    relay_remote_id: ho
    vendor_class_identifier: aa
  management_rt:
    - ip: 10.16.148.254
      state: present
      ipv4: True
  line_terminal:
    vty 0:
      exec_timeout: 40
      exec_banner: true
    vty 1:
      exec_timeout: 40 200
      motd_banner: true

Einfaches Playbook zur Systemeinrichtung - leaf.yaml

- hosts: leaf1
  roles:
     - Dell-Networking.dellos-system

Ausführen

ansible-playbook -i hosts leaf.yaml

(c) 2017 Dell Inc. oder dessen Tochtergesellschaften. Alle Rechte vorbehalten.

Über das Projekt

The dellos-system role facilitates the configuration of system attributes in devices running Dell EMC Networking Operating Systems.

Installieren
ansible-galaxy install Dell-Networking.dellos-system
GitHub Repository
Lizenz
apache-2.0
Downloads
68.9k