inspur.ispim.edit_dns 模块 – 设置 DNS 信息

注意

此模块是 inspur.ispim 集合 (版本 2.2.3) 的一部分。

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

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

要在 playbook 中使用它，请指定：inspur.ispim.edit_dns。

inspur.ispim 1.0.0 中的新增功能

概要 

在 Inspur 服务器上设置 DNS 信息。

要求 

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

Python 3.7+
inspursmsdk

参数 

参数	注释
dns_iface 字符串	DNS 接口，输入类似 ‘eth0’，‘eth1’，‘bond0’。当 dns_manual=auto 时必填。
dns_manual 字符串	DNS 设置。选项 `"manual"` `"auto"`
dns_priority 字符串	IP 优先级。当 dns_manual=auto 时必填。选项 `"4"` `"6"`
dns_server1 字符串	DNS 服务器 1 IPv4 或 IPv6 地址。当 dns_manual=manual 时必填。
dns_server2 字符串	DNS 服务器 2 IPv4 或 IPv6 地址。当 dns_manual=manual 时必填。
dns_server3 字符串	DNS 服务器 3 IPv4 或 IPv6 地址。当 dns_manual=manual 时必填。
dns_status 字符串	DNS 状态。选项 `"enable"` `"disable"`
domain_iface 字符串	网络接口，输入类似 ‘eth0_v4’，‘eth0_v6’，‘eth1_v4’，‘eth1_v6’，‘bond0_v4’，‘bond0_v6’。当 domain_manual=auto 时必填。
domain_manual 字符串	域名设置。选项 `"manual"` `"auto"`
domain_name 字符串	域名。当 domain_manual=manual 时必填。
host 字符串	指定通过指定的传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。
host_cfg 字符串	主机设置。选项 `"manual"` `"auto"`
host_name 字符串	主机名。当 host_cfg=manual 时必填。
password 字符串	指定用于验证到远程设备连接的密码。如果任务中未指定该值，则将改用环境变量 `ANSIBLE_NET_PASSWORD` 的值。
provider 字典	包含连接详细信息的字典对象。
host 字符串	指定通过指定的传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。
password 字符串	指定用于验证到远程设备连接的密码。如果任务中未指定该值，则将改用环境变量 `ANSIBLE_NET_PASSWORD` 的值。
username 字符串	配置用于验证到远程设备连接的用户名。如果任务中未指定该值，则将改用环境变量 `ANSIBLE_NET_USERNAME` 的值。
register_status1 字符串	BMC 注册状态 1。只有 M6 型号支持此参数。选项 `"enable"` `"disable"`
register_status2 字符串	BMC 注册状态 2。只有 M6 型号支持此参数。选项 `"enable"` `"disable"`
registration_method1 字符串	注册方法 1。只有 M6 型号支持此参数。当 register_status1=enable 时必填。选项 `"nsupdate"` `"dhcp"` `"hostname"`
registration_method2 字符串	注册方法 2。只有 M6 型号支持此参数。当 register_status2=enable 时必填。选项 `"nsupdate"` `"dhcp"` `"hostname"`
username 字符串	配置用于验证到远程设备连接的用户名。如果任务中未指定该值，则将改用环境变量 `ANSIBLE_NET_USERNAME` 的值。

注释 

注意

不支持 check_mode。

示例 

- name: DNS test
  hosts: ism
  connection: local
  gather_facts: no
  vars:
    ism:
      host: "{{ ansible_ssh_host }}"
      username: "{{ username }}"
      password: "{{ password }}"

  tasks:

  - name: "Set dns information"
    inspur.ispim.edit_dns:
      dns_status: "disable"
      provider: "{{ ism }}"

  - name: "Set dns information"
    inspur.ispim.edit_dns:
      dns_status: "enable"
      host_cfg: "manual"
      host_name: "123456789"
      domain_manual: "auto"
      domain_iface: "eth0_v4"
      dns_manual: "manual"
      dns_server1: "100.2.2.2"
      dns_server2: "100.2.2.3"
      dns_server3: "100.2.2.4"
      provider: "{{ ism }}"

  - name: "Set dns information"
    inspur.ispim.edit_dns:
      dns_status: "enable"
      host_cfg: "manual"
      host_name: "123456789"
      domain_manual: "manual"
      domain_name: "inspur.com"
      dns_manual: "auto"
      dns_iface: "eth0"
      dns_priority: "4"
      provider: "{{ ism }}"

返回值 

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

键	描述
changed 布尔值	检查设备上是否进行了更改。返回：始终
message 字符串	模块执行后返回的消息。返回：始终
state 字符串	模块执行后的状态。返回：始终

作者

王保山 (@ispim)