infoblox.nios_modules.nios_member 模块 – 配置 Infoblox NIOS 成员
注意
此模块是 infoblox.nios_modules 集合 (版本 1.7.1) 的一部分。
如果您正在使用 ansible 包,则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list。
要安装它,请使用:ansible-galaxy collection install infoblox.nios_modules。您需要其他要求才能使用此模块,有关详细信息,请参阅 要求。
要在剧本中使用它,请指定:infoblox.nios_modules.nios_member。
infoblox.nios_modules 1.0.0 中的新增功能
概要
- 添加和/或删除 Infoblox NIOS 服务器。此模块使用 Infoblox WAPI 接口通过 REST 管理 NIOS - member对象。
要求
执行此模块的主机需要以下要求。
- infoblox-client 
参数
| 参数 | 注释 | 
|---|---|
| 网格成员的描述性注释。 | |
| 地址配置类型 (IPV4/IPV6/BOTH)。 默认值:  | |
| 为预配置成员启动创建令牌请求的标志。 选项 
 | |
| 如果设置为 True,则成员有两个物理节点(HA 对)。 选项 
 | |
| 与对象关联的可扩展属性。 | |
| 确定是否应启用外部 syslog 服务器。 选项 
 | |
| 指定要添加到或从 NIOS 实例中删除的成员的主机名。用户还可以更新名称,因为可以传递包含 *new_name*、*old_name* 的字典。请参阅示例。 | |
| 配置网格成员的 IPv6 设置。 | |
| 网格成员的 IPv6 CIDR 前缀 | |
| 网格成员的网关地址 | |
| 网格成员的 IPv6 地址 | |
| 设置为“true”时,LAN2 端口将作为独立端口或用于故障转移的端口启用。 选项 
 | |
| 如果 'lan2_enabled' 设置为“true”,则为网格成员 LAN2 端口设置。 | |
| 如果设置为 True,则它具有自己的 IP 设置。 选项 
 | |
| 如果 'enable' 字段设置为 True,则定义 LAN2 的 IPv4 网络设置。 | |
| LAN2 的 IPv4 地址 | |
| LAN2 的默认网关 | |
| LAN2 的子网掩码 | |
| 如果 'enable' 字段设置为 True,则定义 LAN2 的 IPv6 网络设置。 | |
| LAN2 的 IPv6 CIDR 前缀 | |
| LAN2 的网关地址 | |
| LAN2 的 IPv6 地址 | |
| 将此对象的实例配置为启用为网格主候选者或常规成员节点。 True 将成员启用为主候选者 选项 
 | |
| 成员 MGMT 端口的设置。 | |
| 确定是否应启用 MGMT 端口设置。 选项 
 | |
| 确定 MGMT 端口上的安全访问是否启用。 选项 
 | |
| 确定 MGMT 端口上的 VPN 是否启用。 选项 
 | |
| 使用关于网格成员操作的详细状态报告配置节点信息列表。 | |
| LAN2 接口的物理端口设置。 | |
| 启用或禁用自动端口设置。 选项 
 | |
| 端口双工;如果速度为 1000,则双工必须为 FULL。 | |
| 端口速度;如果速度为 1000,则双工为 FULL。 | |
| 节点的 LAN/HA 端口设置。 | |
| HA IP 地址。 | |
| HA 接口的物理端口设置。 | |
| 启用或禁用自动端口设置。 选项 
 | |
| 端口双工;如果速度为 1000,则双工必须为 FULL。 | |
| 端口速度;如果速度为 1000,则双工为 FULL。 | |
| LAN 接口的物理端口设置。 | |
| 启用或禁用自动端口设置。 选项 
 | |
| 端口双工;如果速度为 1000,则双工必须为 FULL。 | |
| 端口速度;如果速度为 1000,则双工为 FULL。 | |
| LAN1 接口的公共 IPv6 地址。 | |
| LAN1 接口的公共 IPv4 地址。 | |
| 节点 MGMT 端口的网络设置。 | |
| MGMT 的 IPv4 地址 | |
| MGMT 的默认网关 | |
| MGMT 的子网掩码 | |
| 节点 IPv6 MGMT 端口的网络设置。 | |
| MGMT 的 IPv6 CIDR 前缀 | |
| MGMT 的网关地址 | |
| MGMT 的 IPv6 地址 | |
| 配置硬件平台。 默认值:  | |
| 预配置信息。 | |
| 描述正在预配置的硬件的结构数组。 | |
| 硬件型号 | |
| 硬件类型。 | |
| 许可证类型的数组。 | |
| 包含连接详细信息的字典对象。 | |
| 指定客户端证书文件,其中包含 x509 配置摘要,用于为与 NIOS 远程实例的连接提供额外的安全层。 值也可以使用  | |
| 指定用于通过 REST 连接到 NIOS WAPI 远程实例的 DNS 主机名或地址。 值也可以使用  | |
| 此处插入描述 默认值:  | |
| 此处插入描述 默认值:  | |
| 等待接收响应之前的时间量 值也可以使用  默认值:  | |
| 指定私钥文件,用于与证书一起进行加密,以便连接到 NIOS 的远程实例。 值也可以使用  | |
| 指定要返回的对象的最大数量,如果设置为负数,则当返回的对象数量超过设置值时,设备将返回错误。 值也可以使用  默认值:  | |
| 配置在声明连接可用之前尝试重试的次数 值也可以使用  默认值:  | |
| 指定用于验证与 NIOS 远程实例连接的密码。 值也可以使用  | |
| 此处插入描述 选项 
 | |
