community.general.rhevm – Автоматизация RHEV/oVirt
Примечание
Этот плагин является частью коллекции community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.rhevm.
Обзор
- Этот модуль поддерживает только версии oVirt/RHEV 3.
- Более новый модуль ovirt.ovirt.ovirt_vm поддерживает версии oVirt/RHV 4.
- Позволяет создавать/удалять/обновлять или управлять питанием виртуальных машин на платформе RHEV/oVirt.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- ovirtsdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| boot_order список / элементы=строка | Значение по умолчанию: ["hd", "network"] | Этот параметр использует сложные аргументы и представляет собой список элементов, определяющих порядок загрузки. |
| cd_drive строка | Диск CD, который необходимо смонтировать на виртуальной машине, когда state = 'CD'. | |
| cluster строка | Кластер RHEV/oVirt, в котором должна быть запущена виртуальная машина. | |
| cpu_share целое число | Значение по умолчанию: 0 | Этот параметр используется для настройки доли ЦП. |
| datacenter строка | Значение по умолчанию: "Default" | Центр обработки данных RHEV/oVirt, в котором должна быть запущена виртуальная машина. |
| del_prot логическое значение |
| Этот параметр устанавливает флажок защиты от удаления. |
| disks список / элементы=строка | Этот параметр использует сложные аргументы и представляет собой список дисков с параметрами имя, размер и домен. | |
| ifaces список / элементы=строка | Этот параметр использует сложные аргументы и представляет собой список интерфейсов с параметрами имя и vlan. Псевдонимы: interfaces, nics | |
| image строка | Шаблон, который нужно использовать для виртуальной машины. | |
| insecure_api логическое значение |
| Логический переключатель для создания защищенного или незащищенного соединения с сервером. |
| mempol целое число | Значение по умолчанию: 1 | Минимальный объем памяти, который необходимо зарезервировать для этой системы. |
| name строка | Имя виртуальной машины. | |
| osver строка | Значение по умолчанию: "rhel_6x64" | Вариант операционной системы в RHEV/oVirt. |
| password строка / обязательно | Пароль для проверки подлинности пользователя. | |
| port целое число | Значение по умолчанию: 443 | Порт, на котором доступен API. |
| server строка | Значение по умолчанию: "127.0.0.1" | Имя/IP вашего экземпляра RHEV-m/oVirt. |
| state строка |
| Служит для создания/удаления/обновления или управления питанием вашей виртуальной машины. |
| timeout целое число | Таймаут, который вы хотите задать для действий по управлению питанием. При state = 'up'. При state = 'down'. При state = 'restarted'. | |
| type строка |
| Чтобы определить, является ли виртуальная машина сервером или рабочим столом. |
| user строка | Значение по умолчанию: "admin@internal" | Пользователь для аутентификации. |
| vm_ha логическое значение |
| Для обеспечения высокой доступности вашей виртуальной машины. |
| vmcpu целое число | Значение по умолчанию: 2 | Количество процессоров, которые вы хотите в вашей виртуальной машине. |
| vmhost строка | Хост, на котором вы хотите запустить свою виртуальную машину. | |
| vmmem целое число | Значение по умолчанию: 1 | Объем памяти, который вы хотите использовать для вашей виртуальной машины (в ГБ). |
Примеры
- name: Basic get info from VM
community.general.rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: demo
state: info
- name: Basic create example from image
community.general.rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: demo
cluster: centos
image: centos7_x64
state: present
- name: Power management
community.general.rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
cluster: RH
name: uptime_server
image: centos7_x64
state: down
- name: Multi disk, multi nic create example
community.general.rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
cluster: RH
name: server007
type: server
vmcpu: 4
vmmem: 2
ifaces:
- name: eth0
vlan: vlan2202
- name: eth1
vlan: vlan36
- name: eth2
vlan: vlan38
- name: eth3
vlan: vlan2202
disks:
- name: root
size: 10
domain: ssd-san
- name: swap
size: 10
domain: 15kiscsi-san
- name: opt
size: 10
domain: 15kiscsi-san
- name: var
size: 10
domain: 10kiscsi-san
- name: home
size: 10
domain: sata-san
boot_order:
- network
- hd
state: present
- name: Add a CD to the disk cd_drive
community.general.rhevm:
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: server007
cd_drive: rhev-tools-setup.iso
state: cd
- name: New host deployment + host network configuration
community.general.rhevm:
password: '{{ rhevm.admin.pass }}'
name: ovirt_node007
type: host
cluster: rhevm01
ifaces:
- name: em1
- name: em2
- name: p3p1
ip: 172.31.224.200
netmask: 255.255.254.0
- name: p3p2
ip: 172.31.225.200
netmask: 255.255.254.0
- name: bond0
bond:
- em1
- em2
network: rhevm
ip: 172.31.222.200
netmask: 255.255.255.0
management: yes
- name: bond0.36
network: vlan36
ip: 10.2.36.200
netmask: 255.255.254.0
gateway: 10.2.36.254
- name: bond0.2202
network: vlan2202
- name: bond0.38
network: vlan38
state: present
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| vm словарь | всегда | Возвращает все переменные и результат выполнения виртуальных машин. Пример: { "boot_order": [ "hd", "network" ], "changed": true, "changes": [ "Защита от удаления" ], "cluster": "C1", "cpu_share": "0", "created": false, "datacenter": "Default", "del_prot": true, "disks": [ { "domain": "ssd-san", "name": "OS", "size": 40 } ], "eth0": "00:00:5E:00:53:00", "eth1": "00:00:5E:00:53:01", "eth2": "00:00:5E:00:53:02", "exists": true, "failed": false, "ifaces": [ { "name": "eth0", "vlan": "Управление" }, { "name": "eth1", "vlan": "Внутренняя" }, { "name": "eth2", "vlan": "Внешняя" } ], "image": false, "mempol": "0", "msg": [ "Виртуальная машина существует", "cpu_share уже установлен в 0", "Высокая доступность виртуальной машины уже установлена в True", "Порядок загрузки уже задан", "Защита от удаления виртуальной машины установлена в True", "Диск web2_Disk0_OS уже существует", "Хост запуска виртуальной машины уже установлен на host416" ], "name": "web2", "type": "сервер", "uuid": "4ba5a1be-e60b-4368-9533-920f156c817b", "vm_ha": true, "vmcpu": "4", "vmhost": "host416", "vmmem": "16" } |
Авторы
- Timothy Vandenbrande (@TimothyVandenbrande)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/rhevm_module.html