Dell-Networking.dellos-logging

Rôle de journalisation

Ce rôle facilite la configuration des attributs de journalisation globaux et prend en charge la configuration des serveurs de journalisation. Ce rôle est abstrait pour dellos6, dellos9 et dellos10.

Le rôle de journalisation nécessite une connexion SSH pour se connecter à un appareil de réseau Dell EMC. Vous pouvez utiliser n'importe laquelle des variables de connexion intégrées au système d'exploitation.

Installation

ansible-galaxy install Dell-Networking.dellos-logging

Variables du rôle

  • Le rôle est abstrait en utilisant la variable ansible_network_os qui peut prendre les valeurs dellos9, dellos6 et dellos10.
  • Si la variable dellos_cfg_generate est définie sur true, elle génère les commandes de configuration du rôle dans un fichier.
  • Toute variable de rôle avec une variable d'état correspondante définie sur absent annule la configuration de cette variable.
  • Définir une valeur vide pour une variable annule la configuration correspondante.
  • Les variables et valeurs sont sensibles à la casse.

Clés dellos_logging

Clé Type Description Support
logging liste Configure le serveur de journalisation (voir logging.*) dellos6, dellos9, dellos10
logging.ip chaîne (obligatoire) Configure l'adresse IPv4 pour le serveur de journalisation (format A.B.C.D) dellos6, dellos9, dellos10
logging.secure_port entier Spécifie les messages de journalisation sur le port TLS dellos9
logging.tcp_port entier Spécifie les messages de journalisation sur le port TCP si secure_port n'est pas défini dellos9
logging.udp_port entier Spécifie les messages de journalisation sur le port UDP si les ports TCP et secure n'ont pas été définis dellos9
logging.vrf dictionnaire Spécifie une instance VRF à utiliser pour atteindre l'hôte dellos9
logging.vrf.name chaîne Spécifie le nom de la VRF dellos9
logging.vrf.secure_port entier Spécifie les messages de journalisation sur le port TLS dellos9
logging.vrf.tcp_port entier Spécifie les messages de journalisation sur le port TCP si secure_port n'est pas défini dellos9
logging.vrf.udp_port entier Spécifie les messages de journalisation sur le port UDP si les ports TCP et secure_port ne sont pas définis dellos9
logging.vrf.state chaîne: absent, présent* Supprime l'instance VRF du serveur de journalisation si définie sur absent dellos9
logging.state chaîne: absent, présent* Supprime le serveur de journalisation si définie sur absent dellos6, dellos9, dellos10
console dictionnaire Configure la journalisation sur la console (voir console.*) dellos10
console.enable booléen Active/désactive la journalisation sur la console dellos10
console.severity chaîne Configure le niveau de gravité minimum pour la journalisation sur la console dellos10
log_file dictionnaire Configure la journalisation dans un fichier journal (voir log_file.*) dellos10
log_file.enable booléen Active/désactive la journalisation dans un fichier journal dellos10
log_file.severity chaîne Configure le niveau de gravité minimum pour la journalisation dans un fichier journal dellos10
buffer entier Spécifie le niveau de gravité de journalisation mis en mémoire (0 à 7) dellos9
console_level entier Configure le niveau de journalisation de la console (0 à 7) dellos9
trap_level entier Configure le niveau de gravité du serveur syslog (0 à 7) dellos9
syslog_version entier Configure la version syslog (0/1) dellos9
monitor entier Configure le niveau de journalisation de la ligne terminale (0 à 7) dellos9
history entier Configure la table d'historique syslog (0 à 7) dellos9
history_size entier Spécifie la taille de la table d'historique dellos9
on booléen Active la journalisation vers toutes les destinations prises en charge si définie sur true dellos9
extended booléen Active la journalisation étendue si définie sur true dellos9
coredump dict Configure la journalisation des coredumps dellos9
coredump.server dict Spécifie tous les détails du serveur dellos9
coredump.server.server_ip chaîne (obligatoire) Spécifie l'adresse IPv4/IPv6 du serveur de journalisation dellos9
coredump.server.username chaîne Spécifie le nom d'utilisateur à configurer dellos9
coredump.server.password chaîne Spécifie le mot de passe à configurer dellos9
coredump.server.state chaîne: présent, absent* Supprime le serveur de coredump si défini sur absent dellos9
coredump.stackunit dict Spécifie les détails pour activer un coredump sur l'unité de pile dellos9
coredump.stackunit.all booléen Active un coredump sur toutes les unités de pile dellos9
coredump.stackunit.unit_num entier Spécifie le numéro de l'unité de pile (0 à 5) dellos9
coredump.stackunit.state chaîne: présent, absent* Supprime le coredump de l'unité de pile si défini sur absent dellos9
source_interface chaîne Configure l'interface source pour la journalisation dellos6, dellos9, dellos10

