cs_configuration - Управление конфигурацией на облаках Apache CloudStack.
Новое в версии 2.1.
- Описание
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Управление глобальными, зональными, учетными записями, хранилищами и кластерными конфигурациями.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязательно | значение по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| account | нет | Обеспечьте значение для соответствующей учетной записи. | ||
| api_http_method | нет | get |
| Используемый HTTP-метод. |
| api_key | нет | Ключ API для CloudStack API. | ||
| api_region | нет | cloudstack | Имя раздела ini в файле cloustack.ini. | |
| api_secret | нет | Секретный ключ CloudStack API. | ||
| api_timeout | нет | 10 | Таймаут HTTP. | |
| api_url | нет | URL CloudStack API, например, https://cloud.example.com/client/api. | ||
| cluster | нет | Обеспечьте значение для соответствующего кластера. | ||
| domain | нет | ROOT | Домен, к которому относится учетная запись. Рассматривается только если используется account. | |
| name | да | Имя конфигурации. | ||
| storage | нет | Обеспечьте значение для соответствующего хранилища. | ||
| value | да | Значение конфигурации. | ||
| zone | нет | Обеспечьте значение для соответствующей зоны. |
Примеры
# 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 | Описание конфигурации. | успех | строка | Настройка хоста для многопутевого доступа |
| Domain | Домен учетной записи конфигурации. | успех | строка | ROOT |
| name | Имя конфигурации. | успех | строка | zone.vlan.capacity.notificationthreshold |
| scope | Область (зона/кластер/хранилище/учетная запись) параметра, который нужно обновить. | успех | строка | хранилище |
| storage | Хранилище конфигурации. | успех | строка | storage01 |
| value | Значение конфигурации. | успех | строка | 0.75 |
| zone | Зона конфигурации. | успех | строка | ch-gva-01 |
Примечания
Примечание
- 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 можно найти по адресу http://docs.ansible.com/ansible/guide_cloudstack.html
- Этот модуль поддерживает режим проверки.
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют отсутствие несовместимых изменений интерфейса.
Для помощи в разработке модулей, если у вас есть такие намерения, прочитайте Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/cs_configuration_module.html