ngine_io.cloudstack.cs_host 模块 – 管理基于 Apache CloudStack 云的宿主机。

注意

此模块是 ngine_io.cloudstack 集合 (版本 2.5.0) 的一部分。

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

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

要在剧本中使用它，请指定：ngine_io.cloudstack.cs_host。

ngine_io.cloudstack 0.1.0 中的新增功能

概要

• 创建、更新和删除宿主机。

要求

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

• python >= 2.6

• cs >= 0.9.0

参数

参数	注释
allocation_state 字符串	宿主机分配状态。 选项 "enabled" "disabled" "maintenance"
api_http_method 字符串	用于查询 API 端点的 HTTP 方法。 如果未提供，则考虑 CLOUDSTACK_METHOD 环境变量。 选项 "get" ← (默认) "post"
api_key 字符串 / 必需	CloudStack API 的 API 密钥。 如果未提供，则考虑 CLOUDSTACK_KEY 环境变量。
api_secret 字符串 / 必需	CloudStack API 的密钥。 如果未设置，则考虑 CLOUDSTACK_SECRET 环境变量。
api_timeout 整数	HTTP 超时时间（秒）。 如果未提供，则考虑 CLOUDSTACK_TIMEOUT 环境变量。 默认值： 10
api_url 字符串 / 必需	CloudStack API 的 URL，例如 https://cloud.example.com/client/api。 如果未提供，则考虑 CLOUDSTACK_ENDPOINT 环境变量。
api_verify_ssl_cert 字符串	验证 CA 授权证书文件。 如果未提供，则考虑 CLOUDSTACK_VERIFY 环境变量。
cluster 字符串	集群名称。
host_tags 别名：host_tag 列表 / 元素=字符串	宿主机标签。
hypervisor 字符串	集群名称。 如果 state=present 且宿主机尚不存在，则为必需。 可能的值为 KVM、VMware、BareMetal、XenServer、LXC、HyperV、UCS、OVM、Simulator。
name 别名：ip_address 字符串 / 必需	宿主机名称。
password 字符串	宿主机密码。 如果 state=present 且宿主机尚不存在，则为必需。
pod 字符串	Pod 名称。 如果 state=present 且宿主机尚不存在，则为必需。
state 字符串	宿主机状态。 选项 "present" ← (默认) "absent"
url 字符串	用于创建宿主机的宿主机 URL。 如果未提供，则使用 http:// 和参数 name 作为 url。 仅当 state=present 且宿主机尚不存在时才考虑。
username 字符串	宿主机用户名。 如果 state=present 且宿主机尚不存在，则为必需。
validate_certs 布尔值 ngine_io.cloudstack 2.4.0 中新增	如果为 false，则不会验证 SSL 证书。 如果未提供，则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。 这仅应在使用自签名证书的个人控制站点上使用。 选项 false true ← (默认)
zone 字符串 / 必需	应部署宿主机的区域名称。

注释

注意

• 有关 cloudstack 模块的详细指南，请参阅 CloudStack 云指南。

• 此模块支持检查模式。

示例

- name: Ensure a host is present but disabled
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    cluster: vcenter.example.com/zone01/cluster01
    pod: pod01
    zone: zone01
    hypervisor: VMware
    allocation_state: disabled
    host_tags:
    - perf
    - gpu

- name: Ensure an existing host is disabled
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    zone: zone01
    allocation_state: disabled

- name: Ensure an existing host is enabled
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    zone: zone01
    allocation_state: enabled

- name: Ensure a host is absent
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    zone: zone01
    state: absent

返回值

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

