Spec-Zone.ru › Ansible 2.4

ovirt_hosts - Модуль для управления хостами в oVirt/RHV

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

  • Обзор
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
  • Возвращаемые значения
  • Примечания
    • Статус

Обзор

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

Требования (к хосту, на котором выполняется модуль)

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

Параметры

параметр обязательно значение по умолчанию варианты комментарии
activate
(добавлен в 2.4)
нет True
Если state присутствует, активировать хост.
Этот параметр полезно отключить, когда вы не хотите изменять состояние хоста при использовании present state.
address
нет
Адрес хоста. Он может быть либо FQDN (предпочтительно), либо IP-адресом.
auth
да
Словарь со значениями, необходимыми для создания подключения HTTP/HTTPS к oVirt:
username[обязательно] - Имя пользователя, например admin@internal. Значение по умолчанию задается переменной среды OVIRT_USERNAME.
password[обязательно] - Пароль пользователя. Значение по умолчанию задается переменной среды OVIRT_PASSWORD.
url[обязательно] - Строка, содержащая базовый URL-адрес сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию задается переменной среды OVIRT_URL.
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
Если true и state обновлён, выполнить проверку обновления перед выполнением действия обновления.
cluster
нет
Имя кластера, в котором должен быть создан хост.
comment
нет
Описание хоста.
fetch_nested
(добавлен в 2.3)
нет
Если True, модуль получит дополнительные данные из API.
Он получит идентификаторы дисков, снимков и т. д. для виртуальных машин. Пользователь может настроить получение других атрибутов вложенных сущностей, указав nested_attributes.
force
нет
Если True, хост будет принудительно переведён в нужное состояние.
hosted_engine
нет
Если deploy, это означает, что хост также должен развернуть компоненты hosted engine.
Если undeploy, это означает, что хост должен развёрнуть компоненты hosted engine, и этот хост не будет работать как часть кластера высокой доступности.
iscsi
(добавлен в 2.4)
нет
Если state iscsidiscover, это означает, что атрибут iscsi используется для обнаружения целевых устройств.
Если state iscsilogin, это означает, что атрибут iscsi используется для входа в указанные целевые устройства, переданные в качестве части атрибута iscsi.
kdump_integration
нет enabled
  • enabled
  • disabled
Указать, будет ли у хоста включена интеграция 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
нет
Переопределить адрес отображения всех виртуальных машин на этом хосте указанным адресом.
override_iptables
нет
Если True, iptables хоста будут переопределены скриптом развертывания хоста.
Обратите внимание, что override_iptables по умолчанию false в oVirt/RHV.
password
нет
Пароль root. Он требуется в случае, если public_key установлен в False.
poll_interval
нет 3
Количество секунд, которое модуль ждёт до отправки нового запроса опроса состояния сущности.
power_management_enabled
(добавлен в 2.4)
нет
Включить или отключить управление питанием хоста.
Для более всеобъемлющей настройки управления питанием используйте модуль ovirt_host_pm.
public_key
нет
True, если для аутентификации на хосте должен использоваться открытый ключ.
Требуется в случае, если password не задан.
псевдонимы: ssh_public_key
spm_priority
нет
Приоритет SPM хоста. Целое число от 1 до 10, где большее число означает более высокий приоритет.
state
нет present
  • present
  • absent
  • maintenance
  • upgraded
  • started
  • restarted
  • stopped
  • reinstalled
  • iscsidiscover
  • iscsilogin
Состояние, в котором хост должен находиться после успешного завершения.
iscsilogin и iscsidiscover поддерживаются с версии 2.4.
timeout
нет 180
Время в секундах, которое модуль должен ждать, пока экземпляр не перейдёт в нужное состояние.
wait
нет
True, если модуль должен ждать, пока сущность не перейдёт в нужное состояние.

Примеры

# 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
Словарь всех атрибутов хоста. Атрибуты хоста можно найти на вашем экземпляре oVirt/RHV по следующему URL-адресу: http://ovirt.github.io/ovirt-engine-api-model/master/#types/host.
При успехе, если хост найден. dict
id
ID хоста, который управляется
При успехе, если хост найден. str 7de90f31-222c-436c-a1ca-7e655bd5b60c
iscsi_targets
Список целевых устройств iscsi хоста
При успехе, если хост найден и состояние iscsidiscover. list

Примечания

Примечание

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

Статус

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

Для получения помощи в разработке модулей, если у вас есть желание, пожалуйста, ознакомьтесь с Справочной информацией сообщества и сотрудничеством, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ovirt_hosts_module.html

Spec-Zone.ru

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