vmadm — Управление виртуальными машинами и зонами SmartOS.
Новое в версии 2.3.
Обзор
- Управление виртуальными машинами SmartOS с помощью vmadm(1M).
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
Параметры
| параметр | обязательно | по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| archive_on_delete | нет | При включении, набор данных зоны будет смонтирован на /zones/archive при удалении. | ||
| autoboot | нет | Будет ли VM запущен при перезагрузке системы. | ||
| boot | нет | Установите порядок загрузки для KVM-VM. | ||
| brand | да | joyent |
| Тип виртуальной машины. |
| cpu_cap | нет | Устанавливает ограничение на количество времени использования ЦП VM. Используйте 0 для отсутствия ограничения. | ||
| cpu_shares | нет | Устанавливает ограничение на количество квот планировщика с справедливым распределением ЦП (FSS) для VM. Это ограничение относительно всех других VM в системе. | ||
| cpu_type | нет | qemu64 |
| Управление типом виртуального ЦП, доступного для KVM-VM. |
| customer_metadata | нет | Метаданные, которые должны быть установлены и ассоциированы с данной VM, содержат изменяемые пользователем ключи. | ||
| delegate_dataset | нет | Определяет, делегировать ли набор данных ZFS в операционную VM. | ||
| disk_driver | нет | Значение по умолчанию для модели виртуального диска для KVM-гостей. | ||
| disks | нет | Список дисков для добавления, допустимые свойства описаны в vmadm(1M). | ||
| dns_domain | нет | Значение домена для /etc/hosts. | ||
| filesystems | нет | Подключение дополнительных файловых систем к операционной VM. | ||
| firewall_enabled | нет | Включает брандмауэр, позволяя применять правила fwadm(1M). | ||
| force | нет | Принудительное выполнение определенного действия (например, остановка или удаление VM). | ||
| fs_allowed | нет | Список файловых систем, разделенных запятыми, которые разрешено монтировать этой зоне. | ||
| hostname | нет | Имя хоста зоны/VM. | ||
| image_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 | нет | Общий объем памяти (в MiB) на хосте, которую может заблокировать данная VM. | ||
| max_lwps | нет | Максимальное количество лёгких процессов, которые разрешено запускать данной VM. | ||
| max_physical_memory | нет | Максимальный объём физической памяти (в MiB) на хосте, которую разрешено использовать VM. | ||
| max_swap | нет | Максимальный объём виртуальной памяти (в MiB), которую разрешено использовать 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 | нет | Квота на файловые системы зоны (в MiB). | ||
| ram | нет | Объем виртуальной оперативной памяти для KVM-гостя (в MiB). | ||
| resolvers | нет | Список резолверов, которые должны быть помещены в /etc/resolv.conf. | ||
| routes | нет | Словарь, который сопоставляет назначения с шлюзами, эти значения будут установлены как статические маршруты в VM. | ||
| spice_opts | нет | Дополнительные параметры для SPICE-совместимых KVM-VM. | ||
| spice_password | нет | Пароль, необходимый для подключения к SPICE. По умолчанию пароль не установлен. Обратите внимание, что его можно получить из глобальной зоны. | ||
| state | да |
| Состояния для VM. Обратите внимание, что present, stopped и restarted работают с уже развернутой VM. present означает, что VM будет создана, если ее не было, и что она будет в состоянии выполнения. absent выключит зону перед удалением. stopped означает, что зона будет создана, если она еще не существует, перед её выключением. | |
| tmpfs | нет | Объем памяти (в MiB), который будет доступен в 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 и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/vmadm_module.html