键	描述
allocation_state 字符串	宿主机分配状态。 返回： success 示例： "enabled"
capabilities 字符串	宿主机功能。 返回： success 示例： "hvm"
cluster 字符串	宿主机所属的集群。 返回： success 示例： "vcenter.example.com/zone/cluster01"
cluster_type 字符串	宿主机所属集群的类型。 返回： success 示例： "ExternalManaged"
cpu_allocated 字符串	当前分配的宿主机 CPU 百分比。 返回： success 示例： "166.25%"
cpu_number 字符串	宿主机 CPU 数量。 返回： success 示例： "24"
cpu_sockets 整数	宿主机 CPU 插槽数量。 返回： success 示例： 2
cpu_speed 整数	CPU 速度（MHz） 返回： success 示例： 1999
cpu_used 字符串	当前使用的宿主机 CPU 量。 返回： success 示例： "33.6%"
cpu_with_overprovisioning 字符串	应用 cpu.overprovisioning.factor 后宿主机 CPU 量。 返回： success 示例： "959520.0"
创建日期 字符串	主机创建日期。 返回： success 示例： "2015-05-03T15:05:51+0200"
断开连接日期 字符串	主机断开连接日期。 返回： success 示例： "2015-05-03T15:05:51+0200"
已分配磁盘大小 整数	主机当前已分配的磁盘大小。 返回： success 示例： 2593
总磁盘大小 整数	主机的总磁盘大小 返回： success 示例： 259300
事件 字符串	主机可用的事件 返回： success 示例： "Ping; HostDown; AgentConnected; AgentDisconnected; PingTimeout; ShutdownRequested; Remove; StartAgentRebalance; ManagementServerDown"
GPU组 列表 / 元素=字符串	主机中存在的GPU卡。 返回： success 示例： []
高可用性主机 布尔值	主机是否为高可用性主机。 返回： success 示例： false
容量充足 布尔值	主机是否具有足够的CPU和RAM容量来迁移VM。 返回： success 示例： true
主机标签 字符串	主机的逗号分隔标签列表。 返回： success 示例： "perf"
主机类型 字符串	主机的类型。 返回： success 示例： "Routing"
主机版本 字符串	主机的版本。 返回： success 示例： "4.5.2"
hypervisor 字符串	虚拟机管理程序 返回： success 示例： "VMware"
虚拟机管理程序版本 字符串	虚拟机管理程序版本。 返回： success 示例： "5.1"
IP地址 字符串	主机的IP地址 返回： success 示例： "10.10.10.1"
本地存储是否可用 布尔值	本地存储是否可用。 返回： success 示例： false
上次探测时间 字符串	主机上次探测的日期和时间。 返回： success 示例： "1970-01-17T17:27:32+0100"
管理服务器ID 整数	主机的管理服务器ID。 返回： success 示例： 345050593418
已分配内存 整数	主机当前已分配的内存量。 返回： success 示例： 69793218560
总内存 整数	主机的总内存。 返回： success 示例： 206085263360
已使用内存 整数	主机当前已使用的内存量。 返回： success 示例： 65504776192
名称 字符串	宿主机名称。 返回： success 示例： "esx32.example.com"
网络读速率(KB/s) 整数	主机上的入站网络流量。 返回： success 示例： 0
网络写速率(KB/s) 整数	主机上的出站网络流量。 返回： success 示例： 0
操作系统类别 字符串	主机的操作系统类别名称。 返回： success 示例： "..."
带外管理 字符串	主机的带外管理信息。 返回： success 示例： "..."
pod 字符串	Pod名称 返回： success 示例： "Pod01"
移除日期 字符串	主机被移除的日期和时间。 返回： success 示例： "1970-01-17T17:27:32+0100"
资源状态 字符串	主机的资源状态。 返回： success 示例： "Enabled"
state 字符串	宿主机状态。 返回： success 示例： "Up"
是否适合迁移 字符串	此主机是否适合（具有足够的容量并满足所有条件，例如主机标签、最大虚拟机数量限制等）将虚拟机迁移到它。 返回： success 示例： "True"
zone 字符串	区域 返回： success 示例： "zone01"

作者

• René Moser (@resmo)

相关链接

• 问题追踪
• 代码仓库