f5networks.f5_modules.bigip_trunk 模块 – 管理 BIG-IP 上的 Trunk

注意

此模块是 f5networks.f5_modules 集合 (版本 1.32.1) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install f5networks.f5_modules。

要在 playbook 中使用它，请指定： f5networks.f5_modules.bigip_trunk。

f5networks.f5_modules 1.0.0 中的新增功能

概要

• 管理 BIG-IP 上的 Trunk。

参数

参数	注释
description 字符串	Trunk 的描述。
frame_distribution_hash 字符串	指定系统用作帧分发算法的哈希的基础。系统使用生成的哈希来确定要使用哪个接口转发流量。 创建新的 Trunk 时，如果未指定此参数，则默认为 source-destination-ip。 当为 source-destination-mac 时，指定系统基于源和目标的组合 MAC 地址来计算哈希值。 当为 destination-mac 时，指定系统基于目标的 MAC 地址来计算哈希值。 当为 source-destination-ip 时，指定系统基于源和目标的组合 IP 地址来计算哈希值。 选项 "destination-mac" "source-destination-ip" "source-destination-mac"
interfaces 列表 / 元素=字符串	属于 Trunk 的接口。 要清除接口列表，请指定一个空列表。
lacp_enabled 布尔值	当为 true 时，指定系统支持链路聚合控制协议 (LACP)，该协议通过在成员链路上交换控制数据包来监控 Trunk，以确定链路的健康状况。 如果 LACP 检测到成员链路故障，它会将链路从链路聚合中移除。 创建新的 Trunk 时，如果未指定此参数，则 LACP 为 false。 出于向后兼容性考虑，默认情况下禁用 LACP。如果这并不适用于您的网络，我们建议您启用 LACP。 选项 false true
lacp_mode 字符串	如果为 Trunk 启用了 LACP，则指定链路聚合控制协议 (LACP) 的操作模式。 创建新的 Trunk 时，如果未指定此参数，则默认为 active。 当为 active 时，指定系统定期发送控制数据包，而不管伙伴系统是否发出了请求。 当为 passive 时，指定系统仅当伙伴系统发出了请求时才发送控制数据包。 选项 "active" "passive"
lacp_timeout 字符串	指定系统发送 LACP 控制数据包的速率。 创建新的 Trunk 时，如果未指定此参数，则默认为 long。 当为 long 时，指定系统每 30 秒发送一个 LACP 控制数据包。 当为 short 时，指定系统每秒发送一个 LACP 控制数据包。 选项 "long" "short"
link_selection_policy 字符串	配置 Trunk 后，指定 Trunk 用于确定哪个成员链路（接口）可以处理新流量的策略。 创建新的 Trunk 时，如果未指定此值，则默认为 auto。 当为 auto 时，指定系统自动确定哪些接口可以处理新流量。auto 选项的成员链路必须都是相同的媒体类型和速度。 当为 maximum-bandwidth 时，指定系统根据成员的最大带宽来确定哪些接口可以处理新流量。 选项 "auto" "maximum-bandwidth"
name 字符串 / 必需	指定 Trunk 的名称。
provider 字典 f5networks.f5_modules 1.0.0 中新增	包含连接详细信息的字典对象。
auth_provider 字符串	配置 auth provider 以从远程设备获取身份验证令牌。 此选项在与 BIG-IQ 设备一起使用时非常有用。
no_f5_teem 布尔值	如果为yes，则不会将 TEEM 遥测数据发送到 F5。 您可以通过设置环境变量F5_TELEMETRY_OFF来省略此选项。 先前使用的变量F5_TEEM已弃用，因为其名称令人混淆。 选项 false ← (默认) true
密码 别名：pass、pwd 字符串 / 必需	用于连接到 BIG-IP 或 BIG-IQ 的用户帐户的密码。 您可以通过设置环境变量F5_PASSWORD来省略此选项。
服务器 字符串 / 必需	BIG-IP 主机或 BIG-IQ 主机。 您可以通过设置环境变量F5_SERVER来省略此选项。
服务器端口 整数	BIG-IP 服务器端口。 您可以通过设置环境变量F5_SERVER_PORT来省略此选项。 默认值：443
超时 整数	指定与网络设备通信的超时时间（以秒为单位），用于连接或发送命令。如果在操作完成之前超时，模块将报错。
传输 字符串	配置连接到远程设备时使用的传输连接。 选项 "rest" ← (默认)
用户 字符串 / 必需	连接到 BIG-IP 或 BIG-IQ 的用户名。此用户必须拥有设备上的管理权限。 您可以通过设置环境变量F5_USER来省略此选项。
验证证书 布尔值	如果为no，则不验证 SSL 证书。仅在使用自签名证书的个人控制站点上使用此选项。 您可以通过设置环境变量F5_VALIDATE_CERTS来省略此选项。 选项 false true ← (默认)
QinQ 乙太网类型 任意	指定当此 Trunk 作为 QinQ VLAN 的成员时，为此 Trunk 上处理的数据包使用的以太网类型值。 以太网类型可以设置为包含有效十六进制 16 位数字的任何字符串，或任何众所周知的以太网类型；0x8100、0x9100、0x88a8。 此参数在虚拟版本中不受支持。 您应始终将此值用引号括起来，以防止 Ansible 将该值解释为字面十六进制数字并将其转换为整数。
状态 字符串	当为present时，确保资源存在。 当为absent时，确保资源被删除。 选项 "present" ← (默认) "absent"

注释

注意

• 有关使用 Ansible 管理 F5 网络设备的更多信息，请参阅 https://ansible.org.cn/integrations/networks/f5。

• 需要 BIG-IP 软件版本 >= 12。

• F5 模块仅操作 F5 产品的运行配置。为确保 BIG-IP 特定的配置持久保存到磁盘，请务必包含至少一项使用 f5networks.f5_modules.bigip_config 模块保存运行配置的任务。请参阅模块的文档，了解保存运行配置的模块的正确使用方法。

示例

- name: Create a trunk on hardware
  bigip_trunk:
    name: trunk1
    interfaces:
      - 1.1
      - 1.2
    link_selection_policy: maximum-bandwidth
    frame_distribution_hash: destination-mac
    lacp_enabled: true
    lacp_mode: passive
    lacp_timeout: short
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

返回值

常用返回值已在此处记录 此处，以下是此模块特有的字段

键	描述
description 字符串	Trunk 的描述。 返回：已更改 示例："My trunk"
frame_distribution_hash 字符串	系统用作帧分配算法的哈希值。 返回：已更改 示例："src-dst-ipport"
interfaces 列表 / 元素=字符串	属于 Trunk 的接口。 返回：已更改 示例：["int1", "int2"]
lacp_enabled 布尔值	系统是否支持链路聚合控制协议 (LACP)。 返回：已更改 示例：true
lacp_mode 字符串	如果为 Trunk 启用了 lacp 选项，则为 LACP 的操作模式。 返回：已更改 示例："active"
lacp_timeout 字符串	系统发送 LACP 控制数据包的速率。 返回：已更改 示例："long"
link_selection_policy 字符串	Trunk 用于确定哪个成员链路（接口）可以处理新流量的 LACP 策略。 返回：已更改 示例："auto"
QinQ 乙太网类型 字符串	当此 Trunk 作为 QinQ VLAN 的成员时，为此 Trunk 上处理的数据包使用的以太网类型值。 返回：已更改 示例："37120"

作者

• Tim Rupp (@caphrim007)

• Wojciech Wypior (@wojtek0806)

收藏链接

• 问题跟踪器
• 主页
• 存储库（源代码）