Модуль ngine_io.cloudstack.storage_pool — управление основными пулами хранения в облаках на базе Apache CloudStack.
Примечание
Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.storage_pool.
Добавлено в ngine_io.cloudstack 0.1.0
Краткое описание
- Создание, обновление, перевод в режим обслуживания, отключение, включение и удаление пулов хранения.
Псевдонимы: cs_storage_pool
Требования
На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.
- python >= 2.6
- cs >= 0.9.0
Параметры
Параметр | Комментарии |
|---|---|
allocation_state string | Состояние распределения пула хранения. Варианты:
|
api_http_method string | Метод HTTP, используемый для запроса к конечной точке API. Если не задан, используется переменная среды Варианты:
|
api_key string / обязательный | Ключ API CloudStack. Если не задан, используется переменная среды |
api_secret string / обязательный | Секретный ключ API CloudStack. Если не задан, используется переменная среды |
api_timeout integer | Тайм-аут HTTP в секундах. Если не задан, используется переменная среды По умолчанию: |
api_url string / обязательный | URL API CloudStack, например https://cloud.example.com/client/api. Если не задан, используется переменная среды |
api_verify_ssl_cert string | Проверка файла сертификата центра сертификации. Если не задан, используется переменная среды |
capacity_bytes integer | Объём в байтах, который CloudStack может выделить из этого пула хранения. |
capacity_iops integer | Объём в байтах, который CloudStack может выделить из этого пула хранения. |
cluster string | Имя кластера. |
hypervisor string | Обязательный параметр при создании пула с областью действия, охватывающей зону. Возможные значения: |
managed boolean | Должен ли пул хранения управляться CloudStack. Учитывается только при создании. Варианты:
|
name string / обязательный | Имя пула хранения. |
pod string | Имя пода. |
provider string | Имя поставщика хранилища, например SolidFire, SolidFireShared, DefaultPrimary, CloudByte. По умолчанию: |
scope string | Область действия пула хранения. По умолчанию используется кластер, если задан Варианты:
|
state string | Состояние пула хранения. Варианты:
|
storage_tags псевдонимы: storage_tag list / элементы=string | Теги, связанные с этим пулом хранения. |
storage_url string | URL пула хранения. Обязателен, если state=present. |
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0 | Если задано значение Если не задан, используется переменная среды Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами. Варианты:
|
zone string / обязательный | Имя зоны, в которой должен быть развёрнут хост. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack см. в руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: ensure a zone scoped storage_pool is present
ngine_io.cloudstack.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.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.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.storage_pool:
name: Ceph RBD
zone: zone01
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
allocation_state string | Состояние пула хранения. Возвращается: при успешном выполнении Пример: |
capacity_iops integer | Количество IOPS, которое CloudStack может выделить из этого пула хранения. Возвращается: если доступно Пример: |
cluster string | Имя кластера. Возвращается: если область действия — кластер Пример: |
created string | Дата создания пула. Возвращается: при успешном выполнении Пример: |
disk_size_allocated integer | Текущий объём дискового пространства, выделенного пулу. Возвращается: при успешном выполнении Пример: |
disk_size_total integer | Общий размер пула. Возвращается: при успешном выполнении Пример: |
disk_size_used integer | Текущий объём используемого дискового пространства пула. Возвращается: при успешном выполнении Пример: |
hypervisor string | Гипервизор, связанный с этим пулом хранения. Возвращается: если доступно Пример: |
id string | UUID пула. Возвращается: при успешном выполнении Пример: |
overprovision_factor string | Коэффициент избыточного выделения ресурсов пула хранения. Возвращается: при успешном выполнении Пример: |
path string | Путь к пулу хранения, используемый в storage_url. Возвращается: при успешном выполнении Пример: |
pod string | Имя пода. Возвращается: если область действия — кластер Пример: |
scope string | Область действия пула хранения. Возвращается: при успешном выполнении Пример: |
state string | Состояние пула хранения, возвращённое API. Возвращается: при успешном выполнении Пример: |
storage_capabilities dictionary | Возможности пула хранения. Возвращается: при успешном выполнении Пример: |
storage_tags list / элементы=string | Теги пула хранения. Возвращается: при успешном выполнении Пример: |
suitable_for_migration boolean | Можно ли использовать пул хранения для миграции тома. Возвращается: при успешном выполнении Пример: |
zone string | Имя зоны. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/storage_pool_module.html