vmware_guest_disk – Управление дисками виртуальных машин в заданной инфраструктуре vCenter

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Этот модуль можно использовать для добавления, удаления и обновления дисков, принадлежащих заданной виртуальной машине.
Все параметры и имена объектов VMware чувствительны к регистру.
Этот модуль разрушает данные, пожалуйста, внимательно ознакомьтесь с документацией перед его использованием.
Будьте осторожны при удалении диска, так как это может привести к потере данных.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
datacenter - / обязательно		Имя центров обработки данных, к которому относится виртуальная машина.
disk -	Значение по умолчанию: []	Список дисков для добавления. Информация о виртуальном диске предоставляется в этом списке. Все значения и параметры чувствительны к регистру. Допустимые атрибуты: - `size[_tb,_gb,_mb,_kb]` (целое число): Размер хранилища диска в заданной единице. Если `size` указан, то единица измерения должна быть указана. Пробел между числом размера и единицей не допускается. Будет рассмотрен только первый случай в элементе диска, даже если доступны несколько параметров size*. - `type` (строка): Допустимые значения: - `thin` тонкий диск - `eagerzeroedthick` диск eagerzeroedthick - `thick` толстый диск Значение по умолчанию: `thick` толстый диск, без eagerzero. - `datastore` (строка): Название хранилища данных или кластера хранилищ данных для использования с диском. - `autoselect_datastore` (логическое значение): Выбрать наименее используемое хранилище. Указывать только если `datastore` не указан. - `scsi_controller` (целое число): Номер контроллера SCSI. Допустимый диапазон значений от 0 до 3. Разрешено только 4 контроллера SCSI на одну виртуальную машину. Следует быть внимательным, задавая `scsi_controller` как 0 и `unit_number` как 0, так как этот диск может содержать операционную систему. - `unit_number` (целое число): Номер устройства диска. Допустимый диапазон значений от 0 до 15. Допускается только 15 дисков на один контроллер SCSI. - `scsi_type` (строка): Тип контроллера SCSI. Это значение необходимо только для первого появления контроллера SCSI. Это значение игнорируется, если контроллер SCSI уже присутствует или `state` равно `absent`. Допустимые значения `buslogic`, `lsilogic`, `lsilogicsas` и `paravirtual`. `paravirtual` является значением по умолчанию для этого параметра. - `state` (строка): Состояние диска. Это либо "absent", либо "present". Если `state` установлено в `absent`, диск будет постоянно удален из конфигурации виртуальной машины и из хранилища VMware. Если `state` установлено в `present`, диск будет добавлен, если он отсутствует на данном контроллере SCSI и номере устройства. Если `state` установлено в `present`, и диск существует с другим размером, размер диска увеличивается. Уменьшение размера диска не допускается.
folder -		Папка назначения, абсолютный или относительный путь для поиска существующего гостя. Это обязательный параметр только в случае, если найдено несколько виртуальных машин с одинаковым именем. Папка должна включать центр обработки данных. Центр обработки данных ESX — ha-datacenter Примеры: folder: /ha-datacenter/vm folder: ha-datacenter/vm folder: /datacenter1/vm folder: datacenter1/vm folder: /datacenter1/vm/folder1 folder: datacenter1/vm/folder1 folder: /folder1/datacenter1/vm folder: folder1/datacenter1/vm folder: /folder1/datacenter1/vm/folder2
hostname строка		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использоваться значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
name -		Имя виртуальной машины. Это обязательный параметр, если параметр `uuid` не указан.
password строка		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использоваться значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. Псевдонимы: pass, pwd
port целое число добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использоваться значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
use_instance_uuid логическое значение добавлено в 2.8	Варианты: нет ← да	Использовать UUID экземпляра VMware вместо BIOS UUID.
username строка		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использоваться значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. Псевдонимы: admin, user
uuid -		UUID экземпляра для сбора фактов, если известен, это уникальный идентификатор VMware. Это обязательный параметр, если параметр `name` не указан.
validate_certs логическое значение	Варианты: нет да ←	Разрешает подключение при недействительных сертификатах SSL. Устанавливается в `false` при недоверенных сертификатах. Если значение не указано в задаче, будет использоваться значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

Проверено на vSphere 6.0 и 6.5

Примеры

- name: Add disks to virtual machine using UUID
  vmware_guest_disk:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: no
    uuid: 421e4592-c069-924d-ce20-7e7533fab926
    disk:
      - size_mb: 10
        type: thin
        datastore: datacluster0
        state: present
        scsi_controller: 1
        unit_number: 1
        scsi_type: 'paravirtual'
      - size_gb: 10
        type: eagerzeroedthick
        state: present
        autoselect_datastore: True
        scsi_controller: 2
        scsi_type: 'buslogic'
        unit_number: 12
      - size: 10Gb
        type: eagerzeroedthick
        state: present
        autoselect_datastore: True
        scsi_controller: 2
        scsi_type: 'buslogic'
        unit_number: 1
  delegate_to: localhost
  register: disk_facts

- name: Remove disks from virtual machine using name
  vmware_guest_disk:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: no
    name: VM_225
    disk:
      - state: absent
        scsi_controller: 1
        unit_number: 1
  delegate_to: localhost
  register: disk_facts

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
disk_status словарь	всегда	метаданные о дисках виртуальной машины после их управления Пример: {'0': {'backing_datastore': 'datastore2', 'backing_disk_mode': 'persistent', 'backing_eagerlyscrub': False, 'backing_filename': '[datastore2] VM_225/VM_225.vmdk', 'backing_thinprovisioned': False, 'backing_writethrough': False, 'capacity_in_bytes': 10485760, 'capacity_in_kb': 10240, 'controller_key': 1000, 'key': 2000, 'label': 'Жесткий диск 1', 'summary': '10 240 КБ', 'unit_number': 0}}

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Abhijeet Kasurde (@akasurde) <akasurde@redhat.com>

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vmware_guest_disk_module.html