kaytus.ksmanage.edit_kvm 模块 – 设置 KVM

注意

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

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

要安装它,请使用:ansible-galaxy collection install kaytus.ksmanage。您需要进一步的要求才能使用此模块,请参阅 要求 以了解详细信息。

要在 playbook 中使用它,请指定:kaytus.ksmanage.edit_kvm

kaytus.ksmanage 1.0.0 中的新增功能

概要

  • 在 kaytus 服务器上设置 KVM。

要求

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

  • Python 3.7+

  • inManage

参数

参数

注释

automatic_off

字符串

当 KVM 启动时自动关闭服务器监视器。

选择

  • "enable"

  • "disable"

client_type

字符串

客户端类型。

只有 M6 型号支持此参数。

选择

  • "vnc"

  • "viewer"

host

字符串

指定用于通过指定的传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。

keyboard_language

字符串

选择键盘语言。

AD 是自动检测,DA 是丹麦语,NL-BE 是荷兰语比利时,NL-NL 是荷兰语荷兰。

GB 是英语英国,US 是英语美国,FI 是芬兰语,FR-BE 是法语比利时,FR 是法语法国。

DE 是德语德国,DE-CH 是德语瑞士,IT 是意大利语,JP 是日语。

NO 是挪威语,PT 是葡萄牙语,ES 是西班牙语,SV 是瑞典语,TR_F 是土耳其语 F,TR_Q 是土耳其语 Q。

选择

  • "AD"

  • "DA"

  • "NL-BE"

  • "NL-NL"

  • "GB"

  • "US"

  • "FI"

  • "FR-BE"

  • "FR"

  • "DE"

  • "DE-CH"

  • "IT"

  • "JP"

  • "ON"

  • "PT"

  • "EC"

  • "SV"

  • "TR_F"

  • "TR_Q"

kvm_encryption

字符串

加密 KVM 数据包。

选择

  • "enable"

  • "disable"

local_monitor_off

字符串

服务器监视器关闭功能状态。

选择

  • "enable"

  • "disable"

media_attach

字符串

有两种类型的 VM 连接模式可用。

Attach 是在启动时立即将虚拟媒体附加到服务器。

Auto 是仅在启动虚拟媒体会话时才将虚拟媒体附加到服务器。

只有 M5 型号支持此参数。

选择

  • "attach"

  • "auto"

non_secure

字符串

启用/禁用非安全连接类型。

只有 M6 型号支持此参数。

client_type=vnc 时必需。

选择

  • "enable"

  • "disable"

password

字符串

指定用于验证与远程设备连接的密码。如果任务中未指定值,则将使用环境变量 ANSIBLE_NET_PASSWORD 的值。

provider

字典

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

host

字符串

指定用于通过指定的传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。

password

字符串

指定用于验证与远程设备连接的密码。如果任务中未指定值,则将使用环境变量 ANSIBLE_NET_PASSWORD 的值。

username

字符串

配置用于验证与远程设备连接的用户名。如果任务中未指定值,则将使用环境变量 ANSIBLE_NET_USERNAME 的值。

retry_count

整数

如果发生 KVM 故障,则重试的次数。重试计数范围为 1 到 20。

只有 M5 型号支持此参数。

retry_time_interval

整数

重试时间间隔配置的标识(5-30)秒。

只有 M5 型号支持此参数。

ssh_vnc

字符串

在 BMC 中启用/禁用通过 SSH 的 VNC。

只有 M6 型号支持此参数。

client_type=vnc 时必需。

选择

  • "enable"

  • "disable"

stunnel_vnc

字符串

在 BMC 中启用/禁用通过 Stunnel 的 VNC。

只有 M6 型号支持此参数。

client_type=vnc 时必需。

选择

  • "enable"

  • "disable"

username

字符串

配置用于验证与远程设备连接的用户名。如果任务中未指定值,则将使用环境变量 ANSIBLE_NET_USERNAME 的值。

注释

注意

  • 不支持 check_mode

示例

- name: KVM test
  hosts: ksmanage
  connection: local
  gather_facts: false
  vars:
    ksmanage:
      host: "{{ ansible_ssh_host }}"
      username: "{{ username }}"
      password: "{{ password }}"

  tasks:

  - name: "Set KVM"
    kaytus.ksmanage.edit_kvm:
      kvm_encryption: "enable"
      media_attach: "auto"
      keyboard_language: "AD"
      retry_count: 13
      retry_time_interval: 10
      local_monitor_off: "enable"
      automatic_off: "enable"
      provider: "{{ ksmanage }}"

返回值

常见的返回值记录在 此处,以下是此模块独有的字段

描述

changed

布尔值

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

返回: 始终

message

字符串

模块执行后返回的消息。

返回: 始终

state

字符串

模块执行后的状态。

返回: 始终

作者

  • WangBaoshan (@ieisystem)