Spec-Zone.ru › Ansible 2.6

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
    Варианты:
  • enabled ←
  • disabled
Указывает, будет ли у хоста включена интеграция 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
    Варианты:
  • 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.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

Spec-Zone.ru

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