Nota

Este complemento es parte del colección f5networks.f5_modules (versión 1.7.1).

Para instalarlo use: ansible-galaxy collection install f5networks.f5_modules.

Para usarlo en un libro de jugadas, especifique: f5networks.f5_modules.bigip_interface.

Nuevo en la versión 1.0.0: de f5networks.f5_modules

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

Sinopsis

  • Módulo para gestionar interfaces físicas BIG-IP.

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
manojocuerda
    Opciones:

  • activado
  • discapacitado
  • No soportado
 Habilita o deshabilita la capacidad de paquete. Esta opción solo es compatible con determinadas plataformas de hardware e interfaces. VE o cualquier otra plataforma / interfaz no compatible provocará una falla en la ejecución del módulo.
bundle_speedcuerda
    Opciones:

  • 100 GRAMOS
  • 40G
  • No soportado
 Establece la velocidad del paquete, que es aplicable solo cuando el paquete es yes.Esta opción solo es compatible con plataformas e interfaces de hardware seleccionadas. VE o cualquier otra plataforma / interfaz no compatible provocará una falla en la ejecución del módulo.
descripcióncuerda Descripción definida por el usuario.
activadobooleano
    Opciones:

  • no
  • sí
 Especifica el estado actual de la interfaz. yes, permite que la interfaz pase el tráfico. no, desactiva la interfaz para que no pase tráfico.
control de flujocuerda
    Opciones:

  • ninguno
  • rx
  • tx
  • tx-rx
 Especifica cómo el sistema controla el envío de tramas de PAUSA. tx-rx, la interfaz respeta los marcos de pausa de su socio y también genera marcos de pausa cuando es necesario. tx, la interfaz ignora los cuadros de pausa de su socio y genera cuadros de pausa cuando es necesario. rx, la interfaz respeta los marcos de pausa de su socio, pero no genera marcos de pausa. Cuando (ninguno), el control de flujo está deshabilitado en la interfaz.
force_gigabit_fiberbooleano
    Opciones:

  • no
  • sí
 Habilita o deshabilita el forzado de medios de fibra gigabit. yes para una interfaz de fibra gigabit, se forzará la configuración de medios y no se realizará ninguna negociación automática. no la negociación automática se realizará con una sola opción de fibra gigabit anunciada.
forward_error_correctioncuerda
    Opciones:

  • activado
  • discapacitado
  • No soportado
  • auto
 Habilita o deshabilita IEEE 802.3bm Clause 91 Reed-Solomon Forward Error Correction en interfaces 100G. No es válido para medios LR4. Esta opción solo es compatible con plataformas e interfaces de hardware seleccionadas. VE o cualquier otra plataforma / interfaz no compatible provocará una falla en la ejecución del módulo.
lldp_admincuerda
    Opciones:

  • desactivar
  • rxonly
  • txonly
  • txrx
 Especifica la configuración de LLDP en un nivel de interfaz. disabled, la interfaz no transmite (envía) mensajes LLDP ni recibe mensajes LLDP de dispositivos vecinos. txonly, la interfaz transmite mensajes LLDP a dispositivos vecinos, pero no recibe mensajes LLDP de dispositivos vecinos. rxonly, la interfaz recibe mensajes LLDP de dispositivos vecinos, pero no transmite mensajes LLDP a dispositivos vecinos. txrx, la interfaz transmite mensajes LLDP y recibe mensajes LLDP de dispositivos vecinos.
lldp_tlvmapentero Especifica el contenido de un mensaje LLDP que se envía o recibe.Cada atributo LLDP especificado con esta configuración es opcional y tiene la forma de Tipo, Longitud, Valor (TLV) .Los tres TLV obligatorios que no se tienen en cuenta al calcular este valor son: Chassis ID, Port ID, y TTLLos atributos opcionales que están disponibles tienen asignado un valor numérico TLV específico. Port Description El atributo tiene un valor TLV de 8.Los System Name El atributo tiene un valor TLV de 16.Los System Description El atributo tiene un valor TLV de 32.Los System Capabilities El atributo tiene un valor TLV de 64.Los Management Address El atributo tiene un valor TLV de 128.Los Port VLAN ID El atributo tiene un valor TLV de 256.Los VLAN Name El atributo tiene un valor TLV de 512.Los Port and Protocol VLAN ID El atributo tiene un valor TLV de 1024.Los Protocol Identity El atributo tiene un valor TLV de 2048.Los MAC/PHY Config Status El atributo tiene un valor TLV de 4096.Los Link Aggregation El atributo tiene un valor TLV de 8192.Los Max Frame Size El atributo tiene un valor TLV de 32768.Los Product Model El atributo tiene un valor TLV de 65536.Los lldp_tlvmap es un valor numérico que es una suma de todos los valores TLV de los atributos seleccionados. lldp_tlvmap para 0 eliminará todos los atributos de la interfaz. lldp_tlvmap para 114680 agregará todos los atributos a la interfaz.
media_fixedcuerda
    Opciones:

  • 100000-FD
  • 100000LR4-FD
  • 10000LR-FD
  • 10000T-FD
  • 1000SX-FD
  • 100TX-FD
  • 10T-HD
  • 20000-FD
  • 40000LR4-FD
  • 100000AR4-FD
  • 100000SR4-FD
  • 10000SFPCU-FD
  • 1000CX-FD
  • 1000T-FD
  • 100TX-HD
  • 12000-FD
  • 21000-FD
  • 40000SR4-FD
  • 100000CR4-FD
  • 10000ER-FD
  • 10000SR-FD
  • 1000LX-FD
  • 1000T-HD
  • 10T-FD
  • 16000-FD
  • 40000-FD
  • 42000-FD
  • auto
  • no-phy
 Especifica la configuración para una interfaz fija (no conectable). Utilice esta opción solo con un puerto combinado para especificar el tipo de medio para la interfaz fija, cuando no es el puerto preferido.
