cs_configuration - Управление конфигурацией на облаках Apache CloudStack.

Новая версия с 2.1.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Управление глобальными, зональными, учетными, хранилищными и кластерными конфигурациями.

Требования

Ниже приведены требования к хосту, на котором будет выполняться этот модуль.

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account		Убедитесь, что значение соответствует соответствующему аккаунту.
api_http_method	Варианты: get post	Метод HTTP, используемый для запроса конечной точки API. Если не задано, рассматривается переменная среды `CLOUDSTACK_METHOD`. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания. Значение по умолчанию - `get`, если не указано.
api_key		Ключ API CloudStack API. Если не задано, рассматривается переменная среды `CLOUDSTACK_KEY`. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания.
api_region	По умолчанию: "cloudstack"	Имя раздела в файле ini `cloustack.ini`. Если не задано, рассматривается переменная среды `CLOUDSTACK_REGION`.
api_secret		Секретный ключ CloudStack API. Если не задано, рассматривается переменная среды `CLOUDSTACK_SECRET`. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания.
api_timeout		Таймаут HTTP в секундах. Если не задано, рассматривается переменная среды `CLOUDSTACK_TIMEOUT`. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания. Значение по умолчанию 10 секунд, если не указано.
api_url		URL CloudStack API, например, https://cloud.example.com/client/api. Если не задано, рассматривается переменная среды `CLOUDSTACK_ENDPOINT`. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания.
cluster		Убедитесь, что значение соответствует соответствующему кластеру.
domain	По умолчанию: "ROOT"	Домен, к которому относится аккаунт. Рассматривается только при использовании `account`.
name обязательно		Имя конфигурации.
storage		Убедитесь, что значение соответствует соответствующему хранилищу.
value обязательно		Значение конфигурации.
zone		Убедитесь, что значение соответствует соответствующей зоне.

Примечания

Примечание

Ansible использует метод конфигурации библиотеки cs, если учетные данные не предоставлены аргументами api_url, api_key, api_secret. Конфигурация считывается из нескольких источников в указанном порядке. CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD. Переменные среды CLOUDSTACK_TIMEOUT. Переменная среды CLOUDSTACK_CONFIG, указывающая на файл .ini. Файл cloudstack.ini в текущем рабочем каталоге. Файл .cloudstack.ini в домашнем каталоге пользователя. Допустимо указывать несколько учетных данных и конечных точек, используя разделы ini в cloudstack.ini. Используйте аргумент api_region для выбора имени раздела, по умолчанию используется cloudstack. Дополнительную информацию см. на https://github.com/exoscale/cs.
Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

# Ensure global configuration
- local_action:
    module: cs_configuration
    name: router.reboot.when.outofband.migrated
    value: false

# Ensure zone configuration
- local_action:
    module: cs_configuration
    name: router.reboot.when.outofband.migrated
    zone: ch-gva-01
    value: true

# Ensure storage configuration
- local_action:
    module: cs_configuration
    name: storage.overprovisioning.factor
    storage: storage01
    value: 2.0

# Ensure account configuration
- local_action:
    module: cs_configuration
    name: allow.public.user.templates
    value: false
    account: acme inc
    domain: customers

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
account строка	успех	Аккаунт конфигурации. Пример: admin
category строка	успех	Категория конфигурации. Пример: Расширенные
cluster строка	успех	Кластер конфигурации. Пример: cluster01
description строка	успех	Описание конфигурации. Пример: Настройка хоста для работы с multipath
Domain строка	успех	Домен учетной записи конфигурации. Пример: ROOT
name строка	успех	Имя конфигурации. Пример: zone.vlan.capacity.notificationthreshold
scope строка	успех	Область (зона/кластер/хранилище/аккаунт) параметра, который нужно обновить. Пример: storagepool
storage строка	успех	Хранилище конфигурации. Пример: storage01
value строка	успех	Значение конфигурации. Пример: 0.75
zone строка	успех	Зона конфигурации. Пример: ch-gva-01

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься обратные несовместимые изменения в интерфейс.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание модулей и поддержка.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

René Moser (@resmo)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/cs_configuration_module.html