Spec-Zone.ru › Ansible 2.8

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
    Choices:
  • нет ←
  • да
Истина, если для аутентификации на хосте должен использоваться открытый ключ.
Требуется в случае, если password не задано.

aliases: ssh_public_key
reboot_after_upgrade
boolean
added in 2.6
    Choices:
  • нет
  • да ←
Если истина и state обновляется, перезагрузить хост после успешного обновления.
spm_priority
-
Приоритет SPM хоста. Целое значение от 1 до 10, где большее число означает более высокий приоритет.
state
-
    Choices:
  • наличие ←
  • отсутствует
  • обслуживание
  • обновлено
  • запущено
  • перезапущено
  • остановлено
  • переустановлено
  • iscsidiscover
  • iscsilogin
Состояние, в котором должен находиться хост после успешного завершения.
iscsilogin и iscsidiscover поддерживаются с версии 2.4.
timeout
integer
По умолчанию:
600
Время в секундах, которое модуль должен ждать, пока хост не перейдет в желаемое состояние.
vgpu_placement
-
added in 2.8
    Choices:
  • консолидированный
  • разделенный
Если консолидированный, каждый vGPU размещается на первой физической карте с доступным пространством. Это значение по умолчанию, использующее всё доступное пространство на физических картах.
Если разделенный, каждый vGPU размещается на отдельной физической карте, если это возможно. Это может быть полезно для повышения производительности vGPU.
wait
boolean
    Choices:
  • нет
  • да ←
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

Spec-Zone.ru

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