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 字符串	集群的 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)

集合链接

• 问题跟踪器
• 存储库（源代码）