Spec-Zone.ru › Ansible 2.6

ovirt_storage_domains - Модуль управления доменными хранилищами в oVirt/RHV

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

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

Обзор

  • Модуль управления доменными хранилищами в oVirt/RHV

Требования

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

  • python >= 2.7
  • ovirt-engine-sdk-python >= 4.2.4

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
auth
обязательно
Словарь со значениями, необходимыми для создания HTTP/HTTPS-соединения с oVirt:
username[обязательно] - Имя пользователя, например admin@internal. Значение по умолчанию задается переменной среды OVIRT_USERNAME.
password[обязательно] - Пароль пользователя. Значение по умолчанию задается переменной среды OVIRT_PASSWORD.
url - Строка, содержащая URL API сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию задается переменной среды OVIRT_URL. Требуется либо url либо hostname.
hostname - Строка, содержащая имя хоста сервера, обычно что-то вроде `server.example.com`. Значение по умолчанию задается переменной среды OVIRT_HOSTNAME. Требуется либо url либо hostname.
token - Токен, используемый вместо входа с именем пользователя/паролем. Значение по умолчанию задается переменной среды OVIRT_TOKEN.
insecure - Логический флаг, указывающий, нужно ли проверять сертификат TLS сервера и имя хоста.
ca_file - Файл PEM, содержащий доверенные сертификаты CA. Представленный сервером сертификат будет проверен с помощью этих сертификатов CA. Если параметр `ca_file` не установлен, используется системный хранилище сертификатов CA. Значение по умолчанию задается переменной среды OVIRT_CAFILE.
kerberos - Логический флаг, указывающий, нужно ли использовать аутентификацию Kerberos вместо стандартной аутентификации.
headers - Словарь HTTP-заголовков, которые нужно добавить к каждому API-запросу.
backup
(добавлен в 2.5)
Логический флаг, указывающий, настроена ли область хранения как резервная.
comment
Комментарий к области хранения.
critical_space_action_blocker
(добавлен в 2.5)
Указывает минимальный свободный объем, который должна содержать область хранения в процентах.
data_center
Имя ЦОД, к которому должна быть подключена область хранения.
Этот параметр не идемпотентен, изменить ЦОД области хранения нельзя.
description
Описание области хранения.
destroy
Логическое удаление области хранения. Если true, сохраняет данные области хранения для импорта.
Этот параметр актуален только когда state отсутствует.
discard_after_delete
(добавлен в 2.5)
Если True, блоки области хранения будут удалены при удалении. Включено по умолчанию.
Этот параметр актуален только для областей хранения на основе блоков.
domain_function
    Варианты:
  • data ←
  • iso
  • export
Функция области хранения.
Этот параметр не идемпотентен, изменить функцию области хранения нельзя.

псевдонимы: type
fcp
Словарь со значениями для типа хранения Fibre Channel:
lun_id - Идентификатор LUN.
override_luns - Если True, LUNы FCP-области хранения будут перезаписаны перед добавлением.
Обратите внимание, что эти параметры не идемпотентны.
fetch_nested
(добавлен в 2.3)
Если True, модуль извлечёт дополнительные данные из API.
Он извлечёт идентификаторы дисков, снимков и т.д. для ВМ. Пользователь может настроить извлечение других атрибутов вложенных сущностей, указав nested_attributes.
format
Если True, область хранения будет отформатирована после удаления из oVirt/RHV.
Этот параметр актуален только когда state отсутствует.
glusterfs
Словарь со значениями для типа хранения GlusterFS:
address - Адрес сервера Gluster. Например: myserver.mydomain.com
path - Путь к точке монтирования. Например: /path/to/my/data
mount_options - Параметр, который будет передан при монтировании хранилища.
Обратите внимание, что эти параметры не идемпотентны.
host
Хост, который будет использоваться для монтирования хранилища.
id
(добавлен в 2.4)
Идентификатор области хранения для импорта.
iscsi
Словарь со значениями для типа хранения iSCSI:
address - Адрес сервера iSCSI хранения.
port - Порт сервера iSCSI хранения.
target - Целевой IQN для устройства хранения.
lun_id - Идентификатор(ы) LUN.
username - Имя пользователя CHAP для входа в целевой объект.
password - Пароль CHAP для входа в целевой объект.
override_luns - Если True, LUNы iSCSI-области хранения будут перезаписаны перед добавлением.
target_lun_map - Список словарей, содержащих целевые объекты и LUNы."
Обратите внимание, что эти параметры не идемпотентны.
Параметр target_lun_map поддерживается с Ansible 2.5.
localfs
(добавлен в 2.4)
Словарь со значениями для типа хранения localfs:
path - Путь к точке монтирования. Например: /path/to/my/data
Обратите внимание, что эти параметры не идемпотентны.
name
Имя области хранения для управления. (Не требуется, когда состояние imported)
nested_attributes
(добавлен в 2.3)
Указывает список атрибутов, которые должны быть извлечены из API.
Этот параметр применяется только когда fetch_nested равен true.
nfs
Словарь со значениями для типа хранения NFS:
address - Адрес сервера NFS. Например: myserver.mydomain.com
path - Путь к точке монтирования. Например: /path/to/my/data
version - Версия NFS. Одна из: auto, v3, v4 или v4_1.
timeout - Время в десятых долях секунды, которое нужно подождать для ответа перед повторной попыткой запросов NFS. Диапазон от 0 до 65535.
retrans - Количество попыток повтора запроса перед попыткой дальнейших действий по восстановлению. Диапазон от 0 до 65535.
mount_options - Параметр, который будет передан при монтировании хранилища.
Обратите внимание, что эти параметры не идемпотентны.
poll_interval Значение по умолчанию:
3
Количество секунд, которое модуль ожидает до отправки нового запроса на проверку статуса сущности.
posixfs
Словарь со значениями для типа хранения PosixFS:
path - Путь к точке монтирования. Например: /path/to/my/data
vfs_type - Тип виртуальной файловой системы.
mount_options - Параметр, который будет передан при монтировании хранилища.
Обратите внимание, что эти параметры не идемпотентны.
state
    Варианты:
  • present ←
  • absent
  • maintenance
  • unattached
  • update_ovf_store
