community.vmware.vmware_vcenter_settings – Настройка общих параметров сервера vCenter
Примечание
Этот плагин входит в состав коллекции community.vmware (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в книге задач укажите: community.vmware.vmware_vcenter_settings.
Обзор
- Этот модуль можно использовать для настройки общих параметров сервера 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. | |
| event_cleanup логическое |
| Очистка событий. | |
| event_retention целое число | По умолчанию: 30 | Хранение событий в днях. | |
| max_connections целое число | По умолчанию: 50 | Максимальное количество подключений. | |
| task_cleanup логическое |
| Очистка задач. | |
| task_retention целое число | По умолчанию: 30 | Хранение задач в днях. | |
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_HOST. Поддержка переменных среды добавлена в Ansible 2.6. | ||
| logging_options строка |
| Уровень детализации, используемый сервером vCenter для файлов журналов. | |
| mail словарь | По умолчанию: {"sender": "", "server": ""} | Настройки сервера vCenter для отправки электронных уведомлений. | |
| sender строка | Адрес отправителя электронной почты. | ||
| server строка | Сервер электронной почты. | ||
| password строка | Пароль сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD.Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | ||
| port целое число | По умолчанию: 443 | Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT.Поддержка переменных среды добавлена в Ansible 2.6. | |
| proxy_host строка | Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_HOST.Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12 | ||
| proxy_port целое число | Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_PORT. | ||
| runtime_settings словарь | Уникальные временные настройки для сервера vCenter. | ||
| managed_address строка | Управляемый адрес сервера vCenter. | ||
| unique_id целое число | Уникальный ID сервера vCenter. | ||
| vcenter_server_name строка | Имя сервера 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_community строка | По умолчанию: "public" | Строка сообщества. | |
| snmp_receiver_1_enabled логическое |
| Включить приемник. | |
| snmp_receiver_1_port целое число | По умолчанию: 162 | Порт приемника. | |
| snmp_receiver_1_url строка | По умолчанию: "localhost" | Основной URL-адрес приемника. | |
| snmp_receiver_2_community строка | По умолчанию: "" | Строка сообщества. | |
| snmp_receiver_2_enabled логическое |
| Включить приемник. | |
| snmp_receiver_2_port целое число | По умолчанию: 162 | Порт приемника. | |
| snmp_receiver_2_url строка | По умолчанию: "" | URL-адрес приемника 2. | |
| snmp_receiver_3_community строка | По умолчанию: "" | Строка сообщества. | |
| snmp_receiver_3_enabled логическое |
| Включить приемник. | |
| snmp_receiver_3_port целое число | По умолчанию: 162 | Порт приемника. | |
| snmp_receiver_3_url строка | По умолчанию: "" | URL-адрес приемника 3. | |
| snmp_receiver_4_community строка | По умолчанию: "" | Строка сообщества. | |
| snmp_receiver_4_enabled логическое |
| Включить приемник. | |
| snmp_receiver_4_port целое число | По умолчанию: 162 | Порт приемника. | |
| snmp_receiver_4_url строка | По умолчанию: "" | URL-адрес приемника 4. | |
| timeout_settings словарь | По умолчанию: {"long_operations": 120, "normal_operations": 30} | Таймауты подключения к серверу vCenter для обычных и длительных операций. | |
| long_operations целое число | По умолчанию: 120 | Таймаут длительных операций. | |
| normal_operations целое число | По умолчанию: 30 | Таймаут обычных операций. | |
| user_directory словарь | По умолчанию: {"query_limit": true, "query_limit_size": 5000, "timeout": 60, "validation": true, "validation_period": 1440} | Настройки каталога пользователей для установки сервера vCenter. | |
| query_limit логическое |
| Ограничение запросов. | |
| query_limit_size целое число | По умолчанию: 5000 | Размер ограничения запросов. | |
| timeout целое число | По умолчанию: 60 | Таймаут каталога пользователей. | |
| validation логическое |
| Валидация электронной почты. | |
| validation_period целое число | По умолчанию: 1440 | Период валидации. | |
| Имя пользователя строка | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user | ||
| validate_certs булево |
| Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в false, когда сертификаты ненадёжны.Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение true, убедитесь, что на данном компьютере установлен Python >= 2.7.9. | |
Примечания
Примечание
- Тестировано с vCenter Server Appliance (vCSA) 6.5 и 6.7
Примеры
- name: Configure vCenter general settings
community.vmware.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: "{{ lookup('dig', inventory_hostname) }}"
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
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| результаты словарь | всегда | метаданные о настройках vCenter Пример: {'изменилось': False, 'очистка_событий_базы': True, 'хранение_событий_базы': 30, 'макс_соединений_базы': 50, 'очистка_задач_базы': True, 'хранение_задач_базы': 30, 'ограничение_запросов_каталога': True, 'размер_ограничения_запросов_каталога': 5000, 'таймаут_каталога': 60, 'валидация_каталога': True, 'период_валидации_каталога': 1440, 'варианты_ведения_журнала': 'info', 'отправитель_почты': 'vcenter@vcenter01.example.com', 'сервер_почты': 'mail.example.com', 'сообщение': 'Настройки vCenter уже правильно сконфигурированы', 'управляемый_адрес_среды': '192.168.1.10', 'имя_сервера_среды': 'vcenter01.example.com', 'уникальный_идентификатор_среды': 1, 'таймаут_длинных_операций': 120, 'таймаут_обычных_операций': 30} |
Авторы
- 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.10/collections/community/vmware/vmware_vcenter_settings_module.html
