Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Usar Ansible con tablas PyEZ de Junos para recuperar información operativa de dispositivos Junos

Descripción general del módulo

Las tablas operacionales (op) de Junos PyEZ proporcionan una manera sencilla y eficiente de extraer información de resultados de comandos operativos complejos. Juniper Networks ofrece módulos de Ansible que le permiten aprovechar las mesas de operaciones de Junos PyEZ desde los manuales de Ansible. En el cuadro 1 se esbozan los módulos.

Tabla 1: Módulos de tabla de Junos PyEZ

Conjunto de contenido

Nombre del módulo

juniper.device Colección

table

Juniper.junos Papel

juniper_junos_table

Nota:

A partir Juniper.junos de la versión 2.0.0, el módulo reemplaza la juniper_junos_table funcionalidad del junos_get_table módulo.

Nota:

Los módulos no funcionan con tablas y vistas de configuración.

Descripción de las tablas de PyEZ de Junos

Junos PyEZ es un microframework para Python que le permite administrar y automatizar dispositivos Junos. Junos PyEZ admite el uso de definiciones simples de YAML, que se denominan tablas y vistas, para recuperar y filtrar los datos de configuración y salida de comandos operativos de los dispositivos Junos.

Las tablas operacionales (op) de Junos PyEZ extraen información de la salida de los comandos operativos o RPC. Los módulos de Junos PyEZ jnpr.junos.op contienen definiciones predefinidas de tabla y vista para algunos RPC comunes. También puede crear tablas y vistas personalizadas.

Cuando se utiliza Ansible para administrar dispositivos Junos, los módulos y juniper_junos_table pueden utilizar tablas table PyEZ de Junos para recuperar datos de un dispositivo. Los módulos pueden hacer referencia a las tablas y vistas operativas predefinidas que se incluyen con la distribución Junos PyEZ, o pueden hacer referencia a tablas y vistas definidas por el usuario que residen en el nodo de control de Ansible.

Para obtener información general acerca de las tablas y vistas de Junos PyEZ, consulte las siguientes secciones y la documentación relacionada en la Guía para desarrolladores de Junos PyEZ:

Cómo utilizar los módulos Ansible de Juniper Networks con tablas PyEZ de Junos

Los table módulos y juniper_junos_table pueden incluir los siguientes argumentos para especificar la tabla que se va a utilizar:

  • file: nombre de archivo del archivo YAML que define la tabla y vista de Junos PyEZ.

  • path—(Opcional) Ruta al directorio que contiene el archivo YAML con las definiciones Tabla y Vista. La ruta de archivo predeterminada es la ubicación de las tablas op de Junos PyEZ predefinidas, que residen en la ruta de instalación de Junos PyEZ en el directorio jnpr/junos/op .

  • table—(Opcional) Nombre de la tabla que se utilizará para recuperar los datos. Esta opción sólo es necesaria cuando un archivo contiene varias definiciones de tabla o el archivo contiene una sola tabla que no incluye "Tabla" en su nombre.

Por ejemplo, la siguiente tarea recupera datos mediante una tabla personalizada denominada FPCTable, que se define en el archivo fpc.yaml ubicado en el directorio del playbook:

La respuesta del módulo incluye la clave, que contiene una lista de elementos devueltos por la resource tabla. Cada elemento de lista es un diccionario que contiene los nombres de campo definidos por la Vista y el valor extraído de los datos para cada uno de los campos correspondientes.

Considere la siguiente tabla y vista predefinidas, y ArpView, en el archivo arp.yml de la distribución Junos PyEZ. ejecuta la RPC con la opción, ArpTable que es equivalente al comando de la <get-arp-table-information> <no-resolve/> show arp no-resolve CLI. ArpTable La vista correspondiente extrae la dirección MAC, la dirección IP y el nombre de interfaz de cada <arp-table-entry> elemento de la respuesta.

En el siguiente manual de Ansible se ejecuta el table módulo, que se utiliza ArpTable para recuperar información del Protocolo de resolución de direcciones (ARP) de los dispositivos Junos. Dado que ArpTable se incluye con la distribución Junos PyEZ y reside en el directorio predeterminado de las tablas op de Junos PyEZ predefinidas, el argumento module path no es necesario para especificar la ubicación del archivo. Además, dado que ArpTable es la única tabla definida en el archivo e incluye "tabla" en su nombre, el table argumento no es necesario para especificar la tabla.

La salida del manual, que se trunca por brevedad, incluye los campos correspondientes, definidos por la vista, para cada <arp-table-entry> elemento devuelto por el dispositivo.

El siguiente manual de estrategias de Ansible aprovecha la tabla OspfInterfaceTable operativa predefinida de Junos PyEZ para recuperar información sobre las interfaces OSPF en dispositivos Junos. El archivo ospf.yml define varias tablas y vistas, por lo que la llamada al módulo incluye el table argumento para especificar qué tabla usar.

Especificar argumentos RPC

Las tablas operativas de Junos PyEZ tienen una clave opcional args que define las opciones de comando y los argumentos predeterminados para el RPC ejecutado por esa tabla. La aplicación ejecuta el RPC con las opciones predeterminadas, a menos que el usuario invalide las predeterminadas. En las aplicaciones de Junos PyEZ, puede invalidar las opciones de comando predeterminadas o pasar opciones y argumentos adicionales al RPC al llamar al get() método.

Los table módulos y también permiten invalidar las opciones de comando predeterminadas definidas en la tabla o pasar opciones y juniper_junos_table argumentos adicionales al RPC mediante el kwargs argumento. El kwargs valor es un diccionario de opciones y valores de comando, que deben ser compatibles con la RPC y el dispositivo en el que se ejecuta la RPC.

Por ejemplo, la tabla EthPortTable op predefinida de Junos PyEZ en el archivo ethport.yml ejecuta el RPC con la opción de comando y devuelve información para todas las interfaces que coinciden con la media expresión regular dada para el <get-interface-information> nombre de interfaz.

El siguiente manual de estrategias de Ansible sirve EthPortTable para extraer información sobre las interfaces de los dispositivos Junos. El kwargs argumento incluye interface_name: "ge-1/0/0", que anula el EthPortTable valor predeterminado para e indica al módulo que recupere los campos solicitados sólo para interface_name la interfaz ge-1/0/0.

Para obtener más información acerca de las opciones y argumentos de comando predeterminados y proporcionados por el usuario en las tablas de Junos PyEZ, consulte Definir tablas operativas de Junos PyEZ y Usar tablas y vistas operativas de Junos PyEZ.

Tabla de historial de versiones
Lanzamiento
Descripción
2.0.0
A partir Juniper.junos de la versión 2.0.0, el módulo reemplaza la juniper_junos_table funcionalidad del junos_get_table módulo.