ngine_io.cloudstack.cs_storage_pool – Управляет первичными хранилищами на облаках на основе Apache CloudStack.

Примечание

Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).

Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.

Для использования в playbook укажите: ngine_io.cloudstack.cs_storage_pool.

В версии 0.1.0: из ngine_io.cloudstack

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Создание, обновление, перевод в техническое обслуживание, отключение, включение и удаление хранилищ.

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allocation_state строка	Варианты: enabled disabled maintenance	Состояние распределения хранилища.
api_http_method строка	Варианты: get ← post	HTTP-метод, используемый для запроса к API-точке входа. Если не указано, используется переменная среды `CLOUDSTACK_METHOD`.
api_key строка / обязательный		Ключ API CloudStack API. Если не указано, используется переменная среды `CLOUDSTACK_KEY`.
api_secret строка / обязательный		Секретный ключ CloudStack API. Если не указано, используется переменная среды `CLOUDSTACK_SECRET`.
api_timeout целое число	Значение по умолчанию: 10	Таймаут HTTP в секундах. Если не указано, используется переменная среды `CLOUDSTACK_TIMEOUT`.
api_url строка / обязательный		URL CloudStack API, например, https://cloud.example.com/client/api. Если не указано, используется переменная среды `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert строка		Проверять сертификат авторитета CA. Если не указано, используется переменная среды `CLOUDSTACK_VERIFY`.
capacity_bytes целое число		Объем, который CloudStack может выделять из этого хранилища.
capacity_iops целое число		Объем, который CloudStack может выделять из этого хранилища.
cluster строка		Имя кластера.
hypervisor строка		Требуется при создании хранилища, ограниченного зоной. Возможные значения: `KVM`, `VMware`, `BareMetal`, `XenServer`, `LXC`, `HyperV`, `UCS`, `OVM`, `Simulator`.
managed булево	Варианты: no yes	Управлять ли хранилищем CloudStack. Учитывается только при создании.
name строка / обязательный		Имя хранилища.
pod строка		Имя подсети.
provider строка	Значение по умолчанию: "DefaultPrimary"	Имя поставщика хранилища, например, SolidFire, SolidFireShared, DefaultPrimary, CloudByte.
scope строка	Варианты: cluster zone	Область действия хранилища. По умолчанию cluster, если указан `cluster`, иначе zone.
state строка	Варианты: present ← absent	Состояние хранилища.
storage_tags список / элементы=строка		Тэги, связанные с этим хранилищем. алиасы: storage_tag
storage_url строка		URL хранилища. Требуется, если state=present.
zone строка / обязательный		Имя зоны, в которой должен быть развернут хост.

Примечания

Примечание

Подробное руководство по модулям cloudstack можно найти в Руководстве по облакам CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: ensure a zone scoped storage_pool is present
  ngine_io.cloudstack.cs_storage_pool:
    zone: zone01
    storage_url: rbd://admin:SECRET@ceph-mons.domain/poolname
    provider: DefaultPrimary
    name: Ceph RBD
    scope: zone
    hypervisor: KVM

- name: ensure a cluster scoped storage_pool is disabled
  ngine_io.cloudstack.cs_storage_pool:
    name: Ceph RBD
    zone: zone01
    cluster: cluster01
    pod: pod01
    storage_url: rbd://admin:SECRET@ceph-the-mons.domain/poolname
    provider: DefaultPrimary
    scope: cluster
    allocation_state: disabled

- name: ensure a cluster scoped storage_pool is in maintenance
  ngine_io.cloudstack.cs_storage_pool:
    name: Ceph RBD
    zone: zone01
    cluster: cluster01
    pod: pod01
    storage_url: rbd://admin:SECRET@ceph-the-mons.domain/poolname
    provider: DefaultPrimary
    scope: cluster
    allocation_state: maintenance

- name: ensure a storage_pool is absent
  ngine_io.cloudstack.cs_storage_pool:
    name: Ceph RBD
    zone: zone01
    state: absent

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

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

Ключ	Возвращенное значение	Описание
allocation_state строка	успех	Состояние хранилища. Пример: enabled
capacity_iops целое число	при доступности	IOPS, которые CloudStack может выделять из этого хранилища Пример: 60000
cluster строка	при scope=cluster	Имя кластера. Пример: Cluster01
created строка	успех	Дата создания хранилища. Пример: 2014-12-01T14:57:57+0100
disk_size_allocated целое число	успех	Текущий объем выделенного дискового пространства хранилища. Пример: 2443517624320
disk_size_total целое число	успех	Общий объем хранилища. Пример: 3915055693824
disk_size_used целое число	успех	Текущий объем используемого дискового пространства хранилища. Пример: 1040862622180
hypervisor строка	при доступности	Гипервизор, связанный с этим хранилищем. Пример: KVM
id строка	успех	UUID хранилища. Пример: a3fca65a-7db1-4891-b97c-48806a978a96
overprovision_factor строка	успех	Коэффициент перевыделения ресурсов хранилища. Пример: 2.0
path строка	успех	Путь к хранилищу, используемый в storage_url. Пример: poolname
pod строка	при scope=cluster	Имя подсети. Пример: Cluster01
scope строка	успех	Область действия хранилища. Пример: cluster
state строка	успех	Состояние хранилища, возвращенное API. Пример: Up
storage_capabilities словарь	успех	Возможности хранилища. Пример: {'VOLUME_SNAPSHOT_QUIESCEVM': 'false'}
storage_tags список / элементы=строка	успех	Теги для хранилища. Пример: ['perf', 'ssd']
suitable_for_migration булево	успех	Подходит ли хранилище для миграции тома.
zone строка	успех	Имя зоны. Пример: Zone01

Авторы

Netservers Ltd. (@netservers)
René Moser (@resmo)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_storage_pool_module.html