community.vmware.vmware_host_sriov – Управление параметрами SR-IOV на хосте
Примечание
Этот плагин является частью коллекции community.vmware (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в книге задач укажите: community.vmware.vmware_host_sriov.
В версии 1.0.0: коллекции community.vmware
Обзор
- Этот модуль может использоваться для настройки, включения или выключения функций SR-IOV на хосте ESXi.
- Модуль не перезагружает хост после изменений, но устанавливает его в состояние «rebootRequired».
- Пользователь может указать имя хоста ESXi или имя кластера. В случае имени кластера все хосты ESXi обновляются.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.7
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name
строка
|
Имя кластера, из которого будут использоваться все хосты.
Этот параметр требуется, если
esxi_hostname не указан. |
|
| esxi_hostname
строка
|
Имя хоста для работы.
Этот параметр требуется, если
cluster_name не указан.Пользователь может указать конкретный хост из кластера.
|
|
| hostname
строка
|
Имя хоста или IP-адрес сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения
VMWARE_HOST.Поддержка переменных окружения добавлена в Ansible 2.6.
|
|
| num_virt_func
целое число / обязательно
|
количество функций для активации на интерфейсе.
0 означает отключение SR-IOV.
число больше 0 означает включение SR-IOV.
|
|
| password
строка
|
Пароль сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения
VMWARE_PASSWORD.Поддержка переменных окружения добавлена в Ansible 2.6.
псевдонимы: pass, pwd |
|
| port
целое число
|
По умолчанию: 443 |
Номер порта сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения
VMWARE_PORT.Поддержка переменных окружения добавлена в Ansible 2.6.
|
| proxy_host
строка
|
Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их.
Формат — имя хоста или IP.
Если значение не указано в задаче, используется значение переменной окружения
VMWARE_PROXY_HOST.Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
|
|
| proxy_port
целое число
|
Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их.
Если значение не указано в задаче, используется значение переменной окружения
VMWARE_PROXY_PORT. |
|
| sriov_on
булево
|
|
Необязательный параметр, связанный с
num_virt_func.SR-IOV может быть включен только если
num_virt_func > 0. |
| username
строка
|
Имя пользователя сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения
VMWARE_USER.Поддержка переменных окружения добавлена в Ansible 2.6.
псевдонимы: admin, user |
|
| validate_certs
булево
|
|
Разрешает подключение, когда сертификаты SSL недействительны. Установите в значение
false, когда сертификаты не доверенны.Если значение не указано в задаче, используется значение переменной окружения
VMWARE_VALIDATE_CERTS.Поддержка переменных окружения добавлена в Ansible 2.6.
Если установлено значение
true, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
| vmnic
строка / обязательно
|
Имя интерфейса, например vmnic0.
|
Примечания
Примечание
- Проверено на vSphere 6.0
Примеры
- name: enable SR-IOV on vmnic0 with 8 functions
community.vmware.vmware_host_sriov:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
esxi_hostname: "{{ esxi1 }}"
vmnic: vmnic0
sriov_on: true
num_virt_func: 8
- name: enable SR-IOV on already enabled interface vmnic0
community.vmware.vmware_host_sriov:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
esxi_hostname: "{{ esxi1 }}"
vmnic: vmnic0
sriov_on: true
num_virt_func: 8
- name: enable SR-IOV on vmnic0 with big number of functions
community.vmware.vmware_host_sriov:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
esxi_hostname: "{{ esxi1 }}"
vmnic: vmnic0
sriov_on: true
num_virt_func: 100
ignore_errors: true
- name: disable SR-IOV on vmnic0
community.vmware.vmware_host_sriov:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
esxi_hostname: "{{ esxi1 }}"
vmnic: vmnic0
sriov_on: false
num_virt_func: 0
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| host_sriov_diff
словарь
|
всегда |
содержит информацию о состоянии SR-IOV на vmnic до, после и запрошенные изменения
иногда vCenter медленно обновляет информацию, в результате «после» содержит такую же информацию, как «до». Необходимо запустить снова в режиме проверки или перезагрузить хост, поскольку ESXi запросил
Пример:
{'changed': True, 'diff': {'after': {'host_test': {'maxVirtualFunctionSupported': 63, 'numVirtualFunction': 0, 'numVirtualFunctionRequested': 8, 'rebootRequired': True, 'sriovActive': False, 'sriovCapable': True, 'sriovEnabled': True}}, 'before': {'host_test': {'maxVirtualFunctionSupported': 63, 'numVirtualFunction': 0, 'numVirtualFunctionRequested': 0, 'rebootRequired': False, 'sriovActive': False, 'sriovCapable': True, 'sriovEnabled': False}}, 'changes': {'host_test': {'numVirtualFunction': 8, 'rebootRequired': True, 'sriovEnabled': True}}}}
|
Авторы
- Виктор Цимбалюк (@victron)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_host_sriov_module.html
