Spec-Zone.ru › Ansible

Модуль 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

Состояние распределения пула хранения.

Варианты:

  • "enabled"
  • "disabled"
  • "maintenance"

api_http_method

string

Метод HTTP, используемый для запроса к конечной точке API.

Если не задан, используется переменная среды CLOUDSTACK_METHOD.

Варианты:

  • "get" ← (по умолчанию)
  • "post"

api_key

string / обязательный

Ключ API CloudStack.

Если не задан, используется переменная среды CLOUDSTACK_KEY.

api_secret

string / обязательный

Секретный ключ API CloudStack.

Если не задан, используется переменная среды CLOUDSTACK_SECRET.

api_timeout

integer

Тайм-аут HTTP в секундах.

Если не задан, используется переменная среды CLOUDSTACK_TIMEOUT.

По умолчанию: 10

api_url

string / обязательный

URL API CloudStack, например https://cloud.example.com/client/api.

Если не задан, используется переменная среды CLOUDSTACK_ENDPOINT.

api_verify_ssl_cert

string

Проверка файла сертификата центра сертификации.

Если не задан, используется переменная среды CLOUDSTACK_VERIFY.

capacity_bytes

integer

Объём в байтах, который CloudStack может выделить из этого пула хранения.

capacity_iops

integer

Объём в байтах, который CloudStack может выделить из этого пула хранения.

cluster

string

Имя кластера.

hypervisor

string

Обязательный параметр при создании пула с областью действия, охватывающей зону.

Возможные значения: KVM, VMware, BareMetal, XenServer, LXC, HyperV, UCS, OVM, Simulator.

managed

boolean

Должен ли пул хранения управляться CloudStack.

Учитывается только при создании.

Варианты:

  • false
  • true

name

string / обязательный

Имя пула хранения.

pod

string

Имя пода.

provider

string

Имя поставщика хранилища, например SolidFire, SolidFireShared, DefaultPrimary, CloudByte.

По умолчанию: "DefaultPrimary"

scope

string

Область действия пула хранения.

По умолчанию используется кластер, если задан cluster, в противном случае — зона.

Варианты:

  • "cluster"
  • "zone"

state

string

Состояние пула хранения.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

storage_tags

псевдонимы: storage_tag

list / элементы=string

Теги, связанные с этим пулом хранения.

storage_url

string

URL пула хранения.

Обязателен, если state=present.

validate_certs

boolean

добавлено в ngine_io.cloudstack 2.4.0

Если задано значение false, SSL-сертификаты проверяться не будут.

Если не задан, используется переменная среды CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами.

Варианты:

  • false
  • true ← (по умолчанию)

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

Состояние пула хранения.

Возвращается: при успешном выполнении

Пример: "enabled"

capacity_iops

integer

Количество IOPS, которое CloudStack может выделить из этого пула хранения.

Возвращается: если доступно

Пример: 60000

cluster

string

Имя кластера.

Возвращается: если область действия — кластер

Пример: "Cluster01"

created

string

Дата создания пула.

Возвращается: при успешном выполнении

Пример: "2014-12-01T14:57:57+0100"

disk_size_allocated

integer

Текущий объём дискового пространства, выделенного пулу.

Возвращается: при успешном выполнении

Пример: 2443517624320

disk_size_total

integer

Общий размер пула.

Возвращается: при успешном выполнении

Пример: 3915055693824

disk_size_used

integer

Текущий объём используемого дискового пространства пула.

Возвращается: при успешном выполнении

Пример: 1040862622180

hypervisor

string

Гипервизор, связанный с этим пулом хранения.

Возвращается: если доступно

Пример: "KVM"

id

string

UUID пула.

Возвращается: при успешном выполнении

Пример: "a3fca65a-7db1-4891-b97c-48806a978a96"

overprovision_factor

string

Коэффициент избыточного выделения ресурсов пула хранения.

Возвращается: при успешном выполнении

Пример: "2.0"

path

string

Путь к пулу хранения, используемый в storage_url.

Возвращается: при успешном выполнении

Пример: "poolname"

pod

string

Имя пода.

Возвращается: если область действия — кластер

Пример: "Cluster01"

scope

string

Область действия пула хранения.

Возвращается: при успешном выполнении

Пример: "cluster"

state

string

Состояние пула хранения, возвращённое API.

Возвращается: при успешном выполнении

Пример: "Up"

storage_capabilities

dictionary

Возможности пула хранения.

Возвращается: при успешном выполнении

Пример: {"VOLUME_SNAPSHOT_QUIESCEVM": "false"}

storage_tags

list / элементы=string

Теги пула хранения.

Возвращается: при успешном выполнении

Пример: ["perf", "ssd"]

suitable_for_migration

boolean

Можно ли использовать пул хранения для миграции тома.

Возвращается: при успешном выполнении

Пример: false

zone

string

Имя зоны.

Возвращается: при успешном выполнении

Пример: "Zone01"

Авторы

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

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

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