f5networks.f5_modules.bigip_config 模块 – 管理 BIG-IP 配置节

注意

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

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

要安装它，请使用：ansible-galaxy collection install f5networks.f5_modules。

要在剧本中使用它，请指定：f5networks.f5_modules.bigip_config。

f5networks.f5_modules 1.0.0 中的新增功能

概要 

通过允许修改运行配置的 TMSH 命令或将 SCF 格式的文件合并到运行配置中来管理 BIG-IP 配置。此外，此模块非常重要，因为它允许您将运行配置保存到磁盘。由于所有 F5 模块都会操作运行配置，因此请务必使用此模块保存该运行配置。

参数 

参数	注释
merge_content 字符串	加载要合并到运行配置中的指定配置。这等效于使用 `tmsh` 命令 `load sys config from-terminal merge`。如果您需要从文件或模板读取配置，请分别使用 Ansible 的 `file` 或 `template` 查找插件。
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` ← （默认）
reset 布尔值	在设备上加载默认配置。如果指定了此选项，则在运行任何命令或其他提供的配置之前，会加载默认配置。选项 `false` ← （默认） `true`
save 布尔值	`save` 参数指示模块将运行配置保存到启动配置。此操作在对当前运行配置进行任何更改后执行。如果没有进行任何更改，配置仍会保存到启动配置。此选项始终导致模块返回 changed（已更改）。选项 `false` `true` ← （默认）
verify（验证）布尔值	验证指定的配置，以确定其是否可以替换运行配置。运行配置不会被更改。当此参数设置为 `true` 时，模块不会报告任何更改。选项 `false` ← （默认） `true`

注释 

注意

此模块要求设备上的 sys db 变量 systemauth.disablebash 设置为 false。
有关使用 Ansible 管理 F5 Networks 设备的更多信息，请参阅 https://ansible.org.cn/integrations/networks/f5。
需要 BIG-IP 软件版本 >= 12。
F5 模块仅操作 F5 产品的运行配置。为确保 BIG-IP 特定配置持久保存到磁盘，请务必至少包含一个使用 f5networks.f5_modules.bigip_config 模块保存运行配置的任务。有关正确使用该模块保存运行配置的信息，请参阅该模块的文档。

示例 

- name: Save the running configuration of the BIG-IP
  bigip_config:
    save: true
    provider:
      server: lb.mydomain.com
      password: secret
      user: admin
  delegate_to: localhost

- name: Reset the BIG-IP configuration, for example, to RMA the device
  bigip_config:
    reset: true
    save: true
    provider:
      server: lb.mydomain.com
      password: secret
      user: admin
  delegate_to: localhost

- name: Load an SCF configuration
  bigip_config:
    merge_content: "{{ lookup('file', '/path/to/config.scf') }}"
    provider:
      server: lb.mydomain.com
      password: secret
      user: admin
  delegate_to: localhost

返回值 

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

键	描述
stdout list / elements=string	来自选项的一组响应。返回：始终示例： `["...", "..."]`
stdout_lines list / elements=string	stdout 的值拆分为列表。返回：始终示例： `[["...", "..."], ["..."], ["..."]]`

作者

Tim Rupp (@caphrim007)