f5networks.f5_modules.bigip_device_traffic_group 模块 – 管理 BIG-IP 上的流量组
注意
此模块是 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_device_traffic_group。
f5networks.f5_modules 1.0.0 中的新增功能
概要
支持管理 BIG-IP 上的流量组及其属性。
参数
参数 |
注释 |
|---|---|
指定流量组是否故障回复到 选择
|
|
指定系统在故障回复到 正确的值范围是 |
|
指定要与流量组关联的已配置的 在设备上创建 HA 组并将其与流量组关联后，必须在设备组中的每个设备上创建一个 HA 组并将其与同一个流量组关联。 要禁用 HA 组故障转移方法，请为此参数指定一个空字符串值 ( 禁用 HA 组会将设备恢复为使用
|
|
流量组向系统呈现的相对于其他流量组的负载值。 此参数仅在使用 正确的值范围是 |
|
指定您希望分配设备以进行故障转移的顺序。 如果配置此设置，则必须在设备组中的每个流量组上配置该设置。 这些值应该是先前配置的故障转移组中的设备的设备名称。 作为此参数的参数放置的设备的顺序决定了它们在设备上的 HA 顺序。这意味着更改相同元素的顺序将导致设备上的更改。 要禁用 HA 顺序故障转移方法，请为此参数指定一个空字符串值 ( 禁用 HA 顺序会将设备恢复为使用负载感知方法（默认），除非还配置了 设备名称将由模块预先添加分区，因此您可以提供完整路径格式名称 |
|
指定与为流量组定义的浮动 IP 地址关联的浮动媒体访问控制 (MAC) 地址。 主要地，MAC 伪装地址可以最大限度地减少由于故障转移而导致的 ARP 通信或丢包。 MAC 伪装地址确保任何发往特定流量组的流量在故障转移后到达可用设备，这是因为 MAC 伪装地址会随着流量组一起浮动到可用设备。 如果没有 MAC 伪装地址，则发送主机必须学习新激活设备的 MAC 地址，或者通过发送 ARP 请求，或者依赖于新激活设备的免费 ARP。 要取消设置 MAC 地址，请为此参数指定一个空值 ( |
|
流量组的名称。 |
|
要在其上管理资源的设备分区。 默认值： |
|
包含连接详细信息的字典对象。 |
|
配置身份验证提供程序以从远程设备获取身份验证令牌。 此选项在处理 BIG-IQ 设备时真正使用。 |
|
如果为 您可以通过设置环境变量 以前使用的变量 选择
|
|
用于连接 BIG-IP 或 BIG-IQ 的用户帐户的密码。 可以通过设置环境变量 |
|
BIG-IP 主机或 BIG-IQ 主机。 可以通过设置环境变量 |
|
BIG-IP 服务器端口。 可以通过设置环境变量 默认: |
|
指定与网络设备通信的超时时间（以秒为单位），用于连接或发送命令。如果在操作完成之前超过超时时间，模块将报错。 |
|
配置连接到远程设备时使用的传输连接方式。 选择
|
|
用于连接 BIG-IP 或 BIG-IQ 的用户名。此用户必须在设备上具有管理权限。 可以通过设置环境变量 |
|
如果设置为 可以通过设置环境变量 选择
|
|
当设置为 当设置为 选择
|
注释
注意
有关使用 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 traffic group
bigip_device_traffic_group:
name: foo1
state: present
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Create a traffic group with ha_group failover
bigip_device_traffic_group:
name: foo2
state: present
ha_group: foo_HA_grp
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Create a traffic group with ha_order failover
bigip_device_traffic_group:
name: foo3
state: present
ha_order:
- /Common/bigip1.lab.local
- /Common/bigip2.lab.local
auto_failback: true
auto_failback_time: 40
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Change traffic group ha_order to ha_group
bigip_device_traffic_group:
name: foo3
state: present
ha_group: foo_HA_grp
ha_order: ""
auto_failback: false
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Remove traffic group
bigip_device_traffic_group:
name: foo
state: absent
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
返回值
常见的返回值记录在此处，以下是此模块特有的字段
键 |
描述 |
|---|---|
指定流量组是否故障恢复到 ha_order 中指定的初始设备。 返回: 已更改 示例: |
|
指定系统在故障恢复之前延迟的秒数。 返回: 已更改 示例: |
|
与流量组关联的配置的 HA 组。 返回: 已更改 示例: |
|
流量组向系统呈现的相对于其他流量组的负载值。 返回: 已更改 示例: |
|
指定设备将进行故障转移的顺序。 返回: 已更改 示例: |
|
MAC 伪装地址 返回: 已更改 示例: |