Spec-Zone.ru › Ansible 2.9

vmware_tools – Выполнение задач внутри ВМ с помощью VMware Tools

Новое в версии 2.8.

  • Описание
  • Требования
  • Параметры
  • Примеры
  • Статус

Описание

  • Используйте VMware Tools для выполнения задач в гостевых операционных системах, работающих в инфраструктуре VMware, или для передачи/получения файлов.
  • В случае с Windows ВМ, установите ansible_shell_type на powershell.
  • Не работает с «become».

Требования

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

  • pyvmomi (библиотека Python)
  • requests (библиотека Python)

Параметры

Параметр Варианты/Значения по умолчанию Настройка Комментарии
exec_command_sleep_interval
float
По умолчанию:
0.5
переменная: ansible_vmware_tools_exec_command_sleep_interval
Время в секундах, ожидаемое между выполнением команды.
executable
-
По умолчанию:
"/bin/sh"
записи в ini:

[defaults]
executable = /bin/sh

переменная среды: ANSIBLE_EXECUTABLE
переменная: ansible_executable
переменная: ansible_vmware_tools_executable
оболочка для использования при выполнении внутри контейнера
file_chunk_size
целое число
По умолчанию:
128
переменная: ansible_vmware_tools_file_chunk_size
Размер блока файла.
(Применимо при записи файла на диск, например, с использованием модуля fetch.)
validate_certs
булево значение
    Варианты:
  • нет
  • да ←
переменная среды: VMWARE_VALIDATE_CERTS
переменная: ansible_vmware_validate_certs
Проверка SSL для подключения.
Примечание: Это проверит сертификаты как для vmware_host, так и для хоста ESXi, на котором работает ВМ.
vm_password
- / требуется
переменная: ansible_password
переменная: ansible_vmware_tools_password
Пароль для пользователя в гостевой операционной системе.
vm_path
- / требуется
переменная: ansible_vmware_guest_path
Абсолютный путь к ВМ для подключения.
Пример vCenter: Datacenter/vm/Discovered virtual machine/testVM.
Пример ESXi хост: ha-datacenter/vm/testVM.
Должен включать имя ВМ, добавленное к 'каталогу', как это передается в vmware_guest.
Нужно включать vm между Центром данных и остальной частью пути к ВМ.
Значение по умолчанию для каталога vm в сервере ESXi - ha-datacenter.
Папка vm не видна в веб-клиенте vSphere, но необходима для работы VMware API.
vm_user
- / требуется
переменная: ansible_user
переменная: ansible_vmware_tools_user
Имя пользователя ВМ.
vmware_host
- / требуется
переменная среды: VI_SERVER
переменная среды: VMWARE_HOST
переменная: ansible_host
переменная: ansible_vmware_host
FQDN или IP-адрес для подключения (vCenter или ESXi хост).
vmware_password
- / требуется
переменная среды: VI_PASSWORD
переменная среды: VMWARE_PASSWORD
переменная: ansible_vmware_password
Пароль для подключения.
vmware_port
-
По умолчанию:
443
переменная среды: VI_PORTNUMBER
переменная среды: VMWARE_PORT
переменная: ansible_port
переменная: ansible_vmware_port
Порт для подключения.
vmware_user
- / требуется
переменная среды: VI_USERNAME
переменная среды: VMWARE_USER
переменная: ansible_vmware_user
Имя пользователя для подключения.
Требуются следующие разрешения на ВМ: - VirtualMachine.GuestOperations.Execute - VirtualMachine.GuestOperations.Modify - VirtualMachine.GuestOperations.Query

Примеры

# example vars.yml
---
ansible_connection: vmware_tools

ansible_vmware_host: vcenter.example.com
ansible_vmware_user: administrator@vsphere.local
ansible_vmware_password: Secr3tP4ssw0rd!12
ansible_vmware_validate_certs: no  # default is yes

# vCenter Connection VM Path Example
ansible_vmware_guest_path: DATACENTER/vm/FOLDER/{{ inventory_hostname }}
# ESXi Connection VM Path Example
ansible_vmware_guest_path: ha-datacenter/vm/{{ inventory_hostname }}

ansible_vmware_tools_user: root
ansible_vmware_tools_password: MyR00tPassw0rD

# if the target VM guest is Windows set the 'ansible_shell_type' to 'powershell'
ansible_shell_type: powershell


# example playbook_linux.yml
---
- name: Test VMware Tools Connection Plugin for Linux
  hosts: linux
  tasks:
    - command: whoami

    - ping:

    - copy:
        src: foo
        dest: /home/user/foo

    - fetch:
        src: /home/user/foo
        dest: linux-foo
        flat: yes

    - file:
        path: /home/user/foo
        state: absent


# example playbook_windows.yml
---
- name: Test VMware Tools Connection Plugin for Windows
  hosts: windows
  tasks:
    - win_command: whoami

    - win_ping:

    - win_copy:
        src: foo
        dest: C:\Users\user\foo

    - fetch:
        src: C:\Users\user\foo
        dest: windows-foo
        flat: yes

    - win_file:
        path: C:\Users\user\foo
        state: absent

Статус

  • Данное подключение не гарантирует обратную совместимость интерфейса. [предварительный просмотр]
  • Это подключение поддерживается сообществом Ansible. [community]

Авторы

  • Deric Crago <deric.crago@gmail.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.9/plugins/connection/vmware_tools.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API