community.vmware.vcenter_license – Управление ключами лицензий VMware vCenter
Примечание
Этот плагин входит в состав коллекции community.vmware (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в playbook укажите: community.vmware.vcenter_license.
Обзор
- Добавление и удаление ключей лицензий серверов vCenter и ESXi.
Требования
Ниже перечислены требования, необходимые на хосте, на котором будет выполняться этот модуль.
- pyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name строка | Имя кластера, к которому нужно применить лицензию vSAN. | |
| datacenter строка | Имя центра обработки данных для операции. | |
| esxi_hostname строка | Имя хоста ESXi, которому будет назначена указанная лицензия. Этот параметр необязателен. | |
| hostname строка | Имя хоста или IP-адрес сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. Переменная окружения поддерживается начиная с Ansible 2.6. | |
| labels словарь | Значение по умолчанию: {"source": "ansible"} | Необязательные метки ключа лицензии для управления в vSphere vCenter. Это словарь с парами ключ/значение. |
| license строка / обязательно | Ключ лицензии для управления в vSphere vCenter. | |
| password строка | Пароль сервера vSphere vCenter. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Переменная окружения поддерживается начиная с Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлен в 2.5 версии ansible.builtin | Значение по умолчанию: 443 | Номер порта сервера vSphere vCenter. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT. Переменная окружения поддерживается начиная с Ansible 2.6. |
| proxy_host строка добавлен в 2.9 версии ansible.builtin | Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_HOST. | |
| proxy_port целое число добавлен в 2.9 версии ansible.builtin | Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_PORT. | |
| state строка |
| Необходимо добавить ( present) или удалить (absent) ключ лицензии. |
| username строка | Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER. Переменная окружения поддерживается начиная с Ansible 2.6. псевдонимы: admin, user | |
| validate_certs логическое |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты не доверяются.Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS. Переменная окружения поддерживается начиная с Ansible 2.6. Если установлено значение true, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Этот модуль также автоматически назначит текущий vCenter ключу лицензии, если продукт соответствует ключу лицензии, и vCenter в настоящее время назначена только лицензия оценки.
- Лицензия оценки (00000-00000-00000-00000-00000) не отображается, если не используется.
- Если указано
esxi_hostname, то ключуlicenseбудет назначен хост ESXi. - Если
esxi_hostnameне указано, то ключlicenseпросто зарегистрируется в инвентаре vCenter без назначения хосту ESXi.
Примеры
- name: Add a new vCenter license
community.vmware.vcenter_license:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
license: f600d-21ae3-5592b-249e0-cc341
state: present
delegate_to: localhost
- name: Remove an (unused) vCenter license
community.vmware.vcenter_license:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
license: f600d-21ae3-5592b-249e0-cc341
state: absent
delegate_to: localhost
- name: Add ESXi license and assign to the ESXi host
community.vmware.vcenter_license:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
license: f600d-21ae3-5592b-249e0-dd502
state: present
delegate_to: localhost
- name: Add vSAN license and assign to the given cluster
community.vmware.vcenter_license:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter: '{{ datacenter_name }}'
cluster_name: '{{ cluster_name }}'
license: f600d-21ae3-5592b-249e0-dd502
state: present
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| licenses список / элементы=строка | всегда | список ключей лицензий после выполнения модуля Пример: ['f600d-21ae3-5592b-249e0-cc341', '143cc-0e942-b2955-3ea12-d006f'] |
Авторы
- Dag Wieers (@dagwieers)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vcenter_license_module.html