Spec-Zone.ru › Ansible 2.7

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

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

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

Описание

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

Требования

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

  • python >= 2.6
  • cs >= 0.6.10

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
allocation_state
-
    Варианты:
  • enabled
  • disabled
  • maintenance
Состояние распределения пула хранилища.
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, см. также примечания.
capacity_bytes
-
Объем, который CloudStack может зарезервировать из этого пула хранилища.
capacity_iops
-
Объем, который CloudStack может зарезервировать из этого пула хранилища.
cluster
-
Имя кластера.
hypervisor
-
    Варианты:
  • KVM
  • VMware
  • BareMetal
  • XenServer
  • LXC
  • HyperV
  • UCS
  • OVM
  • Simulator
Требуется при создании пула, связанного с зоной.
managed
-
Управлять ли пулом хранилища CloudStack.
Только при создании.
name
- / обязательно
Имя пула хранилища.
pod
-
Имя подсети.
provider
-
По умолчанию:
"DefaultPrimary"
Имя поставщика хранилища, например SolidFire, SolidFireShared, DefaultPrimary, CloudByte.
scope
-
    Варианты:
  • cluster
  • zone
Область применения пула хранилища.
По умолчанию cluster, когда указан cluster, иначе zone.
state
-
    Варианты:
  • present ←
  • absent
Состояние пула хранилища.
storage_tags
-
Теги, связанные с этим пулом хранилища.
storage_url
-
URL пула хранилища.
Требуется, если state=present.
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.
  • Этот модуль поддерживает режим проверки.

Примеры

- name: ensure a zone scoped storage_pool is present
  local_action:
    module: 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
  local_action:
    module: 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
  local_action:
    module: 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
  local_action:
    module: cs_storage_pool
    name: Ceph RBD
    state: absent

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

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

Ключ Возвращаемое значение Описание
allocation_state
строка
 успех
Состояние хранилища.

Пример:
enabled
capacity_iops
целое число
 при наличии
Количество операций ввода/вывода в секунду (IOPS), которые CloudStack может предоставить из этого хранилища.

Пример:
60000
cluster
строка
 при scope = кластер
Имя кластера.

Пример:
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 = кластер
Имя подсети.

Пример:
Cluster01
scope
строка
 успех
Область применения хранилища.

Пример:
cluster
state
строка
 успех
Состояние хранилища, возвращенное API.

Пример:
Up
storage_capabilities
словарь
 успех
Возможности хранилища.

Пример:
{'VOLUME_SNAPSHOT_QUIESCEVM': 'false'}
storage_tags
список
 успех
Теги хранилища.

Пример:
['perf', 'ssd']
suitable_for_migration
булево
 успех
Подходит ли хранилище для миграции тома.
zone
строка
 успех
Имя зоны.

Пример:
Zone01


Статус

  • Интерфейс этого модуля не гарантирует обратной совместимости. [превью]
  • Этот модуль поддерживается сообществом Ansible. [community]

Авторы

  • Netservers Ltd. (@netservers)
  • 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.7/modules/cs_storage_pool_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API