Dell-Networking.dellos-logging
Rola logowania
Ta rola ułatwia konfigurację globalnych atrybutów logowania i wspiera konfigurację serwerów logowania. Jest abstrakcyjna dla dellos6, dellos9 i dellos10.
Rola logowania wymaga połączenia SSH do urządzenia sieciowego Dell EMC. Możesz użyć dowolnej z wbudowanych zmiennych połączenia systemu operacyjnego.
Instalacja
ansible-galaxy install Dell-Networking.dellos-logging
Zmienne roli
- Rola jest abstrakcyjna przy użyciu zmiennej ansible_network_os, która może przyjmować wartości dellos9, dellos6 i dellos10.
- Jeśli zmienna dellos_cfg_generate jest ustawiona na true, generuje polecenia konfiguracyjne roli w pliku.
- Każda zmienna roli, której odpowiadająca zmienna stanu jest ustawiona na absent, neguje konfigurację tej zmiennej.
- Ustawienie pustej wartości dla dowolnej zmiennej neguje odpowiadającą konfigurację.
- Zmienne i wartości są wrażliwe na wielkość liter.
Klucze dellos_logging
Klucz | Typ | Opis | Wsparcie |
---|---|---|---|
logging |
lista | Konfiguruje serwer logowania (zobacz logging.* ) |
dellos6, dellos9, dellos10 |
logging.ip |
string (wymagany) | Konfiguruje adres IPv4 dla serwera logowania (format A.B.C.D) | dellos6, dellos9, dellos10 |
logging.secure_port |
całkowita liczba | Określa logi wiadomości przez port TLS | dellos9 |
logging.tcp_port |
całkowita liczba | Określa logi wiadomości przez port TCP, jeśli secure_port nie jest zdefiniowany | dellos9 |
logging.udp_port |
całkowita liczba | Określa logi wiadomości przez port UDP, jeśli zarówno TCP, jak i port zabezpieczony nie są zdefiniowane | dellos9 |
logging.vrf |
słownik | Określa instancję VRF do użycia w celu dotarcia do hosta | dellos9 |
logging.vrf.name |
string | Określa nazwę VRF | dellos9 |
logging.vrf.secure_port |
całkowita liczba | Określa logi wiadomości przez port TLS | dellos9 |
logging.vrf.tcp_port |
całkowita liczba | Określa logi wiadomości przez port TCP, jeśli secure_port nie jest zdefiniowany | dellos9 |
logging.vrf.udp_port |
całkowita liczba | Określa logi wiadomości przez port UDP, jeśli zarówno TCP, jak i secure_port nie są zdefiniowane | dellos9 |
logging.vrf.state |
string: absent,present* | Usuwa instancję VRF serwera logowania, jeśli ustawiona na absent | dellos9 |
logging.state |
string: absent,present* | Usuwa serwer logowania, jeśli ustawiona na absent | dellos6, dellos9, dellos10 |
console |
słownik | Konfiguruje logowanie do konsoli (zobacz console.* ) |
dellos10 |
console.enable |
boolean | Włącza/wyłącza logowanie do konsoli | dellos10 |
console.severity |
string | Konfiguruje minimalny poziom ciężkości dla logowania do konsoli | dellos10 |
log_file |
słownik | Konfiguruje logowanie do pliku logów (zobacz log_file.* ) |
dellos10 |
log_file.enable |
boolean | Włącza/wyłącza logowanie do pliku logów | dellos10 |
log_file.severity |
string | Konfiguruje minimalny poziom ciężkości dla logowania do pliku logów | dellos10 |
buffer |
całkowita liczba | Określa poziom ciężkości logowania buforowanego (od 0 do 7) | dellos9 |
console_level |
całkowita liczba | Konfiguruje poziom logowania do konsoli (od 0 do 7) | dellos9 |
trap_level |
całkowita liczba | Konfiguruje poziom ciężkości serwera syslog (od 0 do 7) | dellos9 |
syslog_version |
całkowita liczba | Konfiguruje wersję syslog (0/1) | dellos9 |
monitor |
całkowita liczba | Konfiguruje poziom logowania linii terminala (od 0 do 7) | dellos9 |
history |
całkowita liczba | Konfiguruje tabelę historii syslog (od 0 do 7) | dellos9 |
history_size |
całkowita liczba | Określa rozmiar tabeli historii | dellos9 |
on |
boolean | Włącza logowanie do wszystkich wspieranych miejsc, jeśli ustawione na true | dellos9 |
extended |
boolean | Włącza rozszerzone logowanie, jeśli ustawione na true | dellos9 |
coredump |
słownik | Konfiguruje logowanie zrzutów pamięci | dellos9 |
coredump.server |
słownik | Określa wszystkie szczegóły serwera | dellos9 |
coredump.server.server_ip |
string (wymagany) | Określa adres IPv4/IPv6 serwera logowania | dellos9 |
coredump.server.username |
string | Określa nazwę użytkownika do skonfigurowania | dellos9 |
coredump.server.password |
string | Określa hasło do skonfigurowania | dellos9 |
coredump.server.state |
string: present,absent* | Usuwa serwer zrzutów pamięci, jeśli ustawione na absent | dellos9 |
coredump.stackunit |
słownik | Określa szczegóły w celu włączenia zrzutu pamięci na jednostce stosu | dellos9 |
coredump.stackunit.all |
boolean | Włącza zrzut pamięci na wszystkich jednostkach stosu | dellos9 |
coredump.stackunit.unit_num |
całkowita liczba | Określa numer jednostki stosu (od 0 do 5) | dellos9 |
coredump.stackunit.state |
string: present,absent* | Usuwa zrzut jednostki stosu, jeśli ustawione na absent | dellos9 |
source_interface |
string | Konfiguruje interfejs źródłowy dla logowania | dellos6, dellos9, dellos10 |
UWAGA: Gwiazdka (*) oznacza wartość domyślną, jeśli żadna nie jest określona.
Zmienne połączenia
Role Ansible Dell EMC Networking wymagają informacji o połączeniu, aby nawiązać komunikację z węzłami w twoim inwentarzu. Informacje te mogą znajdować się w katalogach group_vars lub host_vars, w inwentarzu lub w samym pliku playbook.
Klucz | Wymagany | Wybory | Opis |
---|---|---|---|
ansible_host |
tak | Określa nazwę hosta lub adres do połączenia zdalnego urządzenia przez określony transport | |
ansible_port |
nie | Określa port używany do budowania połączenia zdalnego urządzenia; jeśli wartość nie jest określona, używana jest opcja ANSIBLE_REMOTE_PORT, domyślnie 22 | |
ansible_ssh_user |
nie | Określa nazwę użytkownika, która autoryzuje logowanie CLI do połączenia zdalnego urządzenia; jeśli wartość nie jest określona, używana jest wartość zmiennej środowiskowej ANSIBLE_REMOTE_USER | |
ansible_ssh_pass |
nie | Określa hasło, które autoryzuje połączenie zdalne z urządzeniem | |
ansible_become |
nie | tak, nie* | Należy do modułu, aby przejść w tryb uprzywilejowany na zdalnym urządzeniu przed wysłaniem jakichkolwiek poleceń; jeśli wartość nie jest określona, używana jest wartość zmiennej środowiskowej ANSIBLE_BECOME, a urządzenie próbuje wykonać wszystkie polecenia w trybie nieuprzywilejowanym |
ansible_become_method |
nie | enable, sudo* | Należy do modułu, aby pozwolić na określenie metody uzyskania uprawnień do obsługi podwyższenia uprawnień; jeśli wartość nie jest określona, używana jest wartość zmiennej środowiskowej ANSIBLE_BECOME_METHOD |
ansible_become_pass |
nie | Określa hasło do użycia, jeśli wymagane jest przejście do trybu uprzywilejowanego na zdalnym urządzeniu; jeśli ansible_become jest ustawione na nie, ten klucz nie ma zastosowania |
|
ansible_network_os |
tak | dellos6/dellos9/dellos10, null* | Ładowanie odpowiednich wtyczek terminala i cliconf do komunikacji zdalnego urządzenia |
UWAGA: Gwiazdka (*) oznacza wartość domyślną, jeśli żadna nie jest określona.
Zależności
Rola dellos-logging opiera się na modułach zawartych w podstawowym kodzie Ansible. Moduły te zostały dodane w wersji Ansible 2.2.0.
Przykładowy playbook
Ten przykład używa roli dellos-logging, aby całkowicie skonfigurować serwery logowania. Tworzy plik hosts z danymi przełącznika i odpowiadającymi im zmiennymi. Plik hosts powinien definiować zmienną ansible_network_os z odpowiadającą nazwą systemu operacyjnego sieci Dell EMC. Gdy dellos_cfg_generate jest ustawione na true, zmienna generuje polecenia konfiguracyjne jako plik .part w ścieżce build_dir. Domyślnie zmienna jest ustawiona na false.
Przykładowy plik hosts
leaf1 ansible_host=<adres_ip>
Przykładowy host_vars/leaf1
hostname: leaf1
ansible_become: tak
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_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"
Prosty playbook do skonfigurowania logowania - leaf.yaml
- hosts: leaf1
roles:
- Dell-Networking.dellos-logging
Uruchomienie
ansible-playbook -i hosts leaf.yaml
(c) 2017 Dell Inc. lub jej spółki zależne. Wszelkie prawa zastrzeżone.
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