community.vmware.vcenter_license – Управление лицензиями VMware vCenter
Примечание
Этот плагин входит в коллекцию community.vmware (версия 1.7.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в книге задач укажите: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vcenter_license_module.html