Nota

Este complemento es parte del colección community.network (versión 2.0.1).

Para instalarlo use: ansible-galaxy collection install community.network.

Para usarlo en un libro de jugadas, especifique: community.network.aruba_config.

  • Sinopsis
  • Parámetros
  • Ejemplos de
  • Valores devueltos

Sinopsis

  • Las configuraciones de Aruba utilizan una sintaxis de archivo de sangría de bloque simple para segmentar la configuración en secciones. Este módulo proporciona una implementación para trabajar con las secciones de configuración de Aruba de forma determinista.

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
despuéscuerda El conjunto ordenado de comandos que se agrega al final de la pila de comandos si es necesario realizar un cambio. Como con antes de esto permite que el diseñador del libro de jugadas agregue un conjunto de comandos que se ejecutarán después del conjunto de comandos.
respaldobooleano
    Opciones:

  • no
Este argumento hará que el módulo cree una copia de seguridad completa de la running-config desde el dispositivo remoto antes de realizar cualquier cambio. Si el backup_options no se da el valor, el archivo de respaldo se escribe en el backup carpeta en el directorio raíz del libro de jugadas. Si el directorio no existe, se crea.
Backup_optionsdiccionario Este es un objeto dict que contiene opciones configurables relacionadas con la ruta del archivo de respaldo. El valor de esta opción se lee solo cuando backup se establece en , si backup se establece en no esta opción se ignorará en silencio.
dir_pathsendero Esta opción proporciona la ruta que termina con el nombre del directorio en el que se almacenará el archivo de configuración de respaldo. Si el directorio no existe, se creará primero y el nombre del archivo es el valor de filename o nombre de archivo predeterminado como se describe en filename descripción de las opciones. Si el valor de la ruta no se da en ese caso, un respaldo El directorio se creará en el directorio de trabajo actual y la configuración de respaldo se copiará en filename dentro de respaldo directorio.
nombre del archivocuerda El nombre de archivo que se utilizará para almacenar la configuración de la copia de seguridad. Si no se proporciona el nombre del archivo, se generará en función del nombre de host, la hora y la fecha actuales en el formato definido por _config.@
antes decuerda El conjunto ordenado de comandos para pasar a la pila de comandos si es necesario realizar un cambio. Esto le permite al diseñador del libro de jugadas la oportunidad de ejecutar comandos de configuración antes de impulsar cualquier cambio sin afectar la forma en que el conjunto de comandos se compara con el sistema.
diff_againstcuerda
    Opciones:

  • puesta en marcha
  • destinado a
  • corriendo
Al usar el ansible-playbook --diff argumento de línea de comando, el módulo puede generar diffs contra diferentes fuentes.Cuando esta opción se configura como puesta en marcha, el módulo devolverá el diff de la configuración en ejecución contra la configuración de inicio. Cuando esta opción se configura como destinado a, el módulo devolverá el diff de la configuración en ejecución contra la configuración proporcionada en el intended_config Cuando esta opción se configura como corriendo, el módulo devolverá el diff antes y después de la configuración en ejecución con respecto a cualquier cambio realizado en la configuración del dispositivo.
diff_ignore_linescuerda Utilice este argumento para especificar una o más líneas que deben ignorarse durante la diferencia. Se utiliza para las líneas de la configuración que el sistema actualiza automáticamente. Este argumento toma una lista de expresiones regulares o coincidencias de línea exactas.
cifrarbooleano
    Opciones:

  • no
Esto permite que las contraseñas y claves de un controlador Aruba se muestren en texto sin formato cuando se establece en falso o cifrado cuando se establece en cierto. Si se establece en falso, la configuración se volverá a cifrar al final de la ejecución del módulo. Las copias de seguridad siguen encriptadas incluso cuando se configuran en falso.
intencionado_configcuerda los intended_config proporciona la configuración maestra a la que debe ajustarse el nodo y se utiliza para verificar la configuración de ejecución final. Este argumento no modificará ninguna configuración en el dispositivo remoto y se usa estrictamente para verificar el cumplimiento de la configuración actual del dispositivo. Al especificar este argumento, la tarea también debe modificar el diff_against valor y configúrelo en destinado a.
líneascuerda El conjunto ordenado de comandos que se deben configurar en la sección. Los comandos deben ser exactamente los mismos comandos que se encuentran en el dispositivo running-config. Asegúrese de tener en cuenta la sintaxis del comando de configuración, ya que el analizador de configuración del dispositivo modifica automáticamente algunos comandos.
alias: comandos
fósforocuerda
    Opciones:

  • línea
  • estricto
  • exacto
  • ninguno
