vmware_vcenter_settings – Настройка общих параметров сервера vCenter
Новая в версии 2.8.
Обзор
- Этот модуль можно использовать для настройки общих параметров сервера vCenter (кроме статистики).
- Статистику можно настроить с помощью модуля
vmware_vcenter_statistics.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| database словарь | Значение по умолчанию: {"event_cleanup": true, "event_retention": 30, "max_connections": 50, "task_cleanup": true, "task_retention": 30} | Настройки базы данных для сервера vCenter. Допустимые атрибуты: - max_connections (int): Максимальное количество подключений. (по умолчанию: 50)- task_cleanup (bool): Очистка задач. (по умолчанию: true)- task_retention (int): Хранение задач (дни). (по умолчанию: 30)- event_cleanup (bool): Очистка событий. (по умолчанию: true)- event_retention (int): Хранение событий (дни). (по умолчанию: 30) |
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_HOST. Поддержка переменных среды добавлена в Ansible 2.6. | |
| logging_options строка |
| Уровень детализации, используемый сервером vCenter для файлов журналов. |
| mail словарь | Настройки, используемые сервером vCenter для отправки оповещений по электронной почте. Допустимые атрибуты: - server (str): Сервер электронной почты- sender (str): Адрес отправителя электронной почты | |
| password строка | Пароль сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлен в 2.5 | Значение по умолчанию: 443 | Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в Ansible 2.6. |
| proxy_host строка добавлен в 2.9 | Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_HOST. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12 | |
| proxy_port целое число добавлен в 2.9 | Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_PORT. | |
| runtime_settings словарь | Уникальные настройки времени выполнения для сервера vCenter. Допустимые атрибуты: - unique_id (int): Уникальный идентификатор сервера vCenter.- managed_address (str): Управляемый адрес сервера vCenter.- vcenter_server_name (str): Имя сервера vCenter. (по умолчанию: FQDN) | |
| snmp_receivers словарь | Значение по умолчанию: {"snmp_receiver_1_community": "public", "snmp_receiver_1_enabled": true, "snmp_receiver_1_port": 162, "snmp_receiver_1_url": "localhost", "snmp_receiver_2_community": "", "snmp_receiver_2_enabled": false, "snmp_receiver_2_port": 162, "snmp_receiver_2_url": "", "snmp_receiver_3_community": "", "snmp_receiver_3_enabled": false, "snmp_receiver_3_port": 162, "snmp_receiver_3_url": "", "snmp_receiver_4_community": "", "snmp_receiver_4_enabled": false, "snmp_receiver_4_port": 162, "snmp_receiver_4_url": ""} | Назначения SNMP-ловушек для оповещений сервера vCenter. Допустимые атрибуты: - snmp_receiver_1_url (str): Основной URL получателя. (по умолчанию: "localhost")- snmp_receiver_1_enabled (bool): Включить получателя. (по умолчанию: True)- snmp_receiver_1_port (int): Порт получателя. (по умолчанию: 162)- snmp_receiver_1_community (str): Строка сообщества. (по умолчанию: "public")- snmp_receiver_2_url (str): URL получателя 2. (по умолчанию: "")- snmp_receiver_2_enabled (bool): Включить получателя. (по умолчанию: False)- snmp_receiver_2_port (int): Порт получателя. (по умолчанию: 162)- snmp_receiver_2_community (str): Строка сообщества. (по умолчанию: "") |
| timeout_settings словарь | Значение по умолчанию: {"long_operations": 120, "normal_operations": 30} | Тайм-аут подключения к серверу vCenter для обычных и длительных операций. Допустимые атрибуты: - normal_operations (int) (по умолчанию: 30)- long_operations (int) (по умолчанию: 120) |
| user_directory словарь | Значение по умолчанию: {"query_limit": true, "query_limit_size": 5000, "timeout": 60, "validation": true, "validation_period": 1440} | Настройки каталога пользователей для установки сервера vCenter. Допустимые атрибуты: - timeout (int): Тайм-аут каталога пользователей. (по умолчанию: 60)- query_limit (bool): Ограничение запросов. (по умолчанию: true)- query_limit_size (int): Размер ограничения запросов. (по умолчанию: 5000)- validation (bool): Проверка почты. (по умолчанию: true)- validation_period (int): Период проверки. (по умолчанию: 1440) |
| username строка | Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user | |
| validate_certs булево |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в значение false, когда сертификаты не доверяются.Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Проверено с vCenter Server Appliance (vCSA) 6.5 и 6.7
Примеры
- name: Configure vCenter general settings
vmware_vcenter_settings:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
database:
max_connections: 50
task_cleanup: true
task_retention: 30
event_cleanup: true
event_retention: 30
runtime_settings:
unique_id: 1
managed_address: "{{ ansible_default_ipv4.address }}"
vcenter_server_name: "{{ inventory_hostname }}"
user_directory:
timeout: 60
query_limit: true
query_limit_size: 5000
validation: true
validation_period: 1440
mail:
server: mail.example.com
sender: vcenter@{{ inventory_hostname }}
snmp_receivers:
snmp_receiver_1_url: localhost
snmp_receiver_1_enabled: true
snmp_receiver_1_port: 162
snmp_receiver_1_community: public
timeout_settings:
normal_operations: 30
long_operations: 120
logging_options: info
validate_certs: no
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| results словарь | всегда | метаданные о настройках vCenter Пример: {'changed': False, 'db_event_cleanup': True, 'db_event_retention': 30, 'db_max_connections': 50, 'db_task_cleanup': True, 'db_task_retention': 30, 'directory_query_limit': True, 'directory_query_limit_size': 5000, 'directory_timeout': 60, 'directory_validation': True, 'directory_validation_period': 1440, 'logging_options': 'info', 'mail_sender': 'vcenter@vcenter01.example.com', 'mail_server': 'mail.example.com', 'msg': 'Настройки vCenter уже правильно настроены', 'runtime_managed_address': '192.168.1.10', 'runtime_server_name': 'vcenter01.example.com', 'runtime_unique_id': 1, 'timeout_long_operations': 120, 'timeout_normal_operations': 30} |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Данный модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Christian Kotte (@ckotte)
Подсказка
Если вы обнаружите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/modules/vmware_vcenter_settings_module.html
