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 字符串	配置身份验证提供程序，以从远程设备获取身份验证令牌。 此选项在使用 BIG-IQ 设备时才会真正用到。
no_f5_teem 布尔值	如果为 yes，则不会将 TEEM 遥测数据发送到 F5。 您可以通过设置环境变量 F5_TELEMETRY_OFF 来省略此选项。 以前使用的变量 F5_TEEM 已弃用，因为其名称令人困惑。 选项 false ← (默认) true
password 别名：pass、pwd 字符串 / 必需	用于连接到 BIG-IP 或 BIG-IQ 的用户帐户的密码。 您可以通过设置环境变量 F5_PASSWORD 来省略此选项。
server 字符串 / 必需	BIG-IP 主机或 BIG-IQ 主机。 您可以通过设置环境变量 F5_SERVER 来省略此选项。
server_port 整数	BIG-IP 服务器端口。 您可以通过设置环境变量 F5_SERVER_PORT 来省略此选项。 默认值： 443
timeout 整数	指定与网络设备通信的超时时间（秒），用于连接或发送命令。如果在操作完成之前超时，模块将出错。
transport 字符串	配置连接到远程设备时使用的传输连接。 选项 "rest" ← (默认)
user 字符串 / 必需	连接到 BIG-IP 或 BIG-IQ 的用户名。此用户必须在设备上具有管理员权限。 您可以通过设置环境变量 F5_USER 来省略此选项。
validate_certs 布尔值	如果为no，则不验证SSL证书。仅在使用自签名证书的个人控制站点上使用此选项。 您可以通过设置环境变量F5_VALIDATE_CERTS来省略此选项。 选项 false true ← (默认)
qinq_ethertype any	指定此Trunk作为QinQ VLAN成员时，用于处理其上数据包的以太网类型值。 以太网类型可以设置为包含有效十六进制16位数字的任何字符串，或任何已知的以太网类型；0x8100，0x9100，0x88a8。 此参数在虚拟版本上不受支持。 应始终将此值用引号括起来，以防止Ansible将该值解释为字面十六进制数字并将其转换为整数。
state 字符串	当present时，确保资源存在。 当absent时，确保资源被移除。 选项 "present" ← (默认) "absent"

备注

注意

• 有关使用Ansible管理F5 Networks设备的更多信息，请参见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 的描述。 返回：changed 示例："My trunk"
frame_distribution_hash 字符串	系统用作帧分配算法的哈希值。 返回：changed 示例："src-dst-ipport"
interfaces 列表 / 元素=字符串	属于Trunk的接口。 返回：changed 示例：["int1", "int2"]
lacp_enabled 布尔值	系统是否支持链路聚合控制协议(LACP)。 返回：changed 示例：true
lacp_mode 字符串	如果为Trunk启用了lacp选项，则LACP的操作模式。 返回：changed 示例："active"
lacp_timeout 字符串	系统发送LACP控制数据包的速率。 返回：changed 示例："long"
link_selection_policy 字符串	Trunk用于确定哪个成员链路(接口)可以处理新流量的LACP策略。 返回：changed 示例："auto"
qinq_ethertype 字符串	此Trunk作为QinQ VLAN成员时，用于处理其上数据包的以太网类型值。 返回：changed 示例："37120"

作者

• Tim Rupp (@caphrim007)

• Wojciech Wypior (@wojtek0806)

集合链接

• 问题追踪器
• 主页
• 代码库 (源代码)