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