ovirt_vnic_profile – Модуль для управления профилем vNIC сети в oVirt/RHV
Новое в версии 2.8.
Синопсис
- Модуль для управления профилем vNIC сети в oVirt/RHV
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| 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 логическое значение |
| Логический флаг, указывающий, нужно ли проверять серверный TLS-сертификат и имя хоста. | |
| kerberos логическое значение |
| Логический флаг, указывающий, следует ли использовать аутентификацию 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. | ||
| custom_properties - | Настраиваемые свойства, применяемые к профилю vNIC. Настраиваемые свойства — это список словарей, которые могут иметь следующие значения: | ||
| name - | Имя настраиваемого свойства. Например: hugepages, vhost, sap_agent и т. д. | ||
| regexp - | Регулярное выражение для настраиваемого свойства. | ||
| value - | Значение для настраиваемого свойства. | ||
| data_center - / обязательно | Имя ЦОД, где находится сеть. | ||
| description - | Описание, читаемое человеком, в простом тексте. | ||
| fetch_nested логическое значение добавлено в 2.3 |
| Если True, модуль извлечет дополнительные данные из API. Он извлечет идентификаторы дисков, снимков и т. д. ВМ. Пользователь может настроить извлечение других атрибутов вложенных сущностей, указав nested_attributes. | |
| migratable логическое значение |
| Указывает, можно ли мигрировать сетевую карту pass_through. | |
| name - / обязательно | Читаемое человеком имя в простом тексте. | ||
| nested_attributes список добавлено в 2.3 | Указывает список атрибутов, которые должны быть извлечены из API. Этот параметр применяется только тогда, когда fetch_nested имеет значение true. | ||
| network - / обязательно | Имя сети, к которой подключена сетевая карта vNIC. | ||
| network_filter - | Фильтр сети позволяет фильтровать пакеты, отправляемые/получаемые сетевой картой ВМ, в соответствии с определенными правилами. | ||
| pass_through - |
| Включает проброс на оснащенную SR-IOV сетевую карту хоста. При включении qos и network_filter автоматически устанавливаются в None, а port_mirroring — в False.При включении и отсутствии migratable, migratable включено.Отражение порта, QoS и сетевые фильтры не поддерживаются в профилях проброса. | |
| poll_interval целое число | По умолчанию: 3 | Количество секунд, которое модуль ожидает до отправки нового запроса опроса о статусе сущности. | |
| port_mirroring логическое значение |
| Включает отражение порта. | |
| qos - | Атрибуты качества обслуживания регулируют сетевой трафик NIC по направлению к ВМ и от неё. | ||
| state - |
| Должна ли сетевая карта vNIC отсутствовать/присутствовать. | |
| timeout целое число | По умолчанию: 180 | Время в секундах, которое модуль должен ждать, пока экземпляр не перейдет в нужное состояние. | |
| wait логическое значение |
| 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:
- name: Add vNIC
ovirt_vnic_profile:
name: myvnic
network: mynetwork
state: present
data_center: datacenter
- name: Editing vNICs network_filter, custom_properties, qos
ovirt_vnic_profile:
name: myvnic
network: mynetwork
data_center: datacenter
qos: myqos
custom_properties:
- name: SecurityGroups
value: 9bd9bde9-39da-44a8-9541-aa39e1a81c9d
network_filter: allow-dhcp
- name: Dont use migratable
ovirt_vnic_profile:
name: myvnic
network: mynetwork
data_center: datacenter
migratable: False
pass_through: enabled
- name: Remove vNIC
ovirt_vnic_profile:
name: myvnic
network: mynetwork
state: absent
data_center: datacenter
Возвращаемые значения
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| id строка | При успешном поиске профиля vNIC. | Идентификатор управляемого профиля vNIC. Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
| vnic словарь | При успешном поиске профиля vNIC. | Словарь всех атрибутов профиля vNIC. Атрибуты сетевого интерфейса можно найти на вашей oVirt/RHV-инстанции по следующему адресу: http://ovirt.github.io/ovirt-engine-api-model/master/#types/nic. |
Статус
- Интерфейс этого модуля не гарантирует обратной совместимости. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Ondra Machacek (@machacekondra)
- Martin Necas (@mnecas)
Подсказка
Если вы заметили какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_vnic_profile_module.html
