Модуль infoblox.nios_modules.nios_dtc_lbdn — настройка Infoblox NIOS DTC LBDN

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

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

Для установки используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: infoblox.nios_modules.nios_dtc_lbdn.

Добавлено в infoblox.nios_modules 1.1.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Добавляет и/или удаляет экземпляры объектов DTC Load Balanced Domain Name (LBDN) на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS dtc:lbdn с помощью интерфейса Infoblox WAPI через REST.

Требования

На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.

infoblox-client

Параметры

Параметр	Комментарии
auth_zones list / elements=any	Список связанных авторитетных зон. При использовании auth_zones необходимо указать хотя бы один параметр patterns. Каждую зону можно указать в виде строки (FQDN) или словаря с ключами ‘fqdn’ и необязательным ‘view’. Если зона указана в виде строки, будет использована первая найденная зона в любом представлении. Если зоны с одинаковым именем существуют в разных представлениях, используйте формат словаря, чтобы указать нужное представление. Пример: [‘example.com’] или [{‘fqdn’: ‘example.com’, ‘view’: ‘custom’}]
comment string	Задает текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет добавлен к экземпляру объекта.
extattrs dictionary	Позволяет настраивать расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
lb_method string / обязательный	Задает метод балансировки нагрузки. Используется для выбора пула. Варианты: `"GLOBAL_AVAILABILITY"` `"RATIO"` `"ROUND_ROBIN"` `"TOPOLOGY"`
name string / обязательный	Задает отображаемое имя DTC LBDN, не связанное с DNS.
patterns list / elements=string	Укажите подстановочные шаблоны LBDN для сопоставления с шаблоном.
pools list / elements=dictionary	Пулы, используемые для балансировки нагрузки.
pool string / обязательный	Укажите имя связываемого пула.
ratio integer	Укажите вес пула. По умолчанию: `1`
provider dictionary	Словарь с параметрами подключения.
cert string	Задает файл сертификата клиента с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удаленным экземпляром NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_CERT`.
host string	Задает DNS-имя узла или адрес для подключения к удаленному экземпляру NIOS WAPI через REST. Значение также можно задать с помощью переменной окружения `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь. По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь. По умолчанию: `10`
http_request_timeout integer	Время ожидания ответа. Значение также можно задать с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Задает файл закрытого ключа для шифрования с помощью сертификата при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_KEY`.
max_results integer	Задает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство вернет ошибку, когда число возвращаемых объектов превысит это значение. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Задает количество повторных попыток до признания соединения работоспособным. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Задает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь. Варианты: `false` `true` ← (по умолчанию)
username string	Задает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение, включающее или отключающее проверку сертификатов SSL. Значение также можно задать с помощью переменной окружения `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Задает используемую версию WAPI. Значение также можно задать с помощью переменной окружения `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4. По умолчанию: `"2.12.3"`
state string	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если этому параметру присвоено значение `present`, объект настраивается на устройстве; если ему присвоено значение `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
topology string	Задает правила топологии для метода балансировки нагрузки `TOPOLOGY`. Обязателен только в том случае, если для lb_method задано значение `TOPOLOGY`.
ttl integer	Значение Time To Live (TTL) для DTC LBDN. 32-разрядное беззнаковое целое число, указывающее длительность в секундах, в течение которой запись действительна (кэшируется). Нулевое значение означает, что запись не следует кэшировать.
types list / elements=string	Задает список типов ресурсных записей, поддерживаемых LBDN. Этот параметр будет работать правильно, только если для переменной `wapi_version` на `provider` задано числовое значение выше “2.6”. Варианты: `"A"` `"AAAA"` `"CNAME"` `"NAPTR"` `"SRV"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль необходимо запускать локально; для этого можно указать connection: local.
Более подробные сведения об использовании Infoblox с Ansible см. в :ref:`nios_guide`.

Примеры

- name: Configure a DTC LBDN
  infoblox.nios_modules.nios_dtc_lbdn:
    name: web.ansible.com
    lb_method: ROUND_ROBIN
    pools:
      - pool: web_pool
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure a DTC LBDN with zones from different views
  infoblox.nios_modules.nios_dtc_lbdn:
    name: web.ansible.com
    lb_method: ROUND_ROBIN
    auth_zones:
      - example.com                        # First matching zone in any view
      - {"fqdn": "test.com", "view": "default"}  # Explicitly from default view
      - {"fqdn": "demo.com", "view": "custom"}   # From custom view
    patterns:
      - "*.example.com"
      - "*.test.com"
      - "*.demo.com"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to a DTC LBDN
  infoblox.nios_modules.nios_dtc_lbdn:
    name: web.ansible.com
    lb_method: ROUND_ROBIN
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a DTC LBDN from the system
  infoblox.nios_modules.nios_dtc_lbdn:
    name: web.ansible.com
    lb_method: ROUND_ROBIN
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Mauricio Teixeira (@badnetmask)

Ссылки на коллекцию

© 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/infoblox/nios_modules/nios_dtc_lbdn_module.html