kaytus.ksmanage.edit_dns 模块 – 设置 DNS 信息

注意

此模块是 kaytus.ksmanage 集合 (版本 2.0.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：kaytus.ksmanage.edit_dns。

kaytus.ksmanage 1.0.0 中的新增功能

概要

  • 在 kaytus 服务器上设置 DNS 信息。

要求

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

  • Python 3.7+

  • inManage

参数

参数

注释

dns_iface

字符串

DNS 接口，输入例如 ‘eth0’，‘eth1’，‘bond0’。

当 dns_manual=auto 时必填。

dns_manual

字符串

DNS 设置。选择 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: ksmanage
  connection: local
  gather_facts: false
  vars:
    ksmanage:
      host: "{{ ansible_ssh_host }}"
      username: "{{ username }}"
      password: "{{ password }}"

  tasks:

  - name: "Set dns information"
    kaytus.ksmanage.edit_dns:
      dns_status: "disable"
      provider: "{{ ksmanage }}"

  - name: "Set dns information"
    kaytus.ksmanage.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: "{{ ksmanage }}"

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

返回值

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

键

描述

changed

布尔值

检查设备上是否进行了更改。

返回值：始终

message

字符串

模块执行后返回的消息。

返回值：始终

state

字符串

模块执行后的状态。

返回值：始终

作者

  • 王宝山 (@ieisystem)