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

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

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

Описание

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

Требования

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

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
archive_on_delete		При включении, набор данных зоны будет смонтирован в `/zones/archive` при удалении.
autoboot		Будет ли VM запущена при перезагрузке системы.
boot		Установить порядок загрузки для KVM VM.
brand обязательно	Варианты: joyent ← joyent-minimal kvm lx	Тип виртуальной машины.
cpu_cap		Устанавливает ограничение на количество времени использования ЦП VM. Используйте `0` для отсутствия ограничения.
cpu_shares		Устанавливает ограничение на количество квот планировщика FSS CPU для VM. Это ограничение относительно всех других VM в системе.
cpu_type	Варианты: qemu64 ← host	Управление типом виртуального процессора, предоставляемого для KVM VM.
customer_metadata		Метаданные, которые будут установлены и связаны с этой VM, содержат ключи, изменяемые пользователем.
delegate_dataset		Указывает, делегировать ли набор данных ZFS VM с ОС.
disk_driver		Значение по умолчанию для модели виртуального диска для гостевых систем KVM.
disks		Список дисков для добавления, допустимые свойства описаны в vmadm(1M).
dns_domain		Значение домена для `/etc/hosts`.
docker (добавлен в 2.5)		Для образов Docker требуется включить этот флаг вместе с установкой brand на `lx`.
filesystems		Монтирование дополнительных файловых систем в гостевую VM с ОС.
firewall_enabled		Включает брандмауэр, позволяя применять правила fwadm(1M).
force		Принудительное выполнение определённого действия (например, остановка или удаление VM).
fs_allowed		Список файловых систем, через запятую, которые разрешено монтировать для этой зоны.
hostname		Имя хоста зоны/VM.
image_uuid		UUID образа.
indestructible_delegated		Добавляет `@indestructible` снимок к делегированным наборам данных.
indestructible_zoneroot		Добавляет `@indestructible` снимок к zoneroot.
internal_metadata		Метаданные, которые будут установлены и связаны с этой VM, содержат ключи, сгенерированные оператором.
internal_metadata_namespace		Список пространств имён, которые будут установлены как internal_metadata-only; эти пространства имён будут взяты из internal_metadata, а не из customer_metadata.
kernel_version		Версия ядра для эмуляции в LX VM.
limit_priv		Установить (через запятую) список привилегий, которые разрешено использовать зоне.
maintain_resolvers		Серверы имен в `/etc/resolv.conf` будут обновлены при обновлении свойства resolvers.
max_locked_memory		Общий объём памяти (в МБ) на хосте, который может быть заблокирован этой VM.
max_lwps		Максимальное количество лёгких процессов, которые разрешено иметь у данной VM.
max_physical_memory		Максимальный объём физической памяти (в МБ) на хосте, который разрешено использовать VM.
max_swap		Максимальный объём виртуальной памяти (в МБ), который разрешено использовать VM.
mdata_exec_timeout		Таймаут в секундах (или 0 для отключения) для службы `svc:/smartdc/mdata:execute`, которая выполняет пользовательские скрипты в зоне.
name		Имя VM. vmadm(1M) использует его как необязательное имя. псевдонимы: alias
nic_driver		Значение по умолчанию для модели виртуальной сетевой карты для гостевых систем KVM.
nics		Список сетевых карт для добавления, допустимые свойства описаны в vmadm(1M).
nowait		Считать предоставление завершённым, когда VM впервые запустится, а не когда VM перезагрузится.
qemu_extra_opts		Дополнительные параметры командной строки qemu для гостевых систем KVM.
qemu_opts		Дополнительные аргументы qemu для гостевых систем KVM. Это переписывает параметры по умолчанию, предоставленные vmadm(1M), и следует использовать только для отладки.
quota		Квота на файловые системы зоны (в МБ).
ram		Объём виртуальной оперативной памяти для гостевой системы KVM (в МБ).
resolvers		Список серверов имен для размещения в `/etc/resolv.conf`.
routes		Словарь, сопоставляющий адреса назначения шлюзам. Эти значения будут установлены как статические маршруты в VM.
spice_opts		Дополнительные параметры для KVM VM с поддержкой SPICE.
spice_password		Пароль, необходимый для подключения к SPICE. По умолчанию пароль не установлен. Обратите внимание, что он может быть считан из глобальной зоны.
state обязательно	Варианты: present absent stopped restarted	Состояния VM. Обратите внимание, что `present`, `stopped` и `restarted` работают с VM, которые в настоящее время предоставлены. `present` означает, что VM будет создана, если она отсутствовала, и что она будет в рабочем состоянии. `absent` означает, что зона будет остановлена перед удалением. `stopped` означает, что зона будет создана, если она не существует, прежде чем её остановить.
tmpfs		Объём памяти (в МБ), который будет доступен в VM для файловой системы `/tmp`.
uuid		UUID VM. Может быть полным UUID или `*` для всех VM.
vcpus		Количество виртуальных процессоров для гостевой системы KVM.
vga		Указывает эмуляцию VGA, используемую KVM VM.
virtio_txburst		Количество пакетов, которое может быть отправлено в одном флуше очереди tx сетевых карт virtio.
virtio_txtimer		Таймаут (в наносекундах) для таймера TX сетевых карт virtio.
vnc_password		Пароль, необходимый для подключения к VNC. По умолчанию пароль не установлен. Обратите внимание, что он может быть считан из глобальной зоны.
vnc_port		TCP-порт для прослушивания сервера VNC. Или установите `0` для случайного или `-1` для отключения.
zfs_data_compression		Указывает алгоритм сжатия, используемый для набора данных этой VM. Этот параметр влияет только на делегированные наборы данных.
zfs_data_recsize		Рекомендуемый размер блока (степень двойки) для файлов в файловой системе делегированного набора данных.
zfs_filesystem_limit		Максимальное количество файловых систем, которые может иметь VM.
zfs_io_priority		Приоритет задержки ввода-вывода относительно других VM.
zfs_root_compression		Указывает алгоритм сжатия, используемый для корневого набора данных этой VM. Этот параметр влияет только на набор данных zoneroot.
zfs_root_recsize		Рекомендуемый размер блока (степень двойки) для файлов в файловой системе набора данных zoneroot.
zfs_snapshot_limit		Количество снимков, которое может иметь VM.
zpool		Набор данных ZFS, в котором будет создан набор данных зоны VM.

Примеры

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

- name: Delete a zone
  vmadm:
    alias: test_zone
    state: deleted

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

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

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

Ключ	Возвращаемое значение	Описание
alias строка	При обращении к ВМ по псевдониму.	Псевдоним управляемой ВМ. Пример: dns-zone
state строка	успех	Состояние целевого объекта после выполнения. Пример: running
uuid строка	всегда	UUID управляемой ВМ. Пример: b217ab0b-cf57-efd8-cd85-958d0b80be33

Статус

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

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

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

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

Автор

Jasper Lievisse Adriaanse (@jasperla)

Подсказка

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

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