Должна ли область хранения быть present/absent/maintenance/unattached/imported/update_ovf_store
imported поддерживается с версии 2.4.
update_ovf_store поддерживается с версии 2.5, в настоящее время, если wait (true), мы не ждём обновления.
timeout Значение по умолчанию:
180
Время в секундах, которое модуль должен ждать, пока экземпляр не перейдёт в нужное состояние.
wait
True, если модуль должен ждать, пока сущность перейдёт в нужное состояние.
warning_low_space
(добавлен в 2.5)
Указывает минимальный процент свободного места в области хранения для отображения предупреждения.
wipe_after_delete
(добавлен в 2.5)
Логический флаг, указывающий, нужно ли очистить данные области хранения после удаления.

Примечания

Примечание

  • Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что он установлен с правильной версией, можно создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.2.4

Примеры

# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:

# Add data NFS storage domain
- ovirt_storage_domains:
    name: data_nfs
    host: myhost
    data_center: mydatacenter
    nfs:
      address: 10.34.63.199
      path: /path/data

# Add data NFS storage domain with id for data center
- ovirt_storage_domains:
    name: data_nfs
    host: myhost
    data_center: 11111
    nfs:
      address: 10.34.63.199
      path: /path/data
      mount_options: noexec,nosuid

# Add data localfs storage domain
- ovirt_storage_domains:
    name: data_localfs
    host: myhost
    data_center: mydatacenter
    localfs:
      path: /path/to/data

# Add data iSCSI storage domain:
- ovirt_storage_domains:
    name: data_iscsi
    host: myhost
    data_center: mydatacenter
    iscsi:
      target: iqn.2016-08-09.domain-01:nickname
      lun_id:
       - 1IET_000d0001
       - 1IET_000d0002
      address: 10.34.63.204
    discard_after_delete: True
    backup: False
    critical_space_action_blocker: 5
    warning_low_space: 10

# Since Ansible 2.5 you can specify multiple targets for storage domain,
# Add data iSCSI storage domain with multiple targets:
- ovirt_storage_domains:
    name: data_iscsi
    host: myhost
    data_center: mydatacenter
    iscsi:
      target_lun_map:
        - target: iqn.2016-08-09.domain-01:nickname
          lun_id: 1IET_000d0001
        - target: iqn.2016-08-09.domain-02:nickname
          lun_id: 1IET_000d0002
      address: 10.34.63.204
    discard_after_delete: True

# Add data glusterfs storage domain
-  ovirt_storage_domains:
    name: glusterfs_1
    host: myhost
    data_center: mydatacenter
    glusterfs:
      address: 10.10.10.10
      path: /path/data

# Create export NFS storage domain:
- ovirt_storage_domains:
    name: myexportdomain
    domain_function: export
    host: myhost
    data_center: mydatacenter
    nfs:
      address: 10.34.63.199
      path: /path/export
    wipe_after_delete: False
    backup: True
    critical_space_action_blocker: 2
    warning_low_space: 5

# Import export NFS storage domain:
- ovirt_storage_domains:
    state: imported
    domain_function: export
    host: myhost
    data_center: mydatacenter
    nfs:
      address: 10.34.63.199
      path: /path/export

# Import FCP storage domain:
- ovirt_storage_domains:
    state: imported
    name: data_fcp
    host: myhost
    data_center: mydatacenter
    fcp: {}

# Update OVF_STORE:
- ovirt_storage_domains:
    state: update_ovf_store
    name: domain

# Create ISO NFS storage domain
- ovirt_storage_domains:
    name: myiso
    domain_function: iso
    host: myhost
    data_center: mydatacenter
    nfs:
      address: 10.34.63.199
      path: /path/iso

# Remove storage domain
- ovirt_storage_domains:
    state: absent
    name: mystorage_domain
    format: true

Значения возврата

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

Ключ Возвращаемое значение Описание
id
str
При успешном поиске домена хранилища.
ID домена хранилища, который управляется.

Пример:
7de90f31-222c-436c-a1ca-7e655bd5b60c
storage_domain
dict
При успешном поиске домена хранилища.
Словарь всех атрибутов домена хранилища. Атрибуты домена хранилища можно найти на вашем экземпляре oVirt/RHV по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/storage_domain.



Статус

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

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

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

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

Автор

  • Ondra Machacek (@machacekondra)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/ovirt_storage_domains_module.html

Spec-Zone.ru

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