f5networks.f5_modules.bigip_asm_policy_server_technology 模块 – 管理 ASM 策略上的服务器技术

注意

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

f5networks.f5_modules 1.0.0 中的新增功能

摘要

  • 管理 ASM 策略上的服务器技术。

参数

参数

注释

name

字符串 / 必需

指定要在 ASM 策略上应用或从中删除的服务器技术的名称。

选项

  • "jQuery"

  • "Java Servlets/JSP"

  • "ASP"

  • "WebDAV"

  • "IIS"

  • "Front Page Server Extensions (FPSE)"

  • "ASP.NET"

  • "Microsoft Windows"

  • "Unix/Linux"

  • "Macromedia ColdFusion"

  • "WordPress"

  • "Apache Tomcat"

  • "Apache/NCSA HTTP Server"

  • "Outlook Web Access"

  • "PHP"

  • "Microsoft SQL Server"

  • "Oracle"

  • "MySQL"

  • "Lotus Domino"

  • "BEA Systems WebLogic Server"

  • "Macromedia JRun"

  • "Novell"

  • "Cisco"

  • "SSI (Server Side Includes)"

  • "Proxy Servers"

  • "CGI"

  • "Sybase/ASE"

  • "IBM DB2"

  • "PostgreSQL"

  • "XML"

  • "Apache Struts"

  • "Elasticsearch"

  • "JBoss"

  • "Citrix"

  • "Node.js"

  • "Django"

  • "MongoDB"

  • "Ruby"

  • "JavaServer Faces (JSF)"

  • "Joomla"

  • "Jetty"

partition

字符串

此参数仅在标识 ASM 策略时使用。

默认值： "Common"

policy_name

字符串 / 必需

指定要向其添加或从中删除服务器技术的现有 ASM 策略的名称。

provider

字典

f5networks.f5_modules 1.0.0 中新增

包含连接详细信息的字典对象。

auth_provider

字符串

配置 auth 提供程序，以从远程设备获取身份验证令牌。

此选项在使用 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 ← (默认)

state

字符串

当 present 时，确保资源存在。

当 absent 时，确保资源被删除。

选项

  • "present" ← (默认)

  • "absent"

备注

注意

  • 此模块主要用作在 Ansible Galaxy ASM 策略角色中配置 ASM 策略的组件。

  • 需要 BIG-IP >= 13.0.0

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

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

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

示例

- name: Add Server Technology to ASM Policy
  bigip_asm_policy_server_technology:
    name: Joomla
    policy_name: FooPolicy
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost
- name: Remove Server Technology from ASM Policy
  bigip_asm_policy_server_technology:
    name: Joomla
    policy_name: FooPolicy
    state: absent
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

返回值

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

键

描述

name

字符串

在 ASM 策略中添加/删除的服务器技术的名称。

返回：changed

示例： "Joomla"

policy_name

字符串

ASM 策略的名称

返回：changed

示例： "FooPolicy"

作者

  • Wojciech Wypior (@wojtek0806)