Spec-Zone.ru › Ansible

Модуль community.general.rhevm — автоматизация RHEV/oVirt

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет 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

Параметр принимает сложные аргументы и представляет собой список элементов, задающих порядок загрузки.

По умолчанию: ["hd", "network"]

cd_drive

string

Компакт-диск, который нужно подключить к виртуальной машине при state=cd.

cluster

string

Кластер RHEV/oVirt, в котором должна запуститься виртуальная машина.

По умолчанию: ""

cpu_share

integer

Параметр используется для настройки доли процессорного времени.

По умолчанию: 0

datacenter

string

Дата-центр RHEV/oVirt, в котором должна запуститься виртуальная машина.

По умолчанию: "Default"

del_prot

boolean

Этот параметр устанавливает флажок защиты от удаления.

Варианты:

  • false
  • true ← (по умолчанию)

disks

list / elements=string

Параметр принимает сложные аргументы и представляет собой список дисков с параметрами name, size и domain.

ifaces

псевдонимы: interfaces, nics

list / elements=string

Параметр принимает сложные аргументы и представляет собой список интерфейсов с параметрами name и vlan.

image

string

Шаблон, используемый для виртуальной машины.

insecure_api

boolean

Логический переключатель для установки защищённого или незащищённого соединения с сервером.

Варианты:

  • false ← (по умолчанию)
  • true

mempol

integer

Минимальный объём памяти, который нужно зарезервировать для этой системы.

По умолчанию: 1

name

string

Имя виртуальной машины.

osver

string

Параметр операционной системы в RHEV/oVirt.

По умолчанию: "rhel_6x64"

password

string / обязательный

Пароль для аутентификации пользователя.

port

integer

Порт, по которому доступен API.

По умолчанию: 443

server

string

Имя/IP-адрес экземпляра RHEV-m/oVirt.

По умолчанию: "127.0.0.1"

state

string

Используется для создания, удаления и обновления виртуальной машины, а также для управления её питанием.

Варианты:

  • "absent"
  • "cd"
  • "down"
  • "info"
  • "ping"
  • "present" ← (по умолчанию)
  • "restarted"
  • "up"

timeout

integer

Тайм-аут, задаваемый для операций управления питанием.

Если state=up.

Если state=down.

Если state=restarted.

type

string

Определяет, является ли виртуальная машина сервером или рабочей станцией.

Варианты:

  • "desktop"
  • "host"
  • "server" ← (по умолчанию)

user

string

Пользователь для аутентификации.

По умолчанию: "admin@internal"

vm_ha

boolean

Обеспечивает высокую доступность виртуальной машины.

Варианты:

  • false
  • true ← (по умолчанию)

vmcpu

integer

Количество процессоров, выделяемых виртуальной машине.

По умолчанию: 2

vmhost

string

Хост, на котором должна работать виртуальная машина.

vmmem

integer

Объём памяти, выделяемой виртуальной машине (в ГБ).

По умолчанию: 1

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: none

Может работать в режиме check_mode и возвращать прогноз изменений, не изменяя целевую систему.

diff_mode

Поддержка: none

В режиме сравнения возвращает сведения о внесённых изменениях (или об изменениях, которые, возможно, необходимо внести в check_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

dictionary

Возвращает все переменные виртуальной машины и сведения о выполнении.

Возвращается: всегда

Пример: {"boot_order": ["hd", "network"], "changed": true, "changes": ["Delete Protection"], "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": "Management"}, {"name": "eth1", "vlan": "Internal"}, {"name": "eth2", "vlan": "External"}], "image": false, "mempol": "0", "msg": ["VM exists", "cpu_share was already set to 0", "VM high availability was already set to True", "The boot order has already been set", "VM delete protection has been set to True", "Disk web2_Disk0_OS already exists", "The VM starting host was already set to host416"], "name": "web2", "type": "server", "uuid": "4ba5a1be-e60b-4368-9533-920f156c817b", "vm_ha": true, "vmcpu": "4", "vmhost": "host416", "vmmem": "16"}

Авторы

  • Timothy Vandenbrande (@TimothyVandenbrande)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Задать вопрос
  • Сообщить об ошибке
  • Предложить функцию
  • Связь

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/rhevm_module.html

Spec-Zone.ru

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