vmware_vm_inventory – Источник инвентаризации VMware Guest
Новое в версии 2.7.
Обзор
- Получение виртуальных машин в качестве хостов инвентаризации из среды VMware.
- Использует любой файл, заканчивающийся на vmware.yml или vmware.yaml, как файл конфигурации YAML.
- inventory_hostname всегда является именем и UUID виртуальной машины. UUID добавляется, так как VMware позволяет виртуальным машинам с одинаковыми именами.
Требования
Ниже перечислены требования к локальному мастер-узлу, на котором выполняется эта инвентаризация.
- Python >= 2.7
- PyVmomi
- requests >= 2.3
- vSphere Automation SDK — для функции тегов
- vCloud Suite SDK — для функции тегов
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| cache boolean |
| записи ini: [inventory] переменная среды:ANSIBLE_INVENTORY_CACHE | Включает/выключает кэширование исходных данных инвентаризации. Требует настройки плагина кэша для работы. |
| cache_connection строка | записи ini: [defaults] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN_CONNECTION переменная среды:ANSIBLE_INVENTORY_CACHE_CONNECTION | Данные или путь подключения к кэшу. Для получения подробностей обратитесь к документации по плагину кэша. | |
| cache_plugin строка | Значение по умолчанию: "memory" | записи ini: [defaults] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN переменная среды:ANSIBLE_INVENTORY_CACHE_PLUGIN | Плагин кэша для исходных данных инвентаризации. |
| cache_prefix - | Значение по умолчанию: "ansible_inventory_" | записи ini: [default] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN_PREFIX переменная среды:ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX | Префикс для файлов/таблиц плагина кэша |
| cache_timeout целое число | Значение по умолчанию: 3600 | записи ini: [defaults] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN_TIMEOUT переменная среды:ANSIBLE_INVENTORY_CACHE_TIMEOUT | Срок действия кэша в секундах |
| hostname - / обязательно | переменная среды:VMWARE_SERVER | Имя сервера vCenter или ESXi. | |
| password - / обязательно | переменная среды:VMWARE_PASSWORD | Пароль пользователя администратора vSphere. | |
| port - | Значение по умолчанию: 443 | переменная среды:VMWARE_PORT | Номер порта, используемый для подключения к серверу vCenter или ESXi. |
| properties список добавлено в 2.9 | Значение по умолчанию: ["name", "config.cpuHotAddEnabled", "config.cpuHotRemoveEnabled", "config.instanceUuid", "config.hardware.numCPU", "config.template", "config.name", "guest.hostName", "guest.ipAddress", "guest.guestId", "guest.guestState", "runtime.maxMemoryUsage", "customValue"] | Укажите список свойств схемы VMware, связанных с VM. Эти свойства будут заполнены в hostvars данной VM. Каждое значение в списке указывает путь к определенному свойству в объекте VM. | |
| username - / обязательно | переменная среды:VMWARE_USERNAME | Имя пользователя администратора vSphere. | |
| validate_certs boolean | Значение по умолчанию: "да" | Разрешает подключение, когда сертификаты SSL недействительны. Установите в false , когда сертификаты не доверяются. | |
| with_tags boolean | Значение по умолчанию: "нет" | Включает теги и связанные с ними виртуальные машины. Требуется библиотека 'vSphere Automation SDK', установленная на указанной контроллере. Для получения инструкций по установке см. следующие URL-адреса https://code.vmware.com/web/sdk/65/vsphere-automation-python |
Примеры
# Sample configuration file for VMware Guest dynamic inventory
plugin: vmware_vm_inventory
strict: False
hostname: 10.65.223.31
username: administrator@vsphere.local
password: Esxi@123$%
validate_certs: False
with_tags: True
# Gather minimum set of properties for VMware guest
plugin: vmware_vm_inventory
strict: False
hostname: 10.65.223.31
username: administrator@vsphere.local
password: Esxi@123$%
validate_certs: False
with_tags: False
properties:
- 'name'
- 'guest.ipAddress'
Статус
- Данная инвентаризация не гарантирует обратную совместимость. [превью]
- Эта инвентаризация поддерживается сообществом Ansible. [сообщество]
Авторы
- Abhijeet Kasurde (@Akasurde)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ для его улучшения.
Подсказка
Записи конфигурации для каждого типа имеют порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 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/plugins/inventory/vmware_vm_inventory.html