Dell-Networking.dellos-logging
Rol de registro
Este rol facilita la configuración de atributos de registro globales y apoya la configuración de servidores de registro. Este rol está abstraído para dellos6, dellos9 y dellos10.
El rol de Registro requiere una conexión SSH para conectarse a un dispositivo de red Dell EMC. Puedes usar cualquiera de las variables de conexión integradas del sistema operativo.
Instalación
ansible-galaxy install Dell-Networking.dellos-logging
Variables del rol
- El rol está abstraído usando la variable ansible_network_os que puede tomar los valores dellos9, dellos6 y dellos10.
- Si la variable dellos_cfg_generate está configurada en verdadero, genera los comandos de configuración del rol en un archivo.
- Cualquier variable del rol con una variable de estado correspondiente configurada como ausente anula la configuración de esa variable.
- Configurar un valor vacío para cualquier variable anula la configuración correspondiente.
- Las variables y valores son sensibles a mayúsculas y minúsculas.
Claves de dellos_logging
Clave | Tipo | Descripción | Soporte |
---|---|---|---|
logging |
lista | Configura el servidor de registro (ver logging.* ) |
dellos6, dellos9, dellos10 |
logging.ip |
cadena (requerido) | Configura la dirección IPv4 para el servidor de registro (formato A.B.C.D) | dellos6, dellos9, dellos10 |
logging.secure_port |
entero | Especifica mensajes de registro a través del puerto TLS | dellos9 |
logging.tcp_port |
entero | Especifica mensajes de registro a través del puerto TCP si no se define secure_port | dellos9 |
logging.udp_port |
entero | Especifica mensajes de registro a través del puerto UDP si no se definen los puertos TCP y secure_port | dellos9 |
logging.vrf |
diccionario | Especifica una instancia VRF para alcanzar el host | dellos9 |
logging.vrf.name |
cadena | Especifica el nombre de la VRF | dellos9 |
logging.vrf.secure_port |
entero | Especifica mensajes de registro a través del puerto TLS | dellos9 |
logging.vrf.tcp_port |
entero | Especifica mensajes de registro a través del puerto TCP si no se define secure_port | dellos9 |
logging.vrf.udp_port |
entero | Especifica mensajes de registro a través del puerto UDP si no se definen los puertos TCP y secure_port | dellos9 |
logging.vrf.state |
cadena: ausente,presente* | Elimina la instancia VRF del servidor de registro si se establece en ausente | dellos9 |
logging.state |
cadena: ausente,presente* | Elimina el servidor de registro si se establece en ausente | dellos6, dellos9, dellos10 |
console |
diccionario | Configura el registro en la consola (ver console.* ) |
dellos10 |
console.enable |
booleano | Habilita/deshabilita el registro en la consola | dellos10 |
console.severity |
cadena | Configura el nivel mínimo de severidad para el registro en la consola | dellos10 |
log_file |
diccionario | Configura el registro en un archivo de log (ver log_file.* ) |
dellos10 |
log_file.enable |
booleano | Habilita/deshabilita el registro en un archivo de log | dellos10 |
log_file.severity |
cadena | Configura el nivel mínimo de severidad para el registro en un archivo de log | dellos10 |
buffer |
entero | Especifica el nivel de severidad del registro en búfer (0 a 7) | dellos9 |
console_level |
entero | Configura el nivel de registro de la consola (0 a 7) | dellos9 |
trap_level |
entero | Configura el nivel de severidad del servidor syslog (0 a 7) | dellos9 |
syslog_version |
entero | Configura la versión de syslog (0/1) | dellos9 |
monitor |
entero | Configura el nivel de registro de la línea de terminal (0 a 7) | dellos9 |
history |
entero | Configura la tabla de historial de syslog (0 a 7) | dellos9 |
history_size |
entero | Especifica el tamaño de la tabla de historial | dellos9 |
on |
booleano | Habilita el registro en todos los destinos soportados si se establece en verdadero | dellos9 |
extended |
booleano | Habilita el registro extendido si se establece en verdadero | dellos9 |
coredump |
diccionario | Configura el registro de coredump | dellos9 |
coredump.server |
diccionario | Especifica todos los detalles del servidor | dellos9 |
coredump.server.server_ip |
cadena (requerido) | Especifica la dirección IPv4/IPv6 del servidor de registro | dellos9 |
coredump.server.username |
cadena | Especifica el nombre de usuario que se configurará | dellos9 |
coredump.server.password |
cadena | Especifica la contraseña que se configurará | dellos9 |
coredump.server.state |
cadena: presente,ausente* | Elimina el servidor de coredump si se establece en ausente | dellos9 |
coredump.stackunit |
diccionario | Especifica detalles para habilitar un coredump en la unidad de pila | dellos9 |
coredump.stackunit.all |
booleano | Habilita un coredump en todas las unidades de pila | dellos9 |
coredump.stackunit.unit_num |
entero | Especifica el número de la unidad de pila (0 a 5) | dellos9 |
coredump.stackunit.state |
cadena: presente,ausente* | Elimina el coredump de la unidad de pila si se establece en ausente | dellos9 |
source_interface |
cadena | Configura la interfaz de origen para el registro | dellos6, dellos9, dellos10 |
NOTA: El asterisco (*) indica el valor predeterminado si no se especifica otro.
Variables de conexión
Los roles de Ansible Dell EMC Networking requieren información de conexión para establecer comunicación con los nodos en tu inventario. Esta información puede existir en los directorios group_vars o host_vars de Ansible, en el inventario, o en el propio playbook.
Clave | Requerido | Opciones | Descripción |
---|---|---|---|
ansible_host |
sí | Especifica el nombre o dirección para conectarse al dispositivo remoto a través del transporte especificado | |
ansible_port |
no | Especifica el puerto utilizado para construir la conexión al dispositivo remoto; si no se especifica, se usa la opción ANSIBLE_REMOTE_PORT, que por defecto es 22 | |
ansible_ssh_user |
no | Especifica el nombre de usuario que autentica el acceso CLI para la conexión al dispositivo remoto; si no se especifica, se usa el valor de la variable ANSIBLE_REMOTE_USER | |
ansible_ssh_pass |
no | Especifica la contraseña que autentica la conexión al dispositivo remoto | |
ansible_become |
no | sí, no* | Indica al módulo que entre en modo privilegiado en el dispositivo remoto antes de enviar comandos; si no se especifica, se usa el valor de la variable ANSIBLE_BECOME y el dispositivo intenta ejecutar todos los comandos en modo no privilegiado |
ansible_become_method |
no | enable, sudo* | Indica al módulo que se puede especificar el método de elevación de privilegios; si no se especifica, se usa el valor de ANSIBLE_BECOME_METHOD |
ansible_become_pass |
no | Especifica la contraseña que se usará si es necesario para ingresar en modo privilegiado en el dispositivo remoto; si ansible_become se establece en no, esta clave no es aplicable |
|
ansible_network_os |
sí | dellos6/dellos9/dellos10, null* | Carga los plugins de terminal y cliconf correctos para comunicarse con el dispositivo remoto |
NOTA: El asterisco (*) indica el valor predeterminado si no se especifica otro.
Dependencias
El rol dellos-logging se basa en módulos incluidos en el código base de Ansible. Estos módulos se añadieron en la versión 2.2.0 de Ansible.
Ejemplo de playbook
Este ejemplo utiliza el rol dellos-logging para configurar completamente los servidores de registro. Crea un archivo hosts con los detalles del switch y las variables correspondientes. El archivo de hosts debe definir la variable ansible_network_os con el nombre correspondiente del sistema operativo de red de Dell EMC. Cuando dellos_cfg_generate se establece en verdadero, la variable genera los comandos de configuración como un archivo .part en la ruta build_dir. Por defecto, la variable se establece como falsa.
Archivo de hosts de ejemplo
leaf1 ansible_host=<ip_address>
Ejemplo de host_vars/leaf1
hostname: leaf1
ansible_become: sí
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: verdadero
extended: verdadero
coredump:
server:
server_ip: 2.2.2.2
username: u1
password: pwd
state: present
stackunit:
all: verdadero
unit_num: 5
state: present
source_interface: "fortyGigE 1/9"
Playbook simple para configurar el registro - leaf.yaml
- hosts: leaf1
roles:
- Dell-Networking.dellos-logging
Ejecutar
ansible-playbook -i hosts leaf.yaml
(c) 2017 Dell Inc. o sus subsidiarias. Todos los derechos reservados.
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