| 配置用于验证与 NIOS 远程实例连接的用户名。 值也可以使用  | |
| 布尔值,用于启用或禁用验证 SSL 证书 值也可以使用  选项 
 | |
| 指定要使用的 WAPI 版本 值也可以使用  在 Ansible 2.8 之前,默认 WAPI 为 1.4 默认值:  | |
| 虚拟路由器标识符。如果“ha_enabled”设置为“true”,则提供此 ID。这是本地子网的唯一 VRID 号码(从 1 到 255)。 | |
| 配置 NIOS 服务器上对象的实例的预期状态。当此值设置为  选项 
 | |
| 外部 syslog 服务器列表。 | |
| 服务器地址。 | |
| 所有 syslog 日志类别的列表。 | |
| 与该服务器通信的连接类型。(STCP/TCP?UDP) 默认值:  | |
| 设备通过该接口将 syslog 消息发送到 syslog 服务器。(ANY/LAN/MGMT) 默认值:  | |
| 标识 syslog 消息中的节点。(HOSTNAME/IP_HOSTNAME/LAN/MGMT) 默认值:  | |
| 要发送到外部 syslog 服务器的 syslog 消息的来源。 默认值:  | |
| 选定的 syslog 日志类别列表。设备转发属于选定类别的 syslog 消息。 选项 
 | |
| 此服务器监听的端口。 默认值:  | |
| 严重性过滤器。设备将指定严重性及以上级别的日志消息发送到外部 syslog 服务器。 默认值:  | |
| 此 Grid 成员所属的升级组的名称。 默认值:  | |
| 用于 external_syslog_server_enable、syslog_servers、syslog_proxy_setting、syslog_size 的使用标志。 选项 
 | |
| 配置 Grid 成员的网络设置。 | |
| Grid 成员的 IPv4 地址 | |
| Grid 成员的默认网关 | |
| Grid 成员的子网掩码 | 
注释
注意
- 此模块支持 - check_mode。
- 此模块必须在本地运行,这可以通过指定 - connection: local来实现。
- 请阅读 :ref:`nios_guide` 以了解有关如何将 Infoblox 与 Ansible 一起使用的更详细信息。 
示例
- name: Add a member to the grid with IPv4 address
  infoblox.nios_modules.nios_member:
    host_name: member01.localdomain
    vip_setting:
      - address: 192.168.1.100
        subnet_mask: 255.255.255.0
        gateway: 192.168.1.1
    config_addr_type: IPV4
    platform: VNIOS
    comment: "Created by Ansible"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Add a Grid Master Candidate to the grid with IPv4 address
  infoblox.nios_modules.nios_member:
    host_name: member01.localdomain
    master_candidate: true
    vip_setting:
      - address: 192.168.1.100
        subnet_mask: 255.255.255.0
        gateway: 192.168.1.1
    config_addr_type: IPV4
    platform: VNIOS
    comment: "Created by Ansible"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Update host name of member
  infoblox.nios_modules.nios_member:
    host_name: {old_name: block1.localdomain, new_name: member01.localdomain}
    master_candidate: false
    vip_setting:
      - address: 120.0.0.25
        subnet_mask: 255.255.255.0
        gateway: 120.0.0.1
    config_addr_type: IPV4
    platform: VNIOS
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Add a HA member to the grid
  infoblox.nios_modules.nios_member:
    host_name: memberha.localdomain
    vip_setting:
      - address: 192.168.1.100
        subnet_mask: 255.255.255.0
        gateway: 192.168.1.1
    config_addr_type: IPV4
    platform: VNIOS
    enable_ha: true
    router_id: 150
    node_info:
      - lan_ha_port_setting:
          - ha_ip_address: 192.168.1.70
            mgmt_lan: 192.168.1.80
      - lan_ha_port_setting:
          - ha_ip_address: 192.168.1.71
            mgmt_lan: 192.168.1.81
    comment: "Created by Ansible"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Update the member with pre-provisioning details specified
  infoblox.nios_modules.nios_member:
    name: member01.localdomain
    pre_provisioning:
      - hardware_info:
          - hwmodel: IB-VM-820
            hwtype: IB-VNIOS
        licenses:
          - dns
          - dhcp
          - enterprise
          - vnios
    comment: "Updated by Ansible"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Remove the member
  infoblox.nios_modules.nios_member:
    name: member01.localdomain
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
