ovirt_hosts - Модуль для управления хостами в oVirt/RHV
Новый в версии 2.3.
Обзор
- Модуль для управления хостами в oVirt/RHV
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.2.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| activate (добавлено в 2.4) | Значение по умолчанию: "да" | Если state присутствует, активировать хост.Этот параметр полезно отключить, когда вы не хотите изменять состояние хоста при использовании present state. |
| address | Адрес хоста. Он может быть либо FQDN (предпочтительный вариант), либо IP-адресом. | |
| 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-запросу. | |
| check_upgrade (добавлено в 2.4) | Значение по умолчанию: "да" | Если true и state обновлен, выполняется проверка действия обновления перед выполнением действия обновления. |
| cluster | Имя кластера, в котором должен быть создан хост. | |
| comment | Описание хоста. | |
| fetch_nested (добавлено в 2.3) | Если True, модуль получит дополнительные данные из API. Он получит идентификаторы дисков ВМ, снимков и т. д. Пользователь может настроить получение других атрибутов вложенных сущностей, указав nested_attributes. | |
| force | Значение по умолчанию: "нет" | Если True, хост будет принудительно переведен в желаемое состояние. |
| hosted_engine | Если deploy, это означает, что этот хост также должен развернуть компоненты размещенного движка. Если undeploy, это означает, что этот хост должен развернуть компоненты размещенного движка и этот хост больше не будет частью кластера высокой доступности. | |
| iscsi (добавлено в 2.4) | Если state iscsidiscover, это означает, что атрибут iscsi используется для обнаружения целейЕсли state iscsilogin, это означает, что атрибут iscsi используется для входа в указанные цели, переданные в качестве части атрибута iscsi | |
| kdump_integration |
| Указывает, будет ли у хоста включена интеграция Kdump. |
| kernel_params | Список параметров загрузки ядра. Ниже приведены наиболее распространенные параметры ядра, используемые для хоста: Hostdev Passthrough & SR-IOV: intel_iommu=on Nested Virtualization: kvm-intel.nested=1 Unsafe Interrupts: vfio_iommu_type1.allow_unsafe_interrupts=1 PCI Reallocation: pci=realloc Note:Изменение настроек параметров загрузки ядра может привести к сбоям загрузки хоста. Перед внесением любых изменений, пожалуйста, проконсультируйтесь с документацией продукта. Изменения параметров загрузки ядра требуют развертывания и перезагрузки хоста. Хост должен быть переустановлен успешно, а затем перезагружен для применения параметров загрузки ядра. | |
| name обязательно | Имя хоста для управления. | |
| nested_attributes (добавлено в 2.3) | Указывает список атрибутов, которые необходимо получить из API. Этот параметр применяется только когда fetch_nested true. | |
| override_display | Заменить адрес отображения всех ВМ на этом хосте на указанный адрес. | |
| override_iptables | Если True, iptables хоста будут перезаписаны скриптом развертывания хоста. Обратите внимание, что override_iptables false по умолчанию в oVirt/RHV. | |
| password | Пароль root. Требуется в случае, если public_key установлен в False. | |
| poll_interval | Значение по умолчанию: 3 | Количество секунд, которое модуль ожидает, прежде чем отправить другой запрос опроса состояния сущности. |
| power_management_enabled (добавлено в 2.4) | Включить или отключить управление питанием хоста. Для более комплексной настройки PM используйте модуль ovirt_host_pm. | |
| public_key | Значение по умолчанию: "нет" |
True, если для аутентификации на хосте должен использоваться открытый ключ. Требуется в случае, если password не задан.псевдонимы: ssh_public_key |
| reboot_after_upgrade (добавлено в 2.6) | Значение по умолчанию: "да" | Если true и state обновлен, перезагрузить хост после успешного обновления. |
| spm_priority | Приоритет SPM хоста. Целое число от 1 до 10, где большее число означает более высокий приоритет. | |
| state |
| Состояние, в котором хост должен находиться после успешного завершения.
iscsilogin и iscsidiscover поддерживаются с версии 2.4. |
| timeout | Значение по умолчанию: 180 | Время в секундах, которое модуль должен ждать, пока экземпляр не перейдет в желаемое состояние. |
| 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:
# Add host with username/password supporting SR-IOV.
# Note that override_iptables is false by default in oVirt/RHV:
- ovirt_hosts:
cluster: Default
name: myhost
address: 10.34.61.145
password: secret
override_iptables: true
kernel_params:
- intel_iommu=on
# Add host using public key
- ovirt_hosts:
public_key: true
cluster: Default
name: myhost2
address: 10.34.61.145
override_iptables: true
# Deploy hosted engine host
- ovirt_hosts:
cluster: Default
name: myhost2
password: secret
address: 10.34.61.145
override_iptables: true
hosted_engine: deploy
# Maintenance
- ovirt_hosts:
state: maintenance
name: myhost
# Restart host using power management:
- ovirt_hosts:
state: restarted
name: myhost
# Upgrade host
- ovirt_hosts:
state: upgraded
name: myhost
# discover iscsi targets
- ovirt_hosts:
state: iscsidiscover
name: myhost
iscsi:
username: iscsi_user
password: secret
address: 10.34.61.145
port: 3260
# login to iscsi targets
- ovirt_hosts:
state: iscsilogin
name: myhost
iscsi:
username: iscsi_user
password: secret
address: 10.34.61.145
target: "iqn.2015-07.com.mlipchuk2.redhat:444"
port: 3260
# Reinstall host using public key
- ovirt_hosts:
state: reinstalled
name: myhost
public_key: true
# Remove host
- ovirt_hosts:
state: absent
name: myhost
force: True
Возвращаемые значения
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| host dict | При успешном поиске узла. | Словарь всех атрибутов узла. Атрибуты узла можно найти на вашем экземпляре oVirt/RHV по следующему адресу: http://ovirt.github.io/ovirt-engine-api-model/master/#types/host. |
| id str | При успешном поиске узла. | ID управляемого узла Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
| iscsi_targets list | При успешном поиске узла и состоянии iscsidiscover. | Список целевых узлов iSCSI |
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщественный, что означает, что его поддерживает сообщество 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_hosts_module.html