community.general.rhevm модуль — автоматизация RHEV/oVirt
Примечание
Этот модуль входит в коллекцию community.general (версия 9.5.0).
Эта коллекция, возможно, уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Для использования в книге задач укажите: community.general.rhevm.
Обзор
- Этот модуль поддерживает только версии oVirt/RHEV 3.
- Более новый модуль ovirt.ovirt.ovirt_vm поддерживает версии oVirt/RHV 4.
- Позволяет создавать/удалять/обновлять или управлять питанием виртуальных машин на платформе RHEV/oVirt.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- ovirtsdk
Параметры
Параметр | Комментарии |
|---|---|
boot_order list / elements=string | Этот параметр использует сложные аргументы и представляет собой список элементов, указывающих порядок загрузки. По умолчанию: |
cd_drive string | CD-диск, который вы хотите подключить к VM, когда |
cluster string | Кластер RHEV/oVirt, в котором вы хотите запустить свою VM. По умолчанию: |
integer | Этот параметр используется для настройки доли процессора. По умолчанию: |
datacenter string | Центр обработки данных RHEV/oVirt, в котором вы хотите запустить свою VM. По умолчанию: |
del_prot boolean | Этот параметр устанавливает флажок защиты от удаления. Варианты:
|
disks list / elements=string | Этот параметр использует сложные аргументы и представляет собой список дисков с параметрами имени, размера и домена. |
ifaces алиасы: interfaces, nics list / elements=string | Этот параметр использует сложные аргументы и представляет собой список интерфейсов с параметрами имени и VLAN. |
image string | Шаблон для использования с VM. |
insecure_api boolean | Булевый переключатель для установления защищенного или незащищенного соединения с сервером. Варианты:
|
mempol integer | Минимальный объем памяти, который вы хотите зарезервировать для этой системы. По умолчанию: |
name string | Имя VM. |
osver string | Параметр операционной системы в RHEV/oVirt. По умолчанию: |
password string / required | Пароль для аутентификации пользователя. |
port integer | Порт, на котором доступен API. По умолчанию: |
server string | Имя/IP вашего экземпляра RHEV-m/oVirt. По умолчанию: |
state string | Служит для создания/удаления/обновления или управления питанием вашей VM. Варианты:
|
timeout integer | Тайм-аут, который вы хотите задать для действий управления питанием. Когда Когда Когда |
type string | Для определения того, является ли VM сервером или рабочим столом. Варианты:
|
user string | Пользователь для аутентификации. По умолчанию: |
vm_ha boolean | Для повышения доступности вашей VM. Варианты:
|
vmcpu integer | Количество процессоров, которое вы хотите в вашей виртуальной машине. По умолчанию: |
vmhost string | Хост, на котором вы хотите запустить свою виртуальную машину. |
vmmem integer | Объем памяти, который вы хотите использовать для вашей виртуальной машины (в ГБ). По умолчанию: |
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: нет | Может работать в режиме |
diff_mode | Поддержка: нет | Вернет подробности о том, что изменилось (или, возможно, требует изменения в |
Примеры
- 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: true
- 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 словарь | Возвращает все переменные и выполнение виртуальных машин. Возвращается: всегда Пример: |
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/rhevm_module.html