Spec-Zone.ru › Ansible 2.5

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
Адрес хоста. Может быть полным доменным именем (предпочтительно) или 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 и 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
    Варианты:
  • 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 ←
  • absent
  • maintenance
  • upgraded
  • started
  • restarted
  • stopped
  • reinstalled
  • iscsidiscover
  • iscsilogin
Состояние, в котором хост должен находиться после успешного завершения.
iscsilogin и iscsidiscover поддерживаются с версии 2.4.
timeout Значение по умолчанию:
180
Количество секунд, в течение которого модуль должен ждать, пока экземпляр не перейдёт в нужное состояние.
wait
True, если модуль должен ждать, пока сущность не перейдёт в нужное состояние.

Примечания

Примечание

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

id
строка
При успехе, если хост найден.
Идентификатор управляемого хоста.

Пример:
7de90f31-222c-436c-a1ca-7e655bd5b60c
iscsi_targets
список
При успехе, если хост найден и состояние равно iscsidiscover.
Список целевых устройств iscsi хоста



Статус

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

Автор

  • Ondřej Macháček (@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.5/modules/ovirt_hosts_module.html

Spec-Zone.ru

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