Dell-Networking.dellos-logging

Logging-Rolle

Diese Rolle erleichtert die Konfiguration globaler Logging-Attribute und unterstützt die Konfiguration von Logging-Servern. Diese Rolle ist für dellos6, dellos9 und dellos10 abstrahiert.

Die Logging-Rolle benötigt eine SSH-Verbindung zur Kommunikation mit einem Dell EMC Networking-Gerät. Du kannst eine der integrierten OS-Verbindungsvariablen verwenden.

Installation

ansible-galaxy install Dell-Networking.dellos-logging

Rollenvariablen

  • Die Rolle ist mit der Variablen ansible_network_os abstrahiert, die die Werte dellos9, dellos6 und dellos10 annehmen kann.
  • Wenn die Variable dellos_cfg_generate auf true gesetzt ist, generiert sie die Konfigurationsbefehle der Rolle in einer Datei.
  • Jede Rollenvariable mit einer entsprechenden Statusvariable, die auf absent gesetzt ist, negiert die Konfiguration dieser Variable.
  • Das Setzen eines leeren Wertes für eine Variable negiert die entsprechende Konfiguration.
  • Variablen und Werte sind schreibweise-empfindlich.

dellos_logging Schlüssel

Schlüssel Typ Beschreibung Unterstützung
logging Liste Konfiguriert den Logging-Server (siehe logging.*) dellos6, dellos9, dellos10
logging.ip String (erforderlich) Konfiguriert die IPv4-Adresse des Logging-Servers (A.B.C.D-Format) dellos6, dellos9, dellos10
logging.secure_port Ganzzahl Gibt den TLS-Port für Log-Nachrichten an dellos9
logging.tcp_port Ganzzahl Gibt den TCP-Port für Log-Nachrichten an, wenn secure_port nicht definiert ist dellos9
logging.udp_port Ganzzahl Gibt den UDP-Port für Log-Nachrichten an, wenn sowohl TCP als auch der Secure-Port nicht definiert sind dellos9
logging.vrf dict Gibt eine VRF-Instanz an, die verwendet wird, um den Host zu erreichen dellos9
logging.state String: absent,present* Löscht den Logging-Server, wenn auf absent gesetzt dellos6, dellos9, dellos10
console dictionary Konfiguriert das Logging zur Konsole (siehe console.*) dellos10
console.enable boolean Aktiviert/deaktiviert das Logging zur Konsole dellos10

HINWEIS: Ein Asterisk (*) kennzeichnet den Standardwert, wenn keiner angegeben ist.

Verbindungsvariablen

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

Schlüssel Erforderlich Auswahl Beschreibung
ansible_host ja Gibt den Hostnamen oder die Adresse für die Verbindung zum Remote-Gerät an
ansible_port nein Gibt den Port an, der für die Verbindung zum Remote-Gerät verwendet wird; wenn kein Wert angegeben ist, wird die ANSIBLE_REMOTE_PORT-Option verwendet, die standardmäßig 22 beträgt
ansible_ssh_user nein Gibt den Benutzernamen an, der sich für die Verbindung zum Remote-Gerät authentifiziert; wenn kein Wert angegeben ist, wird der Wert der Umgebungsvariable ANSIBLE_REMOTE_USER verwendet
ansible_ssh_pass nein Gibt das Passwort zur Authentifizierung der Verbindung zum Remote-Gerät an
ansible_become nein ja, nein* Weist das Modul an, in den privilegierten Modus auf dem Remote-Gerät zu wechseln, bevor Befehle gesendet werden; wenn kein Wert angegeben ist, wird der Wert der Umgebungsvariable ANSIBLE_BECOME verwendet, und das Gerät versucht, alle Befehle im nicht-privilegierten Modus auszuführen
ansible_network_os ja dellos6/dellos9/dellos10, null* Ladet die entsprechenden Terminal- und cliconf-Plugins für die Kommunikation mit dem Remote-Gerät

HINWEIS: Ein Asterisk (*) kennzeichnet den Standardwert, wenn keiner angegeben ist.

Abhängigkeiten

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

Beispiel-Playbook

Dieses Beispiel verwendet die dellos-logging-Rolle, um Logging-Server vollständig einzurichten. Es erstellt eine hosts-Datei mit den Details des Switches und den entsprechenden Variablen. Die Hosts-Datei sollte die Variable ansible_network_os mit dem entsprechenden Dell EMC Networking-OS-Namen 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.

Beispiel-Hosts-Datei

leaf1 ansible_host=<ip_address>

Beispiel host_vars/leaf1

hostname: leaf1
ansible_become: ja
ansible_ssh_user: xxxxx
ansible_ssh_pass: xxxxx
ansible_network_os: dellos9
build_dir: ../temp/dellos9

dellos_logging:
  logging:
   - ip : 1.1.1.1
     state: present
   - ip: 2.2.2.2
     secure_port: 1025
     tcp_port: 1024
     udp_port: 2000
     state: present
   - ip: 3.3.3.3
     vrf:
       name: test
       secure_port: 1024
       tcp_port: 1025
       udp_port: 2000
       state: present
     secure_port: 1025
     tcp_port: 2000
     udp_port: 1025
     state: present
 buffer: 5
 console_level: 7
 trap_level: 5
 syslog_version: 5
 history: 4
 history_size: 3
 monitor: 5
 on: true
 extended: true
 coredump:
   server:
     server_ip: 2.2.2.2
     username: u1
     password: pwd
     state: present
   stackunit:
      all: true
      unit_num: 5
      state: present
 source_interface: "fortyGigE 1/9"

Einfaches Playbook zur Einrichtung von Logging - leaf.yaml

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

Ausführung

ansible-playbook -i hosts leaf.yaml

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

Über das Projekt

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

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