Модуль 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 | При включении, набор данных зоны будет смонтирован на Варианты:
|
autoboot boolean | Запускать ли виртуальную машину при перезагрузке системы. Варианты:
|
boot string | Устанавливает порядок загрузки для виртуальных машин KVM. |
brand string | Тип виртуальной машины. Опция Варианты:
|
cpu_cap integer | Устанавливает ограничение на количество процессорного времени, которое может быть использовано виртуальной машиной. Используйте |
integer | Устанавливает ограничение на количество долей процессора планировщика справедливого распределения (FSS) для виртуальной машины. Это ограничение относительно всех других виртуальных машин в системе. |
cpu_type string | Управление типом виртуального процессора, предоставляемого виртуальным машинам KVM. Варианты:
|
customer_metadata dictionary | Метаданные, которые будут установлены и связаны с этой виртуальной машиной, содержат ключи, изменяемые клиентом. |
delegate_dataset boolean | Делегировать ли набор данных ZFS виртуальной машине ОС. Варианты:
|
disk_driver string | Значение по умолчанию для модели виртуального диска для гостей KVM. |
disks list / elements=dictionary | Список дисков для добавления, допустимые свойства описаны в vmadm(1M). |
dns_domain string | Значение домена для |
docker boolean | Образы Docker нуждаются в этом флаге, включенном вместе с Варианты:
|
filesystems list / elements=dictionary | Монтирует дополнительные файловые системы в виртуальную машину ОС. |
firewall_enabled boolean | Включает брандмауэр, позволяя применять правила fwadm(1M). Варианты:
|
force boolean | Принудительно выполнить определённое действие (например, остановить или удалить виртуальную машину). Варианты:
|
fs_allowed string | Список типов файловых систем, которые разрешено монтировать этой зоне, разделённый запятыми. |
hostname string | Имя хоста зоны/виртуальной машины. |
image_uuid string | UUID образа. |
indestructible_delegated boolean | Добавляет снимок Варианты:
|
indestructible_zoneroot boolean | Добавляет снимок Варианты:
|
internal_metadata dictionary | Метаданные, которые будут установлены и связаны с этой виртуальной машиной, содержат ключи, сгенерированные оператором. |
internal_metadata_namespace string | Список пространств имён, которые нужно установить как |
kernel_version string | Версия ядра для эмуляции для виртуальных машин LX. |
limit_priv string | Установить (через запятую) список привилегий, которые зона может использовать. |
maintain_resolvers boolean | Резолверы в Варианты:
|
max_locked_memory integer | Общий объём памяти (в MiB) на хосте, которую может заблокировать эта виртуальная машина. |
max_lwps integer | Максимальное количество лёгких процессов, которые эта виртуальная машина может иметь в работе. |
max_physical_memory integer | Максимальный объём памяти (в MiB) на хосте, которую виртуальная машина разрешено использовать. |
max_swap integer | Максимальный объём виртуальной памяти (в MiB), которую виртуальная машина разрешено использовать. |
mdata_exec_timeout integer | Таймаут в секундах (или 0 для отключения) для сервиса |
name псевдонимы: псевдоним string | Имя виртуальной машины. vmadm(1M) использует это в качестве необязательного имени. |
nic_driver string | Значение по умолчанию для модели виртуальной сетевой карты для гостевых систем KVM. |
nics список / элементы=словарь | Список сетевых интерфейсов для добавления, допустимые свойства описаны в vmadm(1M). |
nowait boolean | Считать обеспечение готовым, когда виртуальная машина впервые запустится, а не когда виртуальная машина перезагрузится. Варианты:
|
qemu_extra_opts string | Дополнительные аргументы командной строки qemu для гостевых систем KVM. |
qemu_opts string | Дополнительные аргументы qemu для гостевых систем KVM. Это перезаписывает аргументы по умолчанию, предоставляемые vmadm(1M), и должно использоваться только для отладки. |
quota integer | Квота на файловые системы зоны (в MiB). |
ram integer | Объём виртуальной оперативной памяти для гостевой системы KVM (в MiB). |
resolvers список / элементы=строка | Список резолверов, которые нужно добавить в |
routes словарь | Словарь, который сопоставляет пункты назначения с шлюзами; эти шлюзы будут установлены как статические маршруты в виртуальной машине. |
spice_opts string | Дополнительные параметры для виртуальных машин KVM, поддерживающих SPICE. |
spice_password string | Пароль, необходимый для подключения к SPICE. По умолчанию пароль не задан. Обратите внимание, что его можно получить из глобальной зоны. |
state string | Состояния для виртуальной машины. Обратите внимание, что Варианты:
|
tmpfs integer | Объём памяти (в MiB), который будет доступен в виртуальной машине для файловой системы |
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. Или установить |
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 | Поддержка: полная | Может работать в режиме |
diff_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 строка | Псевдоним управляемой виртуальной машины. Возвращается: При обращении к виртуальной машине по псевдониму. Пример: |
state строка | Состояние целевого объекта после выполнения. Возвращается: success Пример: |
uuid строка | UUID управляемой виртуальной машины. Возвращается: всегда Пример: |
Ссылки на сборку
© 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