NOTE : L'astérisque (*) indique la valeur par défaut si aucune valeur n'est spécifiée.

Variables de connexion

Les rôles Ansible pour le réseau Dell EMC nécessitent des informations de connexion pour établir la communication avec les nœuds de votre inventaire. Ces informations peuvent se trouver dans les répertoires group_vars ou host_vars d'Ansible, ou dans le playbook lui-même.

Clé Obligatoire Choix Description
ansible_host oui Spécifie le nom d'hôte ou l'adresse pour se connecter à l'appareil distant via le transport spécifié
ansible_port non Spécifie le port utilisé pour établir la connexion à l'appareil distant ; si aucune valeur n'est spécifiée, l'option ANSIBLE_REMOTE_PORT est utilisée, par défaut à 22
ansible_ssh_user non Spécifie le nom d'utilisateur qui authentifie la connexion CLI à l'appareil distant ; si aucune valeur n'est spécifiée, la valeur de la variable d'environnement ANSIBLE_REMOTE_USER est utilisée
ansible_ssh_pass non Spécifie le mot de passe qui authentifie la connexion à l'appareil distant
ansible_become non oui, non* Instruire le module à entrer en mode privilégié sur l'appareil distant avant d'envoyer des commandes ; si aucune valeur n'est spécifiée, la valeur de la variable d'environnement ANSIBLE_BECOME est utilisée et l'appareil tente d'exécuter toutes les commandes en mode non privilégié
ansible_become_method non enable, sudo* Instruire le module pour permettre de spécifier la méthode de privilège ; si aucune valeur n'est spécifiée, la valeur de la variable d'environnement ANSIBLE_BECOME_METHOD est utilisée
ansible_become_pass non Spécifie le mot de passe à utiliser si nécessaire pour entrer en mode privilégié sur l'appareil distant ; si ansible_become est défini sur non, cette clé n'est pas applicable
ansible_network_os oui dellos6/dellos9/dellos10, null* Charge les plugins de terminal et cliconf corrects pour communiquer avec l'appareil distant

NOTE : L'astérisque (*) indique la valeur par défaut si aucune valeur n'est spécifiée.

Dépendances

Le rôle dellos-logging est basé sur des modules inclus dans le code Ansible de base. Ces modules ont été ajoutés dans la version 2.2.0 d'Ansible.

Exemple de playbook

Cet exemple utilise le rôle dellos-logging pour configurer complètement les serveurs de journalisation. Il crée un fichier hosts avec les détails du switch et les variables correspondantes. Le fichier hosts doit définir la variable ansible_network_os avec le nom correspondant du système d'exploitation de réseau Dell EMC. Lorsque dellos_cfg_generate est défini sur true, la variable génère les commandes de configuration au format .part dans le chemin build_dir. Par défaut, la variable est définie sur false.

Exemple de fichier hosts

leaf1 ansible_host= <ip_address> 

Exemple de host_vars/leaf1

hostname: leaf1
ansible_become: yes
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"

Playbook simple pour configurer la journalisation - leaf.yaml

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

Exécution

ansible-playbook -i hosts leaf.yaml

(c) 2017 Dell Inc. ou ses filiales. Tous droits réservés.

À propos du projet

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

Installer
ansible-galaxy install Dell-Networking.dellos-logging
Licence
apache-2.0
Téléchargements
68.2k
Propriétaire