Spec-Zone.ru › Ansible 2.6

rhevm — Автоматизация RHEV/oVirt

Новая версия 2.2.

  • Обзор
    • Требования
  • Параметры
  • Примеры
  • Значения возврата
  • Статус
  • Техническое обслуживание
    • Автор

Обзор

  • Этот модуль поддерживает только oVirt/RHEV версии 3. Более новый модуль ovirt_vms поддерживает oVirt/RHV версии 4.
  • Позволяет создавать/удалять/обновлять или управлять питанием виртуальных машин на платформе RHEV/oVirt.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

  • ovirtsdk

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
boot_order Значение по умолчанию:
["network", "hd"]
Этот параметр использует сложные аргументы и представляет собой список элементов, определяющих порядок загрузки.
cd_drive
Диск CD, который необходимо смонтировать на ВМ при state = 'CD'.
cluster
Кластер rhev/ovirt, в котором должна быть запущена ВМ.
cpu_share Значение по умолчанию:
"0"
Этот параметр используется для настройки доли ЦП.
datacenter Значение по умолчанию:
"Default"
Центр обработки данных rhev/ovirt, в котором должна быть запущена ВМ.
del_prot
bool
    Варианты:
  • no
  • да ←
Этот параметр устанавливает флажок защиты от удаления.
disks
Этот параметр использует сложные аргументы и представляет собой список дисков с параметрами имя, размер и домен.
ifaces
Этот параметр использует сложные аргументы и представляет собой список интерфейсов с параметрами имя и vlan.

Псевдонимы: nics, interfaces
image
Шаблон, который необходимо использовать для ВМ.
insecure_api
bool
    Варианты:
  • нет ←
  • да
Логический переключатель для создания безопасного или небезопасного соединения с сервером.
mempol Значение по умолчанию:
"1"
Минимальный объем памяти, который необходимо зарезервировать для этой системы.
name
Имя ВМ.
osver Значение по умолчанию:
"rhel_6x64"
Параметр операционной системы в RHEV/oVirt.
port Значение по умолчанию:
"443"
Порт, по которому доступен API.
server Значение по умолчанию:
"127.0.0.1"
Имя/IP вашего экземпляра RHEV-m/oVirt.
state
    Варианты:
  • ping
  • present ←
  • absent
  • up
  • down
  • restarted
  • cd
  • info
Служит для создания/удаления/обновления или управления питанием вашей ВМ.
timeout
Таймаут, который необходимо определить для действий по управлению питанием.
При state = 'up'
При state = 'down'
При state = 'restarted'
type
    Варианты:
  • server ←
  • desktop
  • host
Определяет, является ли ВМ сервером или рабочим столом.
user Значение по умолчанию:
"admin@internal"
Пользователь для аутентификации.
vm_ha
bool
    Варианты:
  • no
  • да ←
Для обеспечения высокой доступности вашей ВМ.
vmcpu Значение по умолчанию:
"2"
Количество ЦП, необходимое для вашей ВМ.
vmhost
Хост, на котором должна работать ваша ВМ.
vmmem Значение по умолчанию:
"1"
Объем памяти, который вы хотите использовать для вашей ВМ (в ГБ).

Примеры

# basic get info from VM
  - rhevm:
      name: "demo"
      user: "{{ rhev.admin.name }}"
      password: "{{ rhev.admin.pass }}"
      server: "rhevm01"
      state: "info"

# basic create example from image
  - rhevm:
      name: "demo"
      user: "{{ rhev.admin.name }}"
      password: "{{ rhev.admin.pass }}"
      server: "rhevm01"
      state: "present"
      image: "centos7_x64"
      cluster: "centos"

# power management
  - rhevm:
      name: "uptime_server"
      user: "{{ rhev.admin.name }}"
      password: "{{ rhev.admin.pass }}"
      server: "rhevm01"
      cluster: "RH"
      state: "down"
      image: "centos7_x64"

# multi disk, multi nic create example
  - rhevm:
      name: "server007"
      user: "{{ rhev.admin.name }}"
      password: "{{ rhev.admin.pass }}"
      server: "rhevm01"
      cluster: "RH"
      state: "present"
      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"

# add a CD to the disk cd_drive
  - rhevm:
      name: 'server007'
      user: "{{ rhev.admin.name }}"
      password: "{{ rhev.admin.pass }}"
      state: 'cd'
      cd_drive: 'rhev-tools-setup.iso'

# new host deployment + host network configuration
  - rhevm:
      name: "ovirt_node007"
      password: "{{ rhevm.admin.pass }}"
      type: "host"
      state: present
      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'

Значения возврата

Общие значения возврата описаны в здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
vm
dict
всегда
Возвращает все переменные ВМ и результаты выполнения.

Пример:
{ "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": "server", "uuid": "4ba5a1be-e60b-4368-9533-920f156c817b", "vm_ha": true, "vmcpu": "4", "vmhost": "host416", "vmmem": "16" }


Статус

Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Более подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

  • Timothy Vandenbrande

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/rhevm_module.html

Spec-Zone.ru

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