f5networks.f5_modules.bigip_qkview 模块 – 管理设备上的 QKviews
注意
此模块是 f5networks.f5_modules 集合 (版本 1.32.1) 的一部分。
如果您正在使用 ansible
包,则可能已安装此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用: ansible-galaxy collection install f5networks.f5_modules
。
要在剧本中使用它,请指定: f5networks.f5_modules.bigip_qkview
。
f5networks.f5_modules 1.0.0 中的新增功能
概要
管理从 BIG-IP 创建和下载 QKviews。qkview 实用程序会自动从 BIG-IP 系统收集配置和诊断信息,并将数据组合到 QKView 文件中。F5 支持可能要求您发送或上传此 QKview 以协助进行故障排除。
参数
参数 |
注释 |
---|---|
当 选项
|
|
在 QKview 中包含完整(所有适用)的信息。 选项
|
|
您要保存 QKview 的本地文件系统上的目标位置。 |
|
从 QKview 中排除各种文件。 选项
|
|
从 QKview 中排除核心文件。 选项
|
|
要在远程 BIG-IP 上创建的 QKview 文件的名称。 默认值: |
|
如果 选项
|
|
QKview 文件的最大文件大小(以字节为单位)。默认情况下,不指定最大文件大小。 |
|
如果 选项
|
|
包含连接详细信息的字典对象。 |
|
配置 auth 提供程序以从远程设备获取身份验证令牌。 此选项在使用 BIG-IQ 设备时才会真正使用。 |
|
如果 您可以通过设置环境变量 先前使用的变量 选项
|
|
用于连接到 BIG-IP 或 BIG-IQ 的用户帐户的密码。 您可以通过设置环境变量 |
|
BIG-IP 主机或 BIG-IQ 主机。 您可以通过设置环境变量 |
|
BIG-IP 服务器端口。 您可以通过设置环境变量 默认值: |
|
指定与网络设备通信的超时时间(以秒为单位),用于连接或发送命令。如果在操作完成之前超时,模块将出错。 |
|
配置连接到远程设备时要使用的传输连接。 选项
|
|
连接到 BIG-IP 或 BIG-IQ 的用户名。此用户必须在设备上具有管理权限。 您可以通过设置环境变量 |
|
如果 您可以通过设置环境变量 选项
|
备注
注意
此模块不包含“最大时间”或“限制为刀片”选项。
如果您使用此模块与 Ansible Tower 或 Ansible AWX 配合使用,则应了解这些 Ansible 产品如何在受限环境中执行作业。更多信息请参见此处 https://clouddocs.f5.com/products/orchestration/ansible/devel/usage/module-usage-with-tower.html
一些较长时间运行的任务可能会导致 BIG-IP 上的 REST 接口超时,为避免这种情况,请根据此知识库文章调整计时器 https://support.f5.com/csp/article/K94602685
有关使用 Ansible 管理 F5 网络设备的更多信息,请参见 https://ansible.org.cn/integrations/networks/f5。
要求 BIG-IP 软件版本 >= 12。
F5 模块仅操作 F5 产品的运行配置。为确保 BIG-IP 特定的配置持久保存到磁盘,请务必包含至少一项使用 f5networks.f5_modules.bigip_config 模块保存运行配置的任务。请参阅模块的文档,了解保存运行配置的正确使用方法。
示例
- name: Fetch a qkview from the remote device
bigip_qkview:
asm_request_log: true
exclude:
- audit
- secure
dest: /tmp/localhost.localdomain.qkview
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost