ovirt_affinity_group - Модуль для управления группами родства в oVirt/RHV
Новое в версии 2.3.
Обзор
- Этот модуль управляет группами родства в oVirt/RHV. Он также может управлять назначениями этих групп для ВМ.
Псевдонимы: ovirt_affinity_groups
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- 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-запросу. | |
| cluster | Имя кластера группы родства. | |
| description | Описание группы родства. | |
| fetch_nested (добавлено в 2.3) | Если True, модуль извлечёт дополнительные данные из API. Он извлечёт идентификаторы дисков ВМ, снимков и т. д. Пользователь может настроить извлечение других атрибутов вложенных сущностей, указав nested_attributes. | |
| host_enforcing bool |
| Если yes, ВМ не может запуститься на хосте, если она не удовлетворяет host_rule.Этот параметр поддерживается с версии oVirt/RHV 4.1. |
| host_rule |
| Если positive, все ВМ в этой группе должны работать на этом хосте. Если negative, ни одна ВМ в этой группе не должна работать на этом хосте. Этот параметр поддерживается с версии oVirt/RHV 4.1. |
| hosts | Список имён хостов, которым должна быть назначена эта группа родства. Этот параметр поддерживается с версии oVirt/RHV 4.1. | |
| name обязательно | Имя группы родства для управления. | |
| nested_attributes (добавлено в 2.3) | Указывает список атрибутов, которые следует извлечь из API. Этот параметр применим только когда fetch_nested равен true. | |
| poll_interval | Значение по умолчанию: 3 | Количество секунд, в течение которых модуль ожидает, прежде чем отправить другой запрос на проверку состояния сущности. |
| state |
| Группа родства должна быть присутствующей или отсутствующей. |
| timeout | Значение по умолчанию: 180 | Время в секундах, в течение которого модуль должен ждать, пока экземпляр не перейдёт в желаемое состояние. |
| vm_enforcing bool |
| Если yes, ВМ не может запуститься, если она не удовлетворяет vm_rule. |
| vm_rule |
| Если positive, все ВМ в этой группе должны работать на хосте, определённом host_rule.Если negative, ни одна ВМ в этой группе не должна работать на хосте, определённом host_rule.Если disabled, эта группа родства не действует. |
| vms | Список имён ВМ, которым должна быть назначена эта группа родства. | |
| wait |
True, если модуль должен дождаться, пока сущность перейдёт в желаемое состояние. |
Примечания
Примечание
- Для использования этого модуля необходимо установить 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:
- name: Create(if not exists) and assign affinity group to VMs vm1 and vm2 and host host1
ovirt_affinity_group:
name: mygroup
cluster: mycluster
vm_enforcing: true
vm_rule: positive
host_enforcing: true
host_rule: positive
vms:
- vm1
- vm2
hosts:
- host1
- name: Detach VMs from affinity group and disable VM rule
ovirt_affinity_group:
name: mygroup
cluster: mycluster
vm_enforcing: false
vm_rule: disabled
host_enforcing: true
host_rule: positive
vms: []
hosts:
- host1
- host2
- name: Remove affinity group
ovirt_affinity_group:
state: absent
cluster: mycluster
name: mygroup
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| affinity_group str | При успехе, если группа родства найдена. | Словарь со всеми атрибутами группы родства. Атрибуты группы родства можно найти на вашем экземпляре oVirt/RHV по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/affinity_group. |
| id str | При успехе, если группа родства найдена. | Идентификатор группы родства, которая управляется Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется как обратной совместимости.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом 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_affinity_group_module.html
