rhevm – Автоматизация RHEV/oVirt
Новое в версии 2.2.
Обзор
- Этот модуль поддерживает только oVirt/RHEV версии 3.
- Новый модуль 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
rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: demo
state: info
- name: Basic create example from image
rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: demo
cluster: centos
image: centos7_x64
state: present
- name: Power management
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
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
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
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" } |
Статус
- Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Timothy Vandenbrande (@TimothyVandenbrande)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/rhevm_module.html