ngine_io.cloudstack.cs_cluster 模块 – 管理基于 Apache CloudStack 云的主机集群。

注意

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

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

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

要在 playbook 中使用它，请指定： ngine_io.cloudstack.cs_cluster。

ngine_io.cloudstack 0.1.0 中的新增功能

概要

• 创建、更新和删除集群。

要求

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

• python >= 2.6

• cs >= 0.9.0

参数

参数	注释
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_type 字符串	集群的类型。 如果 state=present，则必需 选项 "CloudManaged" "ExternalManaged"
guest_vswitch_name 字符串	集群中用于访客流量的虚拟交换机的名称。 这将覆盖区域范围的流量标签设置。
guest_vswitch_type 字符串	集群中用于访客流量的虚拟交换机的类型。 允许的值为 vmwaresvs（适用于 VMware 标准 vSwitch）和 vmwaredvs（适用于 VMware 分布式 vSwitch） 选项 "vmwaresvs" "vmwaredvs"
hypervisor 字符串	要使用的虚拟机管理程序的名称。 如果 state=present，则必需。 可能的值为 KVM、VMware、BareMetal、XenServer、LXC、HyperV、UCS、OVM、Simulator。
name 字符串 / 必需	集群的名称。
ovm3_cluster 字符串	为集群启用 Ovm3 原生 OCFS2 集群。
ovm3_pool 字符串	为集群启用 Ovm3 原生池。
ovm3_vip 字符串	用于池（和集群）的 Ovm3 vip。
password 字符串	集群的密码。
pod 字符串	集群所属的 Pod 的名称。
public_vswitch_name 字符串	集群中用于公共流量的虚拟交换机的名称。 这将覆盖区域范围的流量标签设置。
public_vswitch_type 字符串	集群中用于公共流量的虚拟交换机的类型。 允许的值为 vmwaresvs（适用于 VMware 标准 vSwitch）和 vmwaredvs（适用于 VMware 分布式 vSwitch） 选项 "vmwaresvs" "vmwaredvs"
state 字符串	集群的状态。 选项 "present" ← (默认) "absent" "disabled" "enabled"
url 字符串	集群的 URL
username 字符串	集群的用户名。
validate_certs 布尔值 ngine_io.cloudstack 2.4.0 中新增	如果 false，则不会验证 SSL 证书。 如果未给出，则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。 这仅应在使用自签名证书的个人控制站点上使用。 选项 false true ← (默认)
vms_ip_address 字符串	与该集群关联的VSM的IP地址。
vms_password 字符串	与该集群关联的VSM的密码。
vms_username 字符串	与该集群关联的VSM的用户名。
zone 字符串 / 必需	集群所属区域的名称。

注释

注意

• CloudStack 模块的详细指南可在 CloudStack 云指南 中找到。

• 此模块支持检查模式。

示例

- name: Ensure a cluster is present
  ngine_io.cloudstack.cs_cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    hypervisor: KVM
    cluster_type: CloudManaged

- name: Ensure a cluster is disabled
  ngine_io.cloudstack.cs_cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: disabled

- name: Ensure a cluster is enabled
  ngine_io.cloudstack.cs_cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: enabled

- name: Ensure a cluster is absent
  ngine_io.cloudstack.cs_cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: absent

返回值

常见的返回值已在 此处 文档中说明，以下是此模块独有的字段

键	描述
allocation_state 字符串	集群的状态。 返回： 成功 示例： "Enabled"
cluster_type 字符串	集群的类型。 返回： 成功 示例： "ExternalManaged"
cpu_overcommit_ratio 字符串	集群的CPU超额分配比率。 返回： 成功 示例： "1.0"
hypervisor 字符串	集群的虚拟化程序 返回： 成功 示例： "VMware"
id 字符串	集群的UUID。 返回： 成功 示例： "04589590-ac63-4ffc-93f5-b698b8ac38b6"
managed_state 字符串	此集群是否由CloudStack管理。 返回： 成功 示例： "Managed"
memory_overcommit_ratio 字符串	集群的内存超额分配比率。 返回： 成功 示例： "1.0"
name 字符串	集群名称。 返回： 成功 示例： "cluster01"
ovm3_vip 字符串	用于池化和/或集群的Ovm3 VIP 返回： 成功 示例： "10.10.10.101"
pod 字符串	集群所在的Pod名称。 返回： 成功 示例： "pod01"
zone 字符串	集群所在的区域名称。 返回： 成功 示例： "ch-gva-2"

作者

• René Moser (@resmo)

资源链接

• 问题追踪器
• 代码库 (源码)