Instruye al módulo sobre el camino para realizar la comparación del conjunto de comandos con la configuración actual del dispositivo. Si la coincidencia se establece en línea, los comandos se hacen coincidir línea por línea. Si la coincidencia se establece en estricto, las líneas de comando se hacen coincidir con respecto a la posición. Si la coincidencia se establece en exacto, las líneas de comando deben ser iguales. Finalmente, si la coincidencia se establece en ninguno, el módulo no intentará comparar la configuración de origen con la configuración en ejecución en el dispositivo remoto.
padrescuerda El conjunto ordenado de padres que identifican de manera única la sección o jerarquía con la que se deben verificar los comandos. Si se omite el argumento principal, los comandos se cotejan con el conjunto de comandos globales o de nivel superior.
proveedorcuerda Objeto dict que contiene detalles de conexión.
anfitrióncuerda / requerido Especifica el nombre de host DNS o la dirección para conectarse al dispositivo remoto a través del transporte especificado. El valor de host se utiliza como dirección de destino para el transporte.
contraseñacuerda Especifica la contraseña que se utilizará para autenticar la conexión al dispositivo remoto. Este valor se utiliza para autenticar la sesión SSH. Si el valor no se especifica en la tarea, el valor de la variable de entorno ANSIBLE_NET_PASSWORD se utilizará en su lugar.
Puertoentero Defecto:
22
Especifica el puerto que se utilizará al establecer la conexión con el control remoto. dispositivo.
ssh_keyfilesendero Especifica la clave SSH que se utilizará para autenticar la conexión al dispositivo remoto. Este valor es la ruta a la clave utilizada para autenticar la sesión SSH. Si el valor no se especifica en la tarea, el valor de la variable de entorno ANSIBLE_NET_SSH_KEYFILE se utilizará en su lugar.
se acabó el tiempoentero Defecto:
10
Especifica el tiempo de espera en segundos para comunicarse con el dispositivo de red para conectarse o enviar comandos. Si se excede el tiempo de espera antes de que se complete la operación, el módulo generará un error.
nombre de usuariocuerda Configura el nombre de usuario que se utilizará para autenticar la conexión al dispositivo remoto. Este valor se utiliza para autenticar la sesión SSH. Si el valor no se especifica en la tarea, el valor de la variable de entorno ANSIBLE_NET_USERNAME se utilizará en su lugar.
reemplazarcuerda
    Opciones:

  • línea
  • cuadra
Instruye al módulo sobre el camino para realizar la configuración en el dispositivo. Si el argumento de reemplazo se establece en línea luego, las líneas modificadas se envían al dispositivo en modo de configuración. Si el argumento de reemplazo se establece en cuadra luego, todo el bloque de comandos se envía al dispositivo en el modo de configuración si alguna línea no es correcta.
running_configcuerda El módulo, de forma predeterminada, se conectará al dispositivo remoto y recuperará la configuración en ejecución actual para usarla como base para comparar con el contenido de la fuente. Hay momentos en los que no es deseable que la tarea obtenga la configuración en ejecución actual para cada tarea en un libro de jugadas. los running_config El argumento permite al implementador pasar la configuración para usarla como configuración base para la comparación.
alias: config
save_whencuerda
    Opciones:

  • siempre
  • Nunca
  • modificado
  • cambió
Cuando se realizan cambios en la configuración en ejecución del dispositivo, los cambios no se copian en el almacenamiento no volátil de forma predeterminada. Usar este argumento cambiará eso antes. Si el argumento se establece en siempre, entonces la configuración en ejecución siempre se copiará a la configuración de inicio y la modificado La bandera siempre se establecerá en Verdadero. Si el argumento se establece en modificado, la configuración en ejecución solo se copiará en la configuración de inicio si ha cambiado desde la última vez que se guardó en la configuración de inicio. Si el argumento se establece en Nunca, la configuración en ejecución nunca se copiará a la configuración de inicio. Si el argumento se establece en cambió, entonces la configuración en ejecución solo se copiará a la configuración de inicio si la tarea ha realizado un cambio.
srccuerda Especifica la ruta de origen del archivo que contiene la configuración o la plantilla de configuración para cargar. La ruta al archivo de origen puede ser la ruta completa en el host de control de Ansible o una ruta relativa desde el libro de jugadas o el directorio raíz de la función. Este argumento es mutuamente excluyente con líneas, padres.

Ejemplos de

-name: Configure top level configuration
  community.network.aruba_config:lines: hostname  inventory_hostname -name: Diff the running-config against a provided config
  community.network.aruba_config:diff_against: intended
    intended_config:" lookup('file', 'master.cfg') "-name: Configure interface settings
  community.network.aruba_config:lines:- description test interface
      - ip access-group 1 in
    parents: interface gigabitethernet 0/0/0

-name: Load new acl into device
  community.network.aruba_config:lines:- permit host 10.10.10.10
      - ipv6 permit host fda9:97d6:32a3:3e59::3333parents: ip access-list standard 1
    before: no ip access-list standard 1
    match: exact

-name: Configurable backup path
  community.network.aruba_config:backup: yes
    lines: hostname  inventory_hostname backup_options:filename: backup.cfg
      dir_path: /home/user

Valores devueltos

Los valores de retorno comunes están documentados aquí, el seguimiento son los campos exclusivos de este módulo:

Llave Devuelto Descripción
ruta_de_seguridadcuerda cuando la copia de seguridad es sí La ruta completa al archivo de respaldo
Muestra:/ playbooks / ansible / backup /[email protected]: 28: 34
comandoslista / elementos = cadena siempre El conjunto de comandos que se enviarán al dispositivo remoto.
Muestra:[‘hostname foo’, ‘vlan 1’, ‘name default’]
actualizacioneslista / elementos = cadena siempre El conjunto de comandos que se enviarán al dispositivo remoto.
Muestra:[‘hostname foo’, ‘vlan 1’, ‘name default’]

Autores

  • James Mighion (@jmighion)