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.
The dellos-logging role facilitates the configuration of logging attributes in devices running Dell EMC Networking Operating Systems.
ansible-galaxy install Dell-Networking.dellos-logging