media_sfpcuerda
    Opciones:

  • 100000-FD
  • 100000LR4-FD
  • 10000LR-FD
  • 10000T-FD
  • 1000SX-FD
  • 100TX-FD
  • 10T-HD
  • 20000-FD
  • 40000LR4-FD
  • 100000AR4-FD
  • 100000SR4-FD
  • 10000SFPCU-FD
  • 1000CX-FD
  • 1000T-FD
  • 100TX-HD
  • 12000-FD
  • 21000-FD
  • 40000SR4-FD
  • 100000CR4-FD
  • 10000ER-FD
  • 10000SR-FD
  • 1000LX-FD
  • 1000T-HD
  • 10T-FD
  • 16000-FD
  • 40000-FD
  • 42000-FD
  • auto
  • no-phy
 Especifica la configuración de una interfaz SFP (conectable). Utilice esta opción solo con un puerto combinado para especificar el tipo de medio para la interfaz SFP, cuando no es el puerto preferido.
nombrecuerda / requerido Especifica el nombre de la interfaz a administrar.
port_fwd_modecuerda
    Opciones:

  • l3
  • pasivo
  • cable virtual
 Especifica el modo de funcionamiento.
puerto_preferidocuerda
    Opciones:

  • sfp
  • reparado
 Indica qué lado de un puerto combinado usa la interfaz, si ambos lados tienen la posibilidad de un enlace externo. El valor predeterminado para un puerto combinado es sfp. No utilice esta opción para puertos que no sean combinados.
proveedordiccionario agregado en 1.0.0 de f5networks.f5_modules Objeto dict que contiene detalles de conexión.
auth_providercuerda Configura el proveedor de autenticación para obtener tokens de autenticación del dispositivo remoto. Esta opción se usa realmente cuando se trabaja con dispositivos BIG-IQ.
no_f5_teembooleano
    Opciones:

  • no
  • sí
 Si yes, Los datos de telemetría TEEM no se envían a F5. Puede omitir esta opción configurando la variable de entorno F5_TEEM.
contraseñacuerda / requerido La contraseña de la cuenta de usuario utilizada para conectarse a BIG-IP. Puede omitir esta opción configurando la variable de entorno F5_PASSWORD.
alias: pass, pwd
servidorcuerda / requerido El host BIG-IP. Puede omitir esta opción configurando la variable de entorno F5_SERVER.
Puerto de servicioentero Defecto:
443		 El puerto del servidor BIG-IP. Puede omitir esta opción configurando la variable de entorno F5_SERVER_PORT.
se acabó el tiempoentero 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.
transportecuerda
    Opciones:

  • descansar ←
 Configura la conexión de transporte que se utilizará al conectarse al dispositivo remoto.
usuariocuerda / requerido El nombre de usuario con el que conectarse a BIG-IP. Este usuario debe tener privilegios administrativos en el dispositivo. Puede omitir esta opción configurando la variable de entorno F5_USER.
validate_certsbooleano
    Opciones:

  • no
  • sí ←
 Si no, Los certificados SSL no están validados. Use esto solo en sitios controlados personalmente que usen certificados autofirmados. Puede omitir esta opción configurando la variable de entorno F5_VALIDATE_CERTS.
sflowdiccionario Especifica la configuración de sFlow para la interfaz.
intervalo de encuestaentero Especifica el intervalo máximo entre dos sondeos, en segundos. Para que esta configuración surta efecto, poll_interval_global debe establecerse en no.El rango válido es 0 – 4294967295.
poll_interval_globalbooleano
    Opciones:

  • no
  • sí
 Especifica si la interfaz global poll_interval la configuración anula el nivel de objeto poll_interval ajuste. yes los poll_interval el ajuste no tiene efecto.
stpbooleano
    Opciones:

  • no
  • sí
 Habilita o deshabilita STP.
stp_auto_edge_portbooleano
    Opciones:

  • no
  • sí
 Establece la detección automática del puerto de borde de STP para la interfaz. yes, el sistema monitorea la interfaz en busca de paquetes STP, RSTP o MSTP entrantes. Si no se reciben dichos paquetes durante un período de tiempo suficiente (aproximadamente tres segundos), la interfaz recibe automáticamente el estado del puerto de borde. no, el sistema nunca proporciona automáticamente el estado del puerto de borde de la interfaz. Cualquier configuración de STP establecida por interfaz se aplica a todas las instancias del árbol de expansión.
stp_edge_portbooleano
    Opciones:

  • no
  • sí
 Especifica si la interfaz se conecta a una estación final en lugar de a otro puente de árbol de expansión.
stp_link_typecuerda
    Opciones:

  • auto
  • p2p
  • compartido
 Especifica el tipo de enlace STP para la interfaz.

Notas

Nota

  • Para obtener más información sobre el uso de Ansible para administrar dispositivos de redes F5, consulte https://www.ansible.com/integrations/networks/f5.
  • Requiere la versión de software BIG-IP> = 12.
  • Los módulos F5 solo manipulan la configuración en ejecución del producto F5. Para asegurarse de que la configuración específica de BIG-IP persista en el disco, asegúrese de incluir al menos una tarea que utilice la f5networks.f5_modules.bigip_config módulo para guardar la configuración en ejecución. Consulte la documentación del módulo para conocer el uso correcto del módulo para guardar su configuración en ejecución.

Ejemplos de

-name: Update Interface Settings
  bigip_interface:name:1.1stp: yes
    stp_auto_edge_port: no
    stp_edge_port: yes
    stp_link_type: shared
    description: my description
    flow_control: tx
    lldp_admin: txrx
    lldp_tlvmap:8force_gigabit_fiber: no
    sflow:-poll_interval:10-poll_interval_global: no
    provider:password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

-name: Disable Interface
  bigip_interface:name:1.1enabled: no
    provider:password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

-name: Change sflow interface settings
  bigip_interface:name:1.1sflow:-poll_interval:0-poll_interval_global: yes
    provider:password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Valores devueltos

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

Llave Devuelto Descripción
manojocuerda cambió Habilita o deshabilita la capacidad de paquete.
Muestra:No soportado
bundle_speedcuerda cambió La velocidad del paquete.
Muestra:100 GRAMOS
descripcióncuerda cambió Descripción definida por el usuario.
Muestra:mi descripción
activadobooleano cambió El estado actual de la interfaz.
Muestra:Cierto
control de flujocuerda cambió Especifica cómo el sistema controla el envío de tramas de PAUSA.
Muestra:tx
force_gigabit_fiberbooleano cambió Habilita o deshabilita el forzado de medios de fibra gigabit.
Muestra:Cierto
forward_error_correctioncuerda cambió Habilita o deshabilita la corrección de errores de reenvío.
Muestra:auto
lldp_admincuerda cambió La configuración de LLDP a nivel de interfaz.
Muestra:txrx
lldp_tlvmapentero cambió El contenido de un mensaje LLDP que se envía o recibe.
Muestra:136
media_fixedcuerda cambió La configuración de una interfaz fija.
Muestra:100000-FD
media_sfpcuerda cambió La configuración de una interfaz SFP.
Muestra:100000-FD
port_fwd_modecuerda cambió El modo de funcionamiento.
Muestra:pasivo
puerto_preferidocuerda cambió El lado de un puerto combinado que usa la interfaz.
Muestra:reparado
sflowcomplejo cambió Especifica la configuración de sFlow para la interfaz.
Muestra:hash / diccionario de valores
intervalo de encuestaentero cambió El intervalo máximo en segundos entre dos sondeos.
Muestra:128
poll_interval_globalbooleano cambió Se anula la configuración global de sFlow.
Muestra:Cierto
stpbooleano cambió Habilita o deshabilita STP.
stp_auto_edge_portbooleano cambió Establece la detección automática de puertos de borde STP para la interfaz.
Muestra:Cierto
stp_edge_portbooleano cambió Especifica si la interfaz se conecta a una estación final en lugar de a otro puente de árbol de expansión.
stp_link_typecuerda cambió El tipo de enlace STP para la interfaz.
Muestra:compartido

Autores

  • Wojciech Wypior (@ wojtek0806)