f5networks.f5_modules.bigip_virtual_address 模块 – 在 BIG-IP 上管理 LTM 虚拟地址

注意

此模块是 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_virtual_address。

f5networks.f5_modules 1.0.0 中的新增功能

概要

• 管理 BIG-IP 系统上的 LTM 虚拟地址。

参数

参数	注释
address 字符串	指定虚拟地址。此值设置后无法修改。 如果您从未创建过虚拟地址，但创建了虚拟服务器，则会自动为每个虚拟服务器创建一个虚拟地址。此虚拟地址的名称是其 IP 地址值。
arp 布尔值	指定系统是否接受 ARP 请求。 当 false 时，指定系统不接受 ARP 请求。 当 true 时，数据包将被丢弃。 为了使使用该虚拟地址的转发虚拟服务器转发 ICMP 数据包，必须禁用 ARP 和 ICMP Echo。 创建新的虚拟地址时，如果未指定此参数，则默认值为 true。 选项 false true
auto_delete 布尔值	指定系统是否在删除最后一个关联的虚拟服务器时自动删除虚拟地址。当 false 时，指定系统保留虚拟地址，即使所有关联的虚拟服务器都已删除。创建虚拟地址时，默认值为 true。 选项 false true
availability_calculation 别名：advertise_route 字符串	指定系统通告虚拟地址的哪些路由。当 when_any_available 时，任何虚拟服务器可用时都通告路由。当 when_all_available 时，所有虚拟服务器都可用时才通告路由。当 (always) 时，无论虚拟服务器是否可用，始终通告路由。 选项 "always" "when_all_available" "when_any_available"
connection_limit 整数	指定系统在此虚拟地址上允许的并发连接数。
icmp_echo 字符串	指定系统如何基于每个虚拟地址发送对 (ICMP) echo 请求的响应，以启用路由通告。当 enabled 时，BIG-IP 系统会拦截 ICMP echo 请求数据包并直接对其进行响应。当 disabled 时，BIG-IP 系统会将 ICMP echo 请求传递给后端服务器。当 (selective) 时，导致 BIG-IP 系统根据虚拟服务器状态内部启用或禁用响应；when_any_available、when_all_available 或 C(always，与任何虚拟服务器的状态无关。 选项 "enabled" "disabled" "selective"
name 字符串	虚拟地址的名称。 如果未提供此参数，系统将使用 address 的值。
netmask 字符串	指定提供的虚拟地址的网络掩码。此值设置后无法修改。 创建新的虚拟地址时，如果未指定此参数，则 IPv4 地址的默认值为 255.255.255.255，IPv6 地址的默认值为 ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff。
partition 字符串	要在其上管理资源的设备分区。 默认值： "Common"
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
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 ← (默认)
route_advertisement 字符串	指定系统是否为此虚拟地址使用路由通告。 禁用时，系统不会通告此虚拟地址的路由。 这些选项中的大多数仅在 13.0.0-HF1 或更高版本中受支持。在低于此版本的版本中，所有选项（disabled 除外）都将转换为 enabled。 当为 always 时，BIG-IP 系统始终通告虚拟地址的路由，而不管可用性状态如何。这需要一个 enabled 的虚拟地址。 当为 enabled 时，BIG-IP 系统根据可用性计算中的计算方法，通告可用虚拟地址的路由。 当为 disabled 时，BIG-IP 系统不会通告虚拟地址的路由，而不管可用性状态如何。 当为 selective 时，您还可以选择性地启用 ICMP 回显响应，这会导致 BIG-IP 系统根据虚拟服务器状态内部启用或禁用响应。 当为 any 时，当任何虚拟服务器可用时，BIG-IP 系统都会通告虚拟地址的路由。 当为 all 时，当所有虚拟服务器都可用时，BIG-IP 系统才会通告虚拟地址的路由。 选项 "disabled" "enabled" "always" "selective" "any" "all"
route_domain 字符串	您要使用的 address 的路由域。 此值设置后无法修改。
spanning 布尔值	使设备组中的所有 BIG-IP 系统都能侦听和处理同一虚拟地址上的流量。 当您在设备上启用 spanning 选项，然后将虚拟地址同步到设备组的其他成员时，就会发生虚拟地址的扩展。 扩展还依赖于上游路由器使用 ECMP 路由将应用程序流分发到 BIG-IP 系统。ECMP 使用在每个 BIG-IP 系统上配置的不同浮动自 IP 地址来定义到虚拟地址的路由。 启用 Spanning 时，还必须配置 MAC 伪装地址并禁用虚拟地址上的 arp。 创建新的虚拟地址时，如果未指定此参数，则默认值为 false。 选项 false true
state 字符串	虚拟地址状态。如果为 absent，系统将尝试删除虚拟地址。只有当此虚拟地址未被虚拟服务器使用时，此操作才会成功。present 创建虚拟地址并启用它。如果为 enabled，则如果虚拟地址存在，则启用它。如果为 disabled，则根据需要创建虚拟地址，并将状态设置为 disabled。 选项 "present" ← (默认) "absent" "enabled" "disabled"
traffic_group 字符串	虚拟地址的流量组。创建新地址时，如果未指定此值，则默认为 /Common/traffic-group-1。

备注

注意

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

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

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

示例

- name: Add virtual address
  bigip_virtual_address:
    state: present
    partition: Common
    address: 10.10.10.10
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Enable route advertisement on the virtual address
  bigip_virtual_address:
    state: present
    address: 10.10.10.10
    route_advertisement: any
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

返回值

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

键	描述
address 整数	虚拟地址的地址。 已返回：created 示例： 2345
arp 布尔值	虚拟地址处理 ARP 请求的新方法。 已返回：changed 示例： true
auto_delete 布尔值	自动删除虚拟地址的新设置。 已返回：changed 示例： true
availability_calculation 字符串	指定系统通告虚拟地址的哪些路由。 已返回：changed 示例： "always"
connection_limit 整数	虚拟地址的新连接限制。 已返回：changed 示例： 1000
icmp_echo 字符串	应用于虚拟地址的新 ICMP 回显设置。 已返回：changed 示例： "disabled"
netmask 整数	虚拟地址的网络掩码。 已返回：created 示例： 2345
spanning 字符串	是否启用扩展。 已返回：changed 示例： "disabled"
state 字符串	虚拟地址的新状态。 已返回：changed 示例： "disabled"

作者

• Tim Rupp (@caphrim007)

• Wojciech Wypior (@wojtek0806)

资源链接

• 问题追踪器
• 主页
• 代码仓库