ovirt_host – Модуль управления хостами в oVirt/RHV
Новый в версии 2.3.
Краткое описание
- Модуль управления хостами в oVirt/RHV
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| activate boolean добавлен в 2.4 |
| Если state присутствует, активировать хост.Этот параметр полезно отключить, когда вы не хотите изменять состояние хоста при использовании присутствия state. | |
| address - | Адрес хоста. Может быть полным доменным именем (предпочтительно) или IP-адресом. | ||
| auth словарь / обязательно | Словарь со значениями, необходимыми для создания HTTP/HTTPS-соединения с oVirt: | ||
| ca_file строка | Файл PEM, содержащий доверенные сертификаты CA. Представленный сервером сертификат будет проверен с помощью этих сертификатов CA. Если параметр ca_file не задан, используется системный хранилище сертификатов CA.Значение по умолчанию задаётся переменной окружения OVIRT_CAFILE. | ||
| headers словарь | Словарь HTTP-заголовков, которые будут добавлены к каждому API-запросу. | ||
| hostname строка | Строка, содержащая имя хоста сервера, обычно что-то вроде `server.example.com`. Значение по умолчанию задаётся переменной окружения OVIRT_HOSTNAME.Требуется либо url, либо hostname. | ||
| insecure boolean |
| Флаг boolean, указывающий, нужно ли проверять сертификат TLS сервера и имя хоста. | |
| kerberos boolean |
| Флаг boolean, указывающий, нужно ли использовать аутентификацию Kerberos вместо стандартной аутентификации. | |
| password строка / обязательно | Пароль пользователя. Значение по умолчанию задаётся переменной окружения OVIRT_PASSWORD. | ||
| token строка | Токен, используемый вместо входа с именем пользователя/паролем. Значение по умолчанию задаётся переменной окружения OVIRT_TOKEN. | ||
| url строка | Строка, содержащая URL API сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию задаётся переменной окружения OVIRT_URL.Требуется либо url, либо hostname. | ||
| username строка / обязательно | Имя пользователя, например admin@internal. Значение по умолчанию задаётся переменной окружения OVIRT_USERNAME. | ||
| check_upgrade boolean добавлен в 2.4 |
| Если true и state обновлён, выполнить проверку на обновление перед выполнением действия обновления. | |
| cluster - | Имя кластера, в котором должен быть создан хост. | ||
| comment - | Описание хоста. | ||
| fetch_nested boolean добавлен в 2.3 |
| Если True, модуль извлечёт дополнительные данные из API. Он извлечёт идентификаторы дисков ВМ, снимков и т. д. Пользователь может настроить извлечение других атрибутов вложенных сущностей, указав nested_attributes. | |
| force boolean |
| Указывает, что хост должен быть удалён, даже если он не отвечает, или если он является частью кластера Gluster Storage и имеет на нём тома. | |
| hosted_engine - |
| Если развернуть, это означает, что этот хост также должен развернуть компоненты Hosted Engine. Если развернуть, это означает, что этот хост должен развернуть компоненты Hosted Engine и этот хост не будет работать как часть кластера с высокой доступностью. | |
| id - добавлен в 2.8 | ID хоста для управления. | ||
| iscsi - добавлен в 2.4 | Если state равно iscsidiscover, это означает, что атрибут iscsi используется для обнаружения целей.Если state равно iscsilogin, это означает, что атрибут iscsi используется для входа в указанные цели, переданные в качестве части атрибута iscsi. | ||
| kdump_integration - |
| Указать, будет ли на хосте включена интеграция Kdump. | |
| kernel_params - | Список параметров загрузки ядра. Ниже приведены наиболее распространенные параметры ядра, используемые для хоста: Hostdev Passthrough & SR-IOV: intel_iommu=on Вложенная виртуализация: kvm-intel.nested=1 Небезопасные прерывания: vfio_iommu_type1.allow_unsafe_interrupts=1 Перераспределение PCI: pci=realloc Note:Изменение настроек параметров загрузки ядра может привести к сбою загрузки хоста. Перед внесением каких-либо изменений, пожалуйста, обратитесь к документации продукта. Изменения параметров загрузки ядра требуют развертывания и перезапуска хоста. Хост должен быть успешно переустановлен, а затем перезагружен для применения параметров загрузки ядра. | ||
| name - / обязательно | Имя хоста для управления. | ||
| nested_attributes список добавлен в 2.3 | Указывает список атрибутов, которые необходимо извлечь из API. Этот параметр применяется только когда fetch_nested равен true. | ||
| override_display boolean |
| Переопределить адрес дисплея всех ВМ на этом хосте указанным адресом. | |
| override_iptables boolean |
| Если True, iptables хоста будут переопределены скриптом развертывания хоста. Обратите внимание, что override_iptables по умолчанию false в oVirt/RHV. | |
| password - | Пароль root. Требуется в случае, если public_key установлено в False. | ||
| poll_interval целое число | По умолчанию: 3 | Количество секунд, которое модуль ожидает, прежде чем отправить новый запрос опроса о состоянии сущности. | |
| power_management_enabled boolean добавлен в 2.4 |
| Включить или отключить управление питанием хоста. Для более подробной настройки управления питанием используйте модуль ovirt_host_pm. | |
| public_key boolean |
|
Истина, если для аутентификации на хосте должен использоваться открытый ключ. Требуется в случае, если password не задано.aliases: ssh_public_key | |
| reboot_after_upgrade boolean added in 2.6 |
| Если истина и state обновляется, перезагрузить хост после успешного обновления. | |
| spm_priority - | Приоритет SPM хоста. Целое значение от 1 до 10, где большее число означает более высокий приоритет. | ||
| state - |
| Состояние, в котором должен находиться хост после успешного завершения.
iscsilogin и iscsidiscover поддерживаются с версии 2.4. | |
| timeout integer | По умолчанию: 600 | Время в секундах, которое модуль должен ждать, пока хост не перейдет в желаемое состояние. | |
| vgpu_placement - added in 2.8 |
| Если консолидированный, каждый vGPU размещается на первой физической карте с доступным пространством. Это значение по умолчанию, использующее всё доступное пространство на физических картах. Если разделенный, каждый vGPU размещается на отдельной физической карте, если это возможно. Это может быть полезно для повышения производительности vGPU. | |
| wait boolean |
| yes если модуль должен ждать, пока сущность перейдет в желаемое состояние. | |
Примечания
Примечание
- Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что он установлен с правильной версией, можно создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.3.0
Примеры
# 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_host:
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_host:
public_key: true
cluster: Default
name: myhost2
address: 10.34.61.145
override_iptables: true
# Deploy hosted engine host
- ovirt_host:
cluster: Default
name: myhost2
password: secret
address: 10.34.61.145
override_iptables: true
hosted_engine: deploy
# Maintenance
- ovirt_host:
state: maintenance
name: myhost
# Restart host using power management:
- ovirt_host:
state: restarted
name: myhost
# Upgrade host
- ovirt_host:
state: upgraded
name: myhost
# discover iscsi targets
- ovirt_host:
state: iscsidiscover
name: myhost
iscsi:
username: iscsi_user
password: secret
address: 10.34.61.145
port: 3260
# login to iscsi targets
- ovirt_host:
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_host:
state: reinstalled
name: myhost
public_key: true
# Remove host
- ovirt_host:
state: absent
name: myhost
force: True
# Retry removing host when failed (https://bugzilla.redhat.com/show_bug.cgi?id=1719271)
- ovirt_host:
state: absent
name: myhost
register: result
until: not result.failed
retries: 6
delay: 20
# Change host Name
- ovirt_host:
id: 00000000-0000-0000-0000-000000000000
name: "new host name"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| host словарь | При успехе, если хост найден. | Словарь всех атрибутов хоста. Атрибуты хоста можно найти на вашем экземпляре oVirt/RHV по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/host. |
| id строка | При успехе, если хост найден. | ID хоста, который управляется Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
| iscsi_targets список | При успехе, если хост найден и состояние iscsidiscover. | Список целевых устройств iscsi хоста |
Статус
- Гарантия обратной совместимости этого модуля не предоставляется. [превью]
- Этот модуль поддерживается сообществом 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.8/modules/ovirt_host_module.html