Spec-Zone.ru › Ansible

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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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

dictionary

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

По умолчанию: {}

database

dictionary

Параметры базы данных сервера vCenter.

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

event_cleanup

boolean

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

Варианты:

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

event_retention

integer

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

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

max_connections

integer

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

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

task_cleanup

boolean

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

Варианты:

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

task_retention

integer

Срок хранения задач в днях.

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

hostname

string

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

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

logging_options

string

Уровень детализации журналов сервера vCenter.

Варианты:

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

mail

dictionary

Параметры отправки сервером vCenter уведомлений по электронной почте.

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

sender

string

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

server

string

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

password

aliases: pass, pwd

string

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

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

port

integer

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

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

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

proxy_host

string

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

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

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

proxy_port

integer

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

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

runtime_settings

dictionary

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

managed_address

string

Адрес сервера vCenter для управления.

unique_id

integer

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

vcenter_server_name

string

Имя сервера vCenter. По умолчанию используется FQDN.

snmp_receivers

dictionary

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

По умолчанию: {"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

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

По умолчанию: "public"

snmp_receiver_1_enabled

boolean

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

Варианты:

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

snmp_receiver_1_port

integer

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

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

snmp_receiver_1_url

string

URL основного приемника.

По умолчанию: "localhost"

snmp_receiver_2_community

string

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

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

snmp_receiver_2_enabled

boolean

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

Варианты:

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

snmp_receiver_2_port

integer

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

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

snmp_receiver_2_url

string

URL приемника 2.

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

snmp_receiver_3_community

string

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

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

snmp_receiver_3_enabled

boolean

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

Варианты:

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

snmp_receiver_3_port

integer

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

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

snmp_receiver_3_url

string

URL приемника 3.

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

snmp_receiver_4_community

string

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

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

snmp_receiver_4_enabled

boolean

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

Варианты:

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

snmp_receiver_4_port

integer

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

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

snmp_receiver_4_url

string

URL приемника 4.

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

timeout_settings

dictionary

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

По умолчанию: {"long_operations": 120, "normal_operations": 30}

long_operations

integer

Тайм-аут длительных операций.

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

normal_operations

integer

Тайм-аут обычных операций.

По умолчанию: 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

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

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

validate_certs

boolean

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

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

Варианты:

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

Примечания

Примечание

  • Всем модулям необходим доступ на запись к API, поэтому они не поддерживаются бесплатной лицензией ESXi.
  • Все переменные и имена объектов VMware чувствительны к регистру.
  • Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не применяет системное хранилище сертификатов. Указать хранилище сертификатов можно с помощью переменной окружения REQUESTS_CA_BUNDLE. Обратите внимание: наличие этой переменной может в некоторых случаях привести к игнорированию значения ‘false’ параметра ‘validate_certs’. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vmware_vcenter_settings_module.html

Spec-Zone.ru

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