Spec-Zone.ru › Ansible 2.8

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 для API CloudStack.
Если не указано, используется переменная среды CLOUDSTACK_KEY.
В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
api_region
строка
Значение по умолчанию:
"cloudstack"
Имя раздела ini в файле cloustack.ini.
Если не указано, используется переменная среды CLOUDSTACK_REGION.
api_secret
строка
Секретный ключ API CloudStack.
Если не задано, используется переменная среды CLOUDSTACK_SECRET.
В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
api_timeout
целое число
Таймаут HTTP в секундах.
Если не указано, используется переменная среды CLOUDSTACK_TIMEOUT.
В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
Значение по умолчанию — 10 секунд, если не указано.
api_url
строка
URL API CloudStack, например 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
булево
    Варианты:
  • 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
строка
Имя зоны, в которой должен быть развернут хост.
Если не указано, используется зона по умолчанию.

Примечания

Примечание

  • 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
  cs_storage_pool:
    zone: zone01
    storage_url: rbd://admin:SECRET@ceph-mons.domain/poolname
    provider: DefaultPrimary
    name: Ceph RBD
    scope: zone
    hypervisor: KVM
  delegate_to: localhost

- name: ensure a cluster scoped storage_pool is disabled
  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
  delegate_to: localhost

- name: ensure a cluster scoped storage_pool is in maintenance
  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
  delegate_to: localhost

- name: ensure a storage_pool is absent
  cs_storage_pool:
    name: Ceph RBD
    state: absent
  delegate_to: localhost

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

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

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

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

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

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

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

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

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

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

Пример:
Zone01


Статус

  • Данный модуль не гарантирует обратную совместимость интерфейса. [preview]
  • Данный модуль поддерживается сообществом 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.8/modules/cs_storage_pool_module.html

Spec-Zone.ru

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