Spec-Zone.ru › Ansible 2.11

community.vmware.vmware_vcenter_settings – Настройка общих параметров сервера vCenter

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.7.0).

Для его установки используйте: ansible-galaxy collection install community.vmware.

Для использования в playbook, укажите: 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-адрес сервера vSphere vCenter или ESXi.
Если значение не указано в задаче, используется значение переменной окружения VMWARE_HOST.
Поддержка переменных среды добавлена в Ansible 2.6.
logging_options
строка
    Варианты:
  • none
  • error
  • warning
  • info ←
  • verbose
  • trivia
Уровень детализации, используемый сервером vCenter для файлов журналов.
mail
словарь
По умолчанию:
{"sender": "", "server": ""}
Настройки сервера vCenter для отправки электронных уведомлений.
sender
строка
Адрес отправителя электронной почты.
server
строка
Сервер электронной почты.
password
строка
Пароль сервера vSphere vCenter или ESXi.
Если значение не указано в задаче, используется значение переменной окружения VMWARE_PASSWORD.
Поддержка переменных среды добавлена в Ansible 2.6.

псевдонимы: pass, pwd
port
целое число
По умолчанию:
443
Номер порта сервера vSphere 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
целое число
Уникальный идентификатор сервера 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 server для обычных и длительных операций.
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
Период проверки.
Имя пользователя
строка
Имя пользователя сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения 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

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ Возвращаемое значение Описание
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}


Авторы

  • Christian Kotte (@ckotte)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API