Spec-Zone.ru › Ansible 2.6

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

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

  • Обзор
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата
  • Статус
  • Техническое обслуживание
    • Автор

Обзор

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

Требования

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

  • python >= 2.6
  • cs >= 0.6.10

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
allocation_state
    Варианты:
  • enabled
  • disabled
Состояние распределения пула хранилища.
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
Нужно ли, чтобы пул хранилища управлялся CloudStack.
Учитывается только при создании.
name
обязательно
Имя пула хранилища.
pod
Имя подсети.
provider Значение по умолчанию:
"DefaultPrimary"
Имя поставщика хранилища, например, SolidFire, SolidFireShared, DefaultPrimary, CloudByte.
scope
    Варианты:
  • cluster
  • zone
Область действия пула хранилища.
По умолчанию — кластер, когда cluster указан, в противном случае — зона.
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
string
 success
Состояние хранилища.

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

Пример:
60000
cluster
string
 при заданном объеме кластера
Имя кластера.

Пример:
Cluster01
created
string
 success
Дата создания хранилища.

Пример:
2014-12-01T14:57:57+0100
disk_size_allocated
int
 success
Текущий выделенный размер диска хранилища.

Пример:
2443517624320
disk_size_total
int
 success
Общий размер хранилища.

Пример:
3915055693824
disk_size_used
int
 success
Текущий используемый размер диска хранилища.

Пример:
1040862622180
hypervisor
string
 при доступности
Гипервизор, связанный с этим хранилищем.

Пример:
KVM
id
string
 success
UUID хранилища.

Пример:
a3fca65a-7db1-4891-b97c-48806a978a96
overprovision_factor
string
 success
Коэффициент перераспределения хранилища.

Пример:
2.0
path
string
 success
Путь к хранилищу, используемый в storage_url.

Пример:
poolname
pod
string
 при заданном объеме кластера
Имя подсистемы.

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

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

Пример:
Up
storage_capabilities
dict
 success
Возможности хранилища.

Пример:
{'VOLUME_SNAPSHOT_QUIESCEVM': 'false'}
storage_tags
list
 success
Теги для хранилища.

Пример:
['perf', 'ssd']
suitable_for_migration
bool
 success
Подходит ли хранилище для миграции тома.
zone
string
 success
Имя зоны.

Пример:
Zone01


Статус

Этот модуль помечен как preview, что означает, что он не гарантирует обратной совместимости интерфейса.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

  • 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.6/modules/cs_storage_pool_module.html

Spec-Zone.ru

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