infoblox.nios_modules.nios_dtc_lbdn 模块 – 配置 Infoblox NIOS DTC LBDN

注意

此模块是 infoblox.nios_modules 集合 (版本 1.7.1) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install infoblox.nios_modules。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。

要在剧本中使用它，请指定： infoblox.nios_modules.nios_dtc_lbdn。

infoblox.nios_modules 1.1.0 中的新增功能

概要

  • 添加和/或删除 Infoblox NIOS 服务器上的 DTC 负载均衡域名 (LBDN) 对象实例。此模块使用通过 REST 的 Infoblox WAPI 接口管理 NIOS dtc:lbdn 对象。

要求

执行此模块的主机需要以下要求。

  • infoblox-client

参数

参数

注释

auth_zones

列表 / 元素=字符串

已链接的权威区域列表。

使用 *auth_zones* 时，必须至少指定一个 *patterns*

comment

字符串

配置要与该对象实例关联的文本字符串注释。提供的文本字符串将在对象实例上进行配置。

extattrs

字典

允许在对象实例上配置可扩展属性。此参数接受一组键/值对进行配置。

lb_method

字符串 / 必需

配置负载均衡方法。用于选择池。

选项

  • "GLOBAL_AVAILABILITY"

  • "RATIO"

  • "ROUND_ROBIN"

  • "TOPOLOGY"

name

字符串 / 必需

指定 DTC LBDN 的显示名称，与 DNS 无关。

patterns

列表 / 元素=字符串

指定用于模式匹配的 LBDN 通配符。

pools

列表 / 元素=字典

用于负载均衡的池。

pool

字符串 / 必需

提供要链接的池的名称

ratio

整数

提供池的权重

默认值： 1

provider

字典

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

cert

字符串

指定客户端证书文件，其中包含 x509 配置摘要，用于为与 NIOS 的远程实例的安全连接提供额外一层保护。

值也可以使用 INFOBLOX_CERT 环境变量指定。

host

字符串

指定用于通过 REST 连接到 NIOS WAPI 远程实例的 DNS 主机名或地址

值也可以使用 INFOBLOX_HOST 环境变量指定。

http_pool_connections

整数

在此处插入描述

默认值： 10

http_pool_maxsize

整数

在此处插入描述

默认值： 10

http_request_timeout

整数

接收响应之前要等待的时间量

值也可以使用 INFOBLOX_HTTP_REQUEST_TIMEOUT 环境变量指定。

默认值： 10

key

字符串

指定用于与证书一起加密的私钥文件，以便与 NIOS 的远程实例连接。

值也可以使用 INFOBLOX_KEY 环境变量指定。

max_results

整数

指定要返回的对象的最大数量，如果设置为负数，则当返回的对象数量超过设置值时，设备将返回错误。

值也可以使用 INFOBLOX_MAX_RESULTS 环境变量指定。

默认值： 1000

max_retries

整数

配置在连接被声明可用之前尝试重试的次数

值也可以使用 INFOBLOX_MAX_RETRIES 环境变量指定。

默认值： 3

password

字符串

指定用于向 NIOS 远程实例进行身份验证的密码。

值也可以使用 INFOBLOX_PASSWORD 环境变量指定。

silent_ssl_warnings

布尔值

在此处插入描述

选项

  • false

  • true ← (默认)

username

字符串

配置用于向 NIOS 远程实例进行身份验证的用户名。

值也可以使用 INFOBLOX_USERNAME 环境变量指定。

validate_certs

别名：ssl_verify

布尔值

布尔值，用于启用或禁用验证 SSL 证书

值也可以使用 INFOBLOX_SSL_VERIFY 环境变量指定。

选项

  • false ← (默认)

  • true

wapi_version

字符串

指定要使用的 WAPI 版本

值也可以使用 INFOBLOX_WAPI_VERSION 环境变量指定。

在 Ansible 2.8 之前，默认 WAPI 版本为 1.4

默认值： "2.12.3"

状态 (state)

字符串

配置 NIOS 服务器上对象实例的目标状态。当此值设置为 present 时，将在设备上配置该对象；当此值设置为 absent 时，将从设备中删除该值（如有必要）。

选项

  • "present" ← (默认)

  • "absent"

拓扑 (topology)

字符串

为 TOPOLOGY 负载均衡方法配置拓扑规则。

仅当 *lb_method* 设置为 TOPOLOGY 时才需要。

生存时间 (ttl)

整数

DTC LBDN 的生存时间 (TTL) 值。一个 32 位无符号整数，表示记录有效（缓存）的持续时间（以秒为单位）。零表示不应缓存记录。

类型 (types)

列表 / 元素=字符串

指定 LBDN 支持的资源记录类型列表。

只有当您将 provider 变量中的 wapi_version 变量设置为大于“2.6”的数字时，此选项才能正常工作。

选项

  • "A"

  • "AAAA"

  • "CNAME"

  • "NAPTR"

  • "SRV"

备注

注意

  • 此模块支持 check_mode。

  • 此模块必须在本地运行，可以通过指定 connection: local 来实现。

  • 请阅读 :ref:`nios_guide` 以获取有关如何将 Infoblox 与 Ansible 一起使用的更详细信息。

示例

- name: Configure a DTC LBDN
  infoblox.nios_modules.nios_dtc_lbdn:
    name: web.ansible.com
    lb_method: ROUND_ROBIN
    pools:
      - pool: web_pool
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to a DTC LBDN
  infoblox.nios_modules.nios_dtc_lbdn:
    name: web.ansible.com
    lb_method: ROUND_ROBIN
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a DTC LBDN from the system
  infoblox.nios_modules.nios_dtc_lbdn:
    name: web.ansible.com
    lb_method: ROUND_ROBIN
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

  • Mauricio Teixeira (@badnetmask)