vmadm — Управление виртуальными машинами и зонами SmartOS.
Новое в версии 2.3.
Описание
- Управление виртуальными машинами SmartOS через vmadm(1M).
Требования
Ниже перечислены требования к хосту, на котором будет выполняться данный модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| archive_on_delete | При включении, набор данных зоны будет смонтирован на /zones/archive при удалении. | |
| autoboot | Запускать ли VM при перезагрузке системы. | |
| boot | Указать порядок загрузки для KVM VM. | |
| brand обязательно |
| Тип виртуальной машины. |
| cpu_cap | Устанавливает ограничение на количество времени использования ЦП VM. Используйте 0 для отключения ограничения. | |
| cpu_shares | Устанавливает ограничение на количество долей процессора для планировщика справедливого распределения (FSS) VM. Это ограничение относительно всех других VM на системе. | |
| cpu_type |
| Управление типом виртуального процессора, доступного для 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-только; эти пространства имён будут взяты из 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 впервые запустится, а не после перезагрузки. | |
| 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 обязательно |
| Состояния 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. Этот параметр действует только на корневой набор данных зоны. | |
| zfs_root_recsize | Рекомендуемый размер блока (степень двойки) для файлов в файловой системе корневого набора данных. | |
| 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 строка | success | Состояние целевого объекта после выполнения. Пример: running |
| uuid строка | всегда | UUID управляемой ВМ. Пример: b217ab0b-cf57-efd8-cd85-958d0b80be33 |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратной совместимости интерфейса.
Автор
- 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.5/modules/vmadm_module.html
