Spec-Zone.ru › Ansible

Модуль community.general.vmadm — Управление виртуальными машинами и зонами SmartOS

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.vmadm.

  • Обзор
  • Параметры
  • Атрибуты
  • Примеры
  • Возвращаемые значения

Обзор

  • Управление виртуальными машинами SmartOS через vmadm(1M).

Параметры

Параметр

Комментарии

archive_on_delete

boolean

При включении, набор данных зоны будет смонтирован на /zones/archive после удаления.

Варианты:

  • false
  • true

autoboot

boolean

Запускать ли виртуальную машину при перезагрузке системы.

Варианты:

  • false
  • true

boot

string

Устанавливает порядок загрузки для виртуальных машин KVM.

brand

string

Тип виртуальной машины. Опция bhyve была добавлена в community.general 0.2.0.

Варианты:

  • "joyent" ← (по умолчанию)
  • "joyent-minimal"
  • "lx"
  • "kvm"
  • "bhyve"

cpu_cap

integer

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

cpu_shares

integer

Устанавливает ограничение на количество долей процессора планировщика справедливого распределения (FSS) для виртуальной машины. Это ограничение относительно всех других виртуальных машин в системе.

cpu_type

string

Управление типом виртуального процессора, предоставляемого виртуальным машинам KVM.

Варианты:

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

customer_metadata

dictionary

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

delegate_dataset

boolean

Делегировать ли набор данных ZFS виртуальной машине ОС.

Варианты:

  • false
  • true

disk_driver

string

Значение по умолчанию для модели виртуального диска для гостей KVM.

disks

list / elements=dictionary

Список дисков для добавления, допустимые свойства описаны в vmadm(1M).

dns_domain

string

Значение домена для /etc/hosts.

docker

boolean

Образы Docker нуждаются в этом флаге, включенном вместе с brand, установленным в lx.

Варианты:

  • false
  • true

filesystems

list / elements=dictionary

Монтирует дополнительные файловые системы в виртуальную машину ОС.

firewall_enabled

boolean

Включает брандмауэр, позволяя применять правила fwadm(1M).

Варианты:

  • false
  • true

force

boolean

Принудительно выполнить определённое действие (например, остановить или удалить виртуальную машину).

Варианты:

  • false
  • true

fs_allowed

string

Список типов файловых систем, которые разрешено монтировать этой зоне, разделённый запятыми.

hostname

string

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

image_uuid

string

UUID образа.

indestructible_delegated

boolean

Добавляет снимок @indestructible в делегированные наборы данных.

Варианты:

  • false
  • true

indestructible_zoneroot

boolean

Добавляет снимок @indestructible в корневой каталог зоны.

Варианты:

  • false
  • true

internal_metadata

dictionary

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

internal_metadata_namespace

string

Список пространств имён, которые нужно установить как internal_metadata-only; эти пространства имён будут взяты из internal_metadata вместо customer_metadata.

kernel_version

string

Версия ядра для эмуляции для виртуальных машин LX.

limit_priv

string

Установить (через запятую) список привилегий, которые зона может использовать.

maintain_resolvers

boolean

Резолверы в /etc/resolv.conf будут обновлены при обновлении свойства resolvers.

Варианты:

  • false
  • true

max_locked_memory

integer

Общий объём памяти (в MiB) на хосте, которую может заблокировать эта виртуальная машина.

max_lwps

integer

Максимальное количество лёгких процессов, которые эта виртуальная машина может иметь в работе.

max_physical_memory

integer

Максимальный объём памяти (в MiB) на хосте, которую виртуальная машина разрешено использовать.

max_swap

integer

Максимальный объём виртуальной памяти (в MiB), которую виртуальная машина разрешено использовать.

mdata_exec_timeout

integer

Таймаут в секундах (или 0 для отключения) для сервиса svc:/smartdc/mdata:execute, который выполняет пользовательские скрипты в зоне.

name

псевдонимы: псевдоним

string

Имя виртуальной машины. vmadm(1M) использует это в качестве необязательного имени.

nic_driver

string

Значение по умолчанию для модели виртуальной сетевой карты для гостевых систем KVM.

nics

список / элементы=словарь

Список сетевых интерфейсов для добавления, допустимые свойства описаны в vmadm(1M).

nowait

boolean

Считать обеспечение готовым, когда виртуальная машина впервые запустится, а не когда виртуальная машина перезагрузится.

Варианты:

  • false
  • true

qemu_extra_opts

string

Дополнительные аргументы командной строки qemu для гостевых систем KVM.

qemu_opts

string

Дополнительные аргументы qemu для гостевых систем KVM. Это перезаписывает аргументы по умолчанию, предоставляемые vmadm(1M), и должно использоваться только для отладки.

quota

integer

Квота на файловые системы зоны (в MiB).

ram

integer

Объём виртуальной оперативной памяти для гостевой системы KVM (в MiB).

resolvers

список / элементы=строка

Список резолверов, которые нужно добавить в /etc/resolv.conf.

routes

словарь

Словарь, который сопоставляет пункты назначения с шлюзами; эти шлюзы будут установлены как статические маршруты в виртуальной машине.

spice_opts

string

Дополнительные параметры для виртуальных машин KVM, поддерживающих SPICE.

spice_password

string

Пароль, необходимый для подключения к SPICE. По умолчанию пароль не задан. Обратите внимание, что его можно получить из глобальной зоны.

state

string

Состояния для виртуальной машины. Обратите внимание, что present, stopped и restarted действуют на виртуальную машину, которая в настоящее время настроена. present означает, что виртуальная машина будет создана, если её не было, и что она будет в рабочем состоянии. absent выключит зону перед удалением. stopped означает, что зона будет создана, если она ещё не существует, перед её выключением.

Варианты:

  • "present"
  • "running" ← (по умолчанию)
  • "absent"
  • "deleted"
  • "stopped"
  • "created"
  • "restarted"
  • "rebooted"

tmpfs

integer

Объём памяти (в MiB), который будет доступен в виртуальной машине для файловой системы /tmp.

uuid

string

UUID виртуальной машины. Может быть полным UUID или * для всех виртуальных машин.

vcpus

integer

Количество виртуальных процессоров для гостевой ОС KVM.

vga

string

Укажите эмуляцию VGA, используемую виртуальными машинами KVM.

virtio_txburst

integer

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

virtio_txtimer

integer

Время ожидания (в наносекундах) для таймера TX виртуальных сетевых карт virtio.

vnc_password

string

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

vnc_port

integer

TCP-порт для прослушивания сервером VNC. Или установить 0 для случайного порта, или -1 для отключения.

zfs_data_compression

string

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

zfs_data_recsize

integer

Рекомендуемый размер блока (степень двойки) для файлов в файловой системе делегированного набора данных.

zfs_filesystem_limit

integer

Максимальное количество файловых систем, которые может иметь виртуальная машина.

zfs_io_priority

integer

Приоритет обработки ввода-вывода относительно других виртуальных машин.

zfs_root_compression

string

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

zfs_root_recsize

integer

Рекомендуемый размер блока (степень двойки) для файлов в файловой системе набора данных zoneroot.

zfs_snapshot_limit

integer

Количество снимков, которые может иметь виртуальная машина.

zpool

string

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

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

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

diff_mode

Поддержка: отсутствует

Вернёт детали изменений (или, возможно, изменений, которые необходимо внести в check_mode), когда включён режим сравнения.

Примеры

- name: Create SmartOS zone
  community.general.vmadm:
    brand: joyent
    state: present
    alias: fw_zone
    image_uuid: 95f265b8-96b2-11e6-9597-972f3af4b6d5
    firewall_enabled: true
    indestructible_zoneroot: true
    nics:
      - nic_tag: admin
        ip: dhcp
        primary: true
    internal_metadata:
      root_pw: 'secret'
    quota: 1

- name: Delete a zone
  community.general.vmadm:
    alias: test_zone
    state: deleted

- name: Stop all zones
  community.general.vmadm:
    uuid: '*'
    state: stopped

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

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

Ключ

Описание

alias

строка

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

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

Пример: "dns-zone"

state

строка

Состояние целевого объекта после выполнения.

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

Пример: "running"

uuid

строка

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

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

Пример: "b217ab0b-cf57-efd8-cd85-958d0b80be33"

Авторы

  • Jasper Lievisse Adriaanse (@jasperla)

Ссылки на сборку

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

© 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/vmadm_module.html

Spec-Zone.ru

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