Модуль vmware.vmware_rest.vcenter_vmtemplate_libraryitems – Создаёт элемент библиотеки в библиотеке контента из виртуальной машины
Примечание
Этот модуль является частью коллекции vmware.vmware_rest (версия 3.2.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.
Для использования в playbook укажите: vmware.vmware_rest.vcenter_vmtemplate_libraryitems.
Новое в vmware.vmware_rest 2.2.0
Описание
- Создаёт элемент библиотеки в библиотеке контента из виртуальной машины. Эта {@term операция} создаёт элемент библиотеки в библиотеке контента, содержимым которого является шаблон виртуальной машины, созданный из исходной виртуальной машины с использованием предоставленного задания создания. Шаблон виртуальной машины хранится в вновь созданном элементе библиотеки.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- vSphere 7.0.3 или более поздней версии
- python >= 3.6
- aiohttp
Параметры
Параметр | Комментарии |
|---|---|
description строка | Описание развернутой виртуальной машины. |
disk_storage словарь | Настройка хранилища для дисков шаблона виртуальной машины. Допустимые атрибуты:
Допустимые значения для этого поля:
|
disk_storage_overrides словарь | Настройка хранилища для отдельных дисков развернутой виртуальной машины. Задаётся как отображение между идентификаторами дисков в исходном шаблоне виртуальной машины, содержащемся в элементе библиотеки, и их настройками хранения. |
guest_customization словарь | Настройка настройки гостя, применяемая к развернутой виртуальной машине. Допустимые атрибуты:
|
hardware_customization словарь | Настройка аппаратной конфигурации, которая определяет обновления развернутой виртуальной машины. Допустимые атрибуты:
|
library строка | Идентификатор библиотеки, в которой должен быть создан новый элемент библиотеки. Требуется при state=[‘present’] |
name строка / обязательно | Имя развернутой виртуальной машины. Этот параметр обязателен. |
placement словарь | Информация, используемая для размещения шаблона виртуальной машины. Допустимые атрибуты:
|
powered_on булево | Указывает, должна ли развернутая виртуальная машина быть включена после развертывания. Варианты:
|
session_timeout вещественное число добавлен в vmware.vmware_rest 2.1.0 | Настройки таймаута сессии клиента. Максимальное количество секунд для всего процесса, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с. |
source_vm строка | Идентификатор исходной виртуальной машины для создания элемента библиотеки. Требуется при state=[‘present’] |
state строка | Варианты:
|
template_library_item строка | Идентификатор элемента библиотеки контента, содержащий шаблон исходной виртуальной машины для развертывания. Требуется при state=[‘deploy’] |
vcenter_hostname строка / обязательно | Имя хоста или IP-адрес vCenter vSphere Если значение не указано в задании, вместо него используется значение переменной среды |
vcenter_password строка / обязательно | Пароль vCenter vSphere Если значение не указано в задании, вместо него используется значение переменной среды |
vcenter_rest_log_file строка | Можно использовать этот необязательный параметр для указания местоположения файла журнала. Этот файл будет использоваться для записи взаимодействия HTTP REST. Файл будет сохранен на хосте, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_username строка / обязательно | Имя пользователя vCenter vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_validate_certs булево | Разрешает подключение, когда сертификаты SSL недействительны. Установите в Если значение не указано в задаче, вместо него будет использовано значение переменной среды Выбор:
|
vm_home_storage словарь | Местоположение хранилища для конфигурационных и журнальных файлов шаблона виртуальной машины. Допустимые атрибуты:
Допустимое значение для этого поля:
|
Примечания
Примечание
- Проверено на vSphere 7.0.3
Примеры
- name: Create a VM
vmware.vmware_rest.vcenter_vm:
placement:
cluster: "{{ lookup('vmware.vmware_rest.cluster_moid', '/my_dc/host/my_cluster') }}"
datastore: "{{ lookup('vmware.vmware_rest.datastore_moid', '/my_dc/datastore/local') }}"
folder: "{{ lookup('vmware.vmware_rest.folder_moid', '/my_dc/vm') }}"
resource_pool: "{{ lookup('vmware.vmware_rest.resource_pool_moid', '/my_dc/host/my_cluster/Resources') }}"
name: test_vm1
guest_OS: RHEL_7_64
hardware_version: VMX_11
memory:
hot_add_enabled: true
size_MiB: 1024
disks:
- type: SATA
backing:
type: VMDK_FILE
vmdk_file: '[local] test_vm1/{{ disk_name }}.vmdk'
- type: SATA
new_vmdk:
name: second_disk
capacity: 32000000000
cdroms:
- type: SATA
sata:
bus: 0
unit: 2
nics:
- backing:
type: STANDARD_PORTGROUP
network: "{{ lookup('vmware.vmware_rest.network_moid', '/my_dc/network/VM Network') }}"
register: my_vm
- name: Create a content library based on a DataStore
vmware.vmware_rest.content_locallibrary:
name: my_library_on_datastore
description: automated
publish_info:
published: true
authentication_method: NONE
storage_backings:
- datastore_id: "{{ lookup('vmware.vmware_rest.datastore_moid', '/my_dc/datastore/local') }}"
type: DATASTORE
state: present
register: nfs_lib
- name: Create a VM template on the library
vmware.vmware_rest.vcenter_vmtemplate_libraryitems:
name: golden-template
library: '{{ nfs_lib.id }}'
source_vm: '{{ my_vm.id }}'
placement:
cluster: "{{ lookup('vmware.vmware_rest.cluster_moid', '/my_dc/host/my_cluster') }}"
folder: "{{ lookup('vmware.vmware_rest.folder_moid', '/my_dc/vm') }}"
resource_pool: "{{ lookup('vmware.vmware_rest.resource_pool_moid', '/my_dc/host/my_cluster/Resources') }}"
register: mylib_item
- name: Get the list of items of the NFS library
vmware.vmware_rest.content_library_item_info:
library_id: '{{ nfs_lib.id }}'
register: lib_items
- name: Use the name to identify the item
set_fact:
my_template_item: "{{ lib_items.value | selectattr('name', 'equalto', 'golden-template')|first }}"
- name: Deploy a new VM based on the template
vmware.vmware_rest.vcenter_vmtemplate_libraryitems:
name: vm-from-template
library: '{{ nfs_lib.id }}'
template_library_item: '{{ my_template_item.id }}'
placement:
cluster: "{{ lookup('vmware.vmware_rest.cluster_moid', '/my_dc/host/my_cluster') }}"
folder: "{{ lookup('vmware.vmware_rest.folder_moid', '/my_dc/vm') }}"
resource_pool: "{{ lookup('vmware.vmware_rest.resource_pool_moid', '/my_dc/host/my_cluster/Resources') }}"
state: deploy
register: my_new_vm
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
id строка | moid ресурса Возвращается: При успехе Пример: |
value словарь | Создать шаблон виртуальной машины в библиотеке Возвращается: При успехе Пример: |
Ссылки на коллекцию
© 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/vmware/vmware_rest/vcenter_vmtemplate_libraryitems_module.html
