Модуль community.vmware.vcenter_extension — регистрация/отмена регистрации расширений vCenter

Примечание

Этот модуль входит в коллекцию community.vmware (версия 6.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать коллекцию в плейбуке, укажите: community.vmware.vcenter_extension.

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль можно использовать для регистрации и отмены регистрации расширений vCenter.

Параметры

Параметр	Комментарии
client_type string	Обязательный параметр для `state=present`. Тип клиента, которым является расширение (win32, .net, linux и т. д.). По умолчанию: `"vsphere-client-serenity"`
company string	Обязательный параметр для `state=present`. Название компании, создавшей расширение.
description string	Обязательный параметр для `state=present`. Краткое описание расширения.
email string	Обязательный параметр для `state=present`. Адрес электронной почты администратора, используемый для расширения.
extension_key string / обязательный	Ключ расширения, которое нужно установить или удалить.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
name string	Обязательный параметр для `state=present`. Название устанавливаемого расширения.
password псевдонимы: pass, pwd string	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host string	Адрес прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. Укажите имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
server_type string	Обязательный параметр для `state=present`. Тип сервера, используемого для установки расширения (SOAP, REST, HTTP и т. д.). По умолчанию: `"vsphere-client-serenity"`
ssl_thumbprint string	Обязательный параметр для `state=present`. Отпечаток SSL-сертификата сервера, на котором размещено расширение.
state string	Добавить или удалить расширение vCenter. Варианты: `"absent"` `"present"` ← (по умолчанию)
url string	Обязательный параметр для `state=present`. Ссылка на сервер, на котором размещён ZIP-файл расширения для установки.
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
validate_certs boolean	Разрешает подключение, если SSL-сертификаты недействительны. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
version string / обязательный	Версия устанавливаемого или удаляемого расширения.
visible boolean	Отображать расширение в диспетчере решений vCenter. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Для всех модулей требуется доступ на запись через API, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
Имена всех переменных и объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не обращается к системному хранилищу сертификатов. Вы можете указать хранилище сертификатов, задав переменную среды REQUESTS_CA_BUNDLE. Обратите внимание: при установленной переменной в некоторых случаях значение ‘false’ параметра ‘validate_certs’ может игнорироваться. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- name: Register vCenter Extension
  community.vmware.vcenter_extension:
     hostname: "{{ groups['vcsa'][0] }}"
     username: "{{ vcenter_username }}"
     password: "{{ site_password }}"
     extension_key: "{{ extension_key }}"
     version: "1.0"
     company: "Acme"
     name: "Acme Extension"
     description: "acme management"
     email: "user@example.com"
     url: "https://10.0.0.1/ACME-vSphere-web-plugin-1.0.zip"
     ssl_thumbprint: "{{ ssl_thumbprint }}"
     state: present
  delegate_to: localhost
  register: register_extension

- name: Deregister vCenter Extension
  community.vmware.vcenter_extension:
     hostname: "{{ groups['vcsa'][0] }}"
     username: "{{ vcenter_username }}"
     password: "{{ site_password }}"
     extension_key: "{{ extension_key }}"
     version: "1.0"
     state: absent
  delegate_to: localhost
  register: deregister_extension

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

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

Ключ	Описание
result string	сведения о выполненной операции Возвращается: всегда Пример: `"'com.acme.Extension' installed."`

Авторы

Michael Tipton (@castawayegr)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vcenter_extension_module.html