Spec-Zone.ru › Ansible

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

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

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

cd_drive

string

CD-диск, который вы хотите подключить к VM, когда state=cd.

cluster

string

Кластер RHEV/oVirt, в котором вы хотите запустить свою VM.

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

cpu_share

integer

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

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

datacenter

string

Центр обработки данных RHEV/oVirt, в котором вы хотите запустить свою VM.

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

del_prot

boolean

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

Варианты:

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

disks

list / elements=string

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

ifaces

алиасы: interfaces, nics

list / elements=string

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

image

string

Шаблон для использования с VM.

insecure_api

boolean

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

Варианты:

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

mempol

integer

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

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

name

string

Имя VM.

osver

string

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

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

password

string / required

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

port

integer

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

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

server

string

Имя/IP вашего экземпляра RHEV-m/oVirt.

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

state

string

Служит для создания/удаления/обновления или управления питанием вашей VM.

Варианты:

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

timeout

integer

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

Когда state=up.

Когда state=down.

Когда state=restarted.

type

string

Для определения того, является ли VM сервером или рабочим столом.

Варианты:

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

user

string

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

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

vm_ha

boolean

Для повышения доступности вашей VM.

Варианты:

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

vmcpu

integer

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

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

vmhost

string

Хост, на котором вы хотите запустить свою виртуальную машину.

vmmem

integer

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

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

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: нет

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

diff_mode

Поддержка: нет

Вернет подробности о том, что изменилось (или, возможно, требует изменения в check_mode), когда режим diff включен.

Примеры

- 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

словарь

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

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

Пример: {"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–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

Spec-Zone.ru

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