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 строка	Варианты: none error warning info ← verbose trivia	Уровень детализации, используемый сервером vCenter для файлов журналов.
mail словарь		Настройки сервера vCenter для отправки оповещений по электронной почте. Допустимые атрибуты: - `server` (строка): Сервер электронной почты - `sender` (строка): Адрес отправителя электронной почты
password строка		Пароль сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. Псевдонимы: pass, pwd
port целое число добавлен в 2.5	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
runtime_settings словарь		Уникальные параметры выполнения для сервера vCenter. Допустимые атрибуты: - `unique_id` (int): Уникальный идентификатор сервера vCenter. - `managed_address` (строка): Управляемый адрес сервера 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_url` (строка): URL первичного получателя. (по умолчанию: "localhost") - `snmp_receiver_1_enabled` (bool): Включить получателя. (по умолчанию: True) - `snmp_receiver_1_port` (int): Порт получателя. (по умолчанию: 162) - `snmp_receiver_1_community` (строка): Строка сообщества. (по умолчанию: "public") - `snmp_receiver_2_url` (строка): URL получателя 2. (по умолчанию: "") - `snmp_receiver_2_enabled` (bool): Включить получателя. (по умолчанию: False) - `snmp_receiver_2_port` (int): Порт получателя. (по умолчанию: 162) - `snmp_receiver_2_community` (строка): Строка сообщества. (по умолчанию: "") ...
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. Допустимые атрибуты: ...
username строка		Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. Псевдонимы: admin, user
validate_certs булево	Варианты: no yes ←	Позволяет подключиться, когда сертификаты SSL недействительны. Установите значение `false`, когда сертификаты не доверяются. ...

Примечания

Примечание

Проверено с 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. [community]

Авторы

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.8/modules/vmware_vcenter_settings_module.html