ngine_io.cloudstack.cs_configuration 模块 – 管理基于 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_configuration

ngine_io.cloudstack 0.1.0 中的新增功能

概要

  • 管理全局、区域、账户、存储和集群配置。

要求

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

  • python >= 2.6

  • cs >= 0.9.0

参数

参数

注释

account

字符串

确保对应帐户的值。

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

字符串

确保对应集群的值。

domain

字符串

帐户所属的域。

仅在使用 *account* 时才考虑。

默认值: "ROOT"

name

字符串 / 必需

配置的名称。

storage

字符串

确保对应存储池的值。

validate_certs

布尔值

ngine_io.cloudstack 2.4.0 中新增

如果为 false,则不会验证 SSL 证书。

如果未给出,则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。

这仅应在使用自签名证书的个人控制站点上使用。

选项

  • false

  • true ← (默认)

value

字符串 / 必需

配置的值。

zone

字符串

确保对应区域的值。

备注

注意

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

  • 此模块支持检查模式。

示例

- name: Ensure global configuration
  ngine_io.cloudstack.cs_configuration:
    name: router.reboot.when.outofband.migrated
    value: false

- name: Ensure zone configuration
  ngine_io.cloudstack.cs_configuration:
    name: router.reboot.when.outofband.migrated
    zone: ch-gva-01
    value: true

- name: Ensure storage configuration
  ngine_io.cloudstack.cs_configuration:
    name: storage.overprovisioning.factor
    storage: storage01
    value: 2.0

- name: Ensure account configuration
  ngine_io.cloudstack.cs_configuration:
    name: allow.public.user.templates
    value: false
    account: acme inc
    domain: customers

返回值

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

描述

account

字符串

配置的帐户。

返回:成功

示例: "admin"

category

字符串

配置的类别。

返回:成功

示例: "Advanced"

cluster

字符串

配置的集群。

返回:成功

示例: "cluster01"

description

字符串

配置的描述。

返回:成功

示例: "Setup the host to do multipath"

字符串

配置帐户的域。

返回:成功

示例: "ROOT"

name

字符串

配置的名称。

返回:成功

示例: "zone.vlan.capacity.notificationthreshold"

scope

字符串

需要更新的参数的范围(区域/集群/存储池/帐户)。

返回:成功

示例: "storagepool"

storage

字符串

配置的存储。

返回:成功

示例: "storage01"

value

字符串

配置的值。

返回:成功

示例: "0.75"

zone

字符串

配置的区域。

返回:成功

示例: "ch-gva-01"

作者

  • René Moser (@resmo)