Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию community.vmware (версия 4.7.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

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

Для использования в плейбуке укажите: community.vmware.vmware_vcenter_settings.

  • Описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Описание

  • Этот модуль может использоваться для настройки общих параметров сервера vCenter (кроме статистики).
  • Статистику можно настроить с помощью модуля community.vmware.vmware_vcenter_statistics.

Параметры

Параметр

Комментарии

advanced_settings

словарь

Словарь дополнительных параметров.

Значение по умолчанию: {}

database

словарь

Настройки базы данных для сервера vCenter.

Значение по умолчанию: {"event_cleanup": true, "event_retention": 30, "max_connections": 50, "task_cleanup": true, "task_retention": 30}

event_cleanup

логическое

Очистка событий.

Варианты:

  • false
  • true ← (по умолчанию)

event_retention

целое число

Хранение событий в днях.

Значение по умолчанию: 30

max_connections

целое число

Максимальное количество подключений.

Значение по умолчанию: 50

task_cleanup

логическое

Очистка задач.

Варианты:

  • false
  • true ← (по умолчанию)

task_retention

целое число

Хранение задач в днях.

Значение по умолчанию: 30

hostname

строка

Имя хоста или IP-адрес сервера vCenter или ESXi.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_HOST.

logging_options

строка

Уровень детализации, используемый сервером vCenter для файлов журналов.

Варианты:

  • "none"
  • "error"
  • "warning"
  • "info" ← (по умолчанию)
  • "verbose"
  • "trivia"

mail

словарь

Настройки сервера vCenter для отправки электронных оповещений.

Значение по умолчанию: {"sender": "", "server": ""}

sender

строка

Адрес отправителя почты.

server

строка

Почтовый сервер.

password

псевдонимы: pass, pwd

строка

Пароль сервера vSphere vCenter или ESXi.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD.

port

целое число

Номер порта сервера vSphere vCenter или ESXi.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT.

Значение по умолчанию: 443

proxy_host

строка

Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их.

Формат — имя хоста или IP-адрес.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_HOST.

proxy_port

целое число

Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_PORT.

runtime_settings

словарь

Уникальные настройки выполнения сервера vCenter.

managed_address

строка

Управляемый адрес сервера vCenter.

unique_id

целое число

Уникальный идентификатор сервера vCenter.

vcenter_server_name

строка

Имя сервера vCenter. По умолчанию — FQDN.

snmp_receivers

dictionary

Адресаты SNMP-ловушек для оповещений сервера vCenter.

Default: {"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_receiver_1_community

string

Строка сообщества.

Default: "public"

snmp_receiver_1_enabled

boolean

Включить приемник.

Choices:

  • false
  • true ← (default)

snmp_receiver_1_port

integer

Порт приемника.

Default: 162

snmp_receiver_1_url

string

Основной URL-адрес приемника.

Default: "localhost"

snmp_receiver_2_community

string

Строка сообщества.

Default: ""

snmp_receiver_2_enabled

boolean

Включить приемник.

Choices:

  • false ← (default)
  • true

snmp_receiver_2_port

integer

Порт приемника.

Default: 162

snmp_receiver_2_url

string

URL-адрес приемника 2.

Default: ""

snmp_receiver_3_community

string

Строка сообщества.

Default: ""

snmp_receiver_3_enabled

boolean

Включить приемник.

Choices:

  • false ← (default)
  • true

snmp_receiver_3_port

integer

Порт приемника.

Default: 162

snmp_receiver_3_url

string

URL-адрес приемника 3.

Default: ""

snmp_receiver_4_community

string

Строка сообщества.

Default: ""

snmp_receiver_4_enabled

boolean

Включить приемник.

Choices:

  • false ← (default)
  • true

snmp_receiver_4_port

integer

Порт приемника.

Default: 162

snmp_receiver_4_url

string

URL-адрес приемника 4.

Default: ""

timeout_settings

dictionary

Время ожидания подключения к серверу vCenter для обычных и длительных операций.

Default: {"long_operations": 120, "normal_operations": 30}

long_operations

integer

Время ожидания длительной операции.

Default: 120

normal_operations

integer

Время ожидания обычной операции.

Default: 30

user_directory

dictionary

Настройки каталога пользователя для установки сервера vCenter.

По умолчанию: {"query_limit": true, "query_limit_size": 5000, "timeout": 60, "validation": true, "validation_period": 1440}

query_limit

boolean

Предел запроса.

Возможные значения:

  • false
  • true ← (по умолчанию)

query_limit_size

integer

Размер предела запроса.

По умолчанию: 5000

timeout

integer

Тайм-аут каталога пользователя.

По умолчанию: 60

validation

boolean

Проверка почты.

Возможные значения:

  • false
  • true ← (по умолчанию)

validation_period

integer

Период проверки.

По умолчанию: 1440

username

aliases: admin, user

string

Имя пользователя сервера vCenter или ESXi.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER.

validate_certs

boolean

Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты не доверяются.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS.

Возможные значения:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Все модули требуют доступа к API для записи и поэтому не поддерживаются на бесплатной лицензии ESXi.
  • Все имена переменных и объектов VMware чувствительны к регистру.

Примеры

- 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

- name: Enable Retreat Mode for cluster with MOID domain-c8 (https://kb.vmware.com/kb/80472)
  community.vmware.vmware_vcenter_settings:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    advanced_settings:
      'config.vcls.clusters.domain-c8.enabled': 'false'
  delegate_to: localhost

Значения возврата

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

Ключ

Описание

results

dictionary

Метаданные о настройках vCenter

Поддерживает режим diff с версии 1.8.0

Возвращается: всегда

Пример: {"changed": false, "db_event_cleanup": true, "db_event_retention": 30, "db_max_connections": 50, "db_task_cleanup": true, "db_task_retention": 30, "diff": {"after": {"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", "runtime_managed_address": "192.168.1.10", "runtime_server_name": "vcenter01.example.com", "runtime_unique_id": 1, "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": "", "timeout_long_operations": 120, "timeout_normal_operations": 30}, "before": {"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", "runtime_managed_address": "192.168.1.10", "runtime_server_name": "vcenter01.example.com", "runtime_unique_id": 1, "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": "", "timeout_long_operations": 120, "timeout_normal_operations": 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 settings already configured properly", "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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_vcenter_settings_module.html

Spec-Zone.ru

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