Spec-Zone.ru › Ansible 2.11

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
логическое значение
    Варианты:
  • no
  • yes ←
Этот параметр устанавливает флажок защиты от удаления.
disks
список / элементы=строка
Этот параметр использует сложные аргументы и представляет собой список дисков с параметрами имя, размер и домен.
ifaces
список / элементы=строка
Этот параметр использует сложные аргументы и представляет собой список интерфейсов с параметрами имя и vlan.

Псевдонимы: interfaces, nics
image
строка
Шаблон, который нужно использовать для виртуальной машины.
insecure_api
логическое значение
    Варианты:
  • no ←
  • yes
Логический переключатель для создания защищенного или незащищенного соединения с сервером.
mempol
целое число
Значение по умолчанию:
1
Минимальный объем памяти, который необходимо зарезервировать для этой системы.
name
строка
Имя виртуальной машины.
osver
строка
Значение по умолчанию:
"rhel_6x64"
Вариант операционной системы в RHEV/oVirt.
password
строка / обязательно
Пароль для проверки подлинности пользователя.
port
целое число
Значение по умолчанию:
443
Порт, на котором доступен API.
server
строка
Значение по умолчанию:
"127.0.0.1"
Имя/IP вашего экземпляра RHEV-m/oVirt.
state
строка
    Варианты:
  • absent
  • cd
  • down
  • info
  • ping
  • present ←
  • restarted
  • up
Служит для создания/удаления/обновления или управления питанием вашей виртуальной машины.
timeout
целое число
Таймаут, который вы хотите задать для действий по управлению питанием.
При state = 'up'.
При state = 'down'.
При state = 'restarted'.
type
строка
    Варианты:
  • desktop
  • host
  • server ←
Чтобы определить, является ли виртуальная машина сервером или рабочим столом.
user
строка
Значение по умолчанию:
"admin@internal"
Пользователь для аутентификации.
vm_ha
логическое значение
    Варианты:
  • no
  • yes ←
Для обеспечения высокой доступности вашей виртуальной машины.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API