f5networks.f5_modules.bigiq_application_fasthttp 模块 – 管理 BIG-IQ FastHTTP 应用程序

注意

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

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

要安装它,请使用: ansible-galaxy collection install f5networks.f5_modules

要在 playbook 中使用它,请指定: f5networks.f5_modules.bigiq_application_fasthttp

f5networks.f5_modules 1.0.0 中的新增功能

概要

  • 管理用于负载平衡基于 HTTP 的应用程序的 BIG-IQ 应用程序,加快连接速度并减少到后端服务器的连接数。

参数

参数

注释

add_analytics

布尔值

收集应用程序部署到的 BIG-IP 的统计信息。

此参数仅在指定作为 BIG-IP(而不是 SSG)的 service_environment 时才相关。

选项

  • false ← (默认)

  • true

description

字符串

应用程序的描述。

inbound_virtual

字典

配置接收入站连接的虚拟服务器的设置。

此虚拟服务器用于托管应用程序的 HTTP 端点。

address

字符串 / 必需

指定虚拟服务器将流量发送到的目标 IP 地址信息。

创建新应用程序时,此参数为必需参数。

netmask

字符串 / 必需

指定要与给定的 destination 关联的网络掩码。

创建新应用程序时,此参数为必需参数。

port

整数

虚拟服务器侦听连接的端口。

创建新应用程序时,如果未指定此参数,则默认值为 80

默认值: 80

name

字符串 / 必需

新应用程序的名称。

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 ← (默认)

servers

列表 / 元素=字典

托管应用程序的服务器列表。

如果您熟悉其他 BIG-IP 设置,您也可以将此列表称为池成员列表。

创建新应用程序时,至少需要一个服务器。

address

字符串 / 必需

服务器的 IP 地址。

port

整数

服务器的端口。

创建新应用程序并指定服务器时,如果未提供此参数,则默认值为 80

默认值: 80

service_environment

字符串

指定应用程序所属的服务环境的名称。

创建新应用程序时,此参数为必需参数。

本模块会自动发现服务环境类型。因此,至关重要的是,您要为不同服务环境类型(目前为 SSG 和 BIGIP)中的项目维护唯一的名称。

状态

字符串

系统上资源的状态。

当为 present 时,保证资源以提供的属性存在。

当为 absent 时,从系统中移除资源。

选项

  • "absent"

  • "present" ← (默认)

等待

布尔值

如果模块应该等待应用程序被创建、删除或更新。

选项

  • false

  • true ← (默认)

注意事项

注意

  • 本模块不支持更新您的应用程序(无论是否已部署)。如果您需要更新应用程序,我们建议删除并重新创建它。

  • 此模块不适用于 BIG-IQ 6.1.x 或更高版本。

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

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

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

示例

- name: BIG-IQ CM an HTTP application on port 80 on BIG-IP
  bigiq_application_fasthttp:
    name: my-app
    description: Fast HTTP
    service_environment: my-ssg
    servers:
      - address: 1.2.3.4
        port: 8080
      - address: 5.6.7.8
        port: 8080
    inbound_virtual:
      name: foo
      address: 2.2.2.2
      netmask: 255.255.255.255
      port: 80
    provider:
      password: secret
      server: cm.mydomain.com
      user: admin
    state: present
  delegate_to: localhost

返回值

通用返回值记录在这里,以下是此模块独有的字段

描述

description

字符串

资源应用程序的新描述。

返回: 已更改

示例: "我的应用程序"

inbound_virtual_destination

字符串

创建的虚拟目标的地址。

返回: 已更改

示例: "6.7.8.9"

inbound_virtual_netmask

字符串

提供的入站目标的网络掩码。

返回: 已更改

示例: "255.255.255.0"

inbound_virtual_port

整数

入站虚拟地址监听的端口。

返回: 已更改

示例: 80

servers

复杂

构成应用程序的服务器及其端口的列表。

返回: 已更改

示例: "值的哈希/字典"

address

字符串

服务器的 IP 地址。

返回: 已更改

示例: "2.3.4.5"

port

整数

服务器监听的端口。

返回: 已更改

示例: 8080

service_environment

字符串

部署服务的环境。

返回: 已更改

示例: "my-ssg1"

作者

  • Tim Rupp (@caphrim007)