Spec-Zone.ru › Ansible

Модуль infoblox.nios_modules.nios_nsgroup — настройка авторитетных групп DNS-серверов имен Infoblox

Примечание

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

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

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

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

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

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

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

  • Добавляет и/или удаляет группы серверов имен типа «авторитетный» на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS nsgroup с помощью интерфейса Infoblox WAPI через REST.

Требования

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

  • infoblox_client

Параметры

Параметр

Комментарии

comment

string

Задаёт текстовый комментарий, связанный с экземпляром этого объекта. Указанная текстовая строка будет настроена для экземпляра объекта.

extattrs

string

Позволяет настраивать расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.

external_primaries

list / elements=dictionary

Настраивает список внешних серверов имён (не входящих в Grid). Этот параметр обязателен, если для use_external_primaries задано значение true.

address

string / обязательный

Настраивает IP-адрес внешнего сервера имён

name

string / обязательный

Задаёт метку для внешнего сервера имён

stealth

boolean

Настраивает внешний сервер имён как скрытый сервер (без записи NS) в зонах.

Варианты:

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

tsig_key

string

Задаёт ключ DNS TSIG для защиты передачи зон (AFXRs) на сервер имён.

tsig_key_alg

string

Указывает используемый алгоритм для ключа tsig_key.

Варианты:

  • "HMAC-MD5" ← (по умолчанию)
  • "HMAC-SHA256"

tsig_key_name

string / обязательный

Задаёт метку для значения tsig_key

external_secondaries

list / elements=dictionary

Позволяет указать список внешних вторичных серверов имён, не входящих в Grid.

address

string / обязательный

Настраивает IP-адрес внешнего сервера имён

name

string / обязательный

Задаёт метку для внешнего сервера имён

stealth

boolean

Настраивает внешний сервер имён как скрытый сервер (без записи NS) в зонах.

Варианты:

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

tsig_key

string

Задаёт ключ DNS TSIG для защиты передачи зон (AFXRs) на сервер имён.

tsig_key_alg

string

Указывает используемый алгоритм для ключа tsig_key.

Варианты:

  • "HMAC-MD5" ← (по умолчанию)
  • "HMAC-SHA256"

tsig_key_name

string / обязательный

Задаёт метку для значения tsig_key

grid_primary

list / elements=dictionary

Этот узел будет использоваться в качестве основного сервера в этой группе серверов имён. Он должен быть участником Grid. Этот параметр обязателен, если для use_external_primaries задано значение false.

enable_preferred_primaries

boolean

Этот флаг указывает, используются ли значения поля preferred_primaries для этого участника (см. документацию Infoblox WAPI).

Варианты:

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

grid_replicate

boolean

Использовать передачу зон DNS, если задано значение True, или репликацию ID Grid, если задано значение False.

Варианты:

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

lead

boolean

Этот флаг определяет, выполняет ли ведущий вторичный сервер имён Grid передачу зон вторичным серверам, не являющимся ведущими.

Варианты:

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

name

string / обязательный

Укажите имя участника Grid для идентификации узла.

preferred_primaries

list / elements=dictionary

Укажите список элементов, аналогичный external_primaries, чтобы задать приоритет предпочитаемых основных серверов имён.

address

string / обязательный

Настраивает IP-адрес внешнего сервера имён

name

string / обязательный

Задаёт метку для внешнего сервера имён

stealth

boolean

Настраивает внешний сервер имён как скрытый сервер (без записи NS) в зонах.

Варианты:

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

tsig_key

string

Задаёт ключ DNS TSIG для защиты передачи зон (AFXRs) на сервер имён.

tsig_key_alg

string

Указывает используемый алгоритм для ключа tsig_key.

Варианты:

  • "HMAC-MD5" ← (по умолчанию)
  • "HMAC-SHA256"

tsig_key_name

string / обязательный

Задаёт метку для значения tsig_key

stealth

boolean

Настраивает внешний сервер имён как скрытый сервер (без записи NS) в зонах.

Варианты:

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

grid_secondaries

list / elements=dictionary

Настраивает список узлов — участников Grid, выполняющих роль вторичных серверов имён. Этот параметр обязателен, если для use_external_primaries задано значение true.

enable_preferred_primaries

boolean

Этот флаг указывает, используются ли значения поля preferred_primaries для этого участника (см. документацию Infoblox WAPI).

Варианты:

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

grid_replicate

boolean

Использовать передачу зон DNS, если задано значение True, или репликацию ID Grid, если задано значение False

Варианты:

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

lead

boolean

Этот флаг определяет, выполняет ли ведущий вторичный сервер имён Grid передачу зон вторичным серверам, не являющимся ведущими.

Варианты:

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

name

string / обязательный

Укажите имя участника Grid для идентификации узла.

preferred_primaries

list / elements=dictionary

Укажите список элементов, аналогичный external_primaries, чтобы задать приоритет предпочитаемых основных серверов имён.

address

string / обязательный

Настраивает IP-адрес внешнего сервера имён

name

string / обязательный

Задаёт метку для внешнего сервера имён

stealth

boolean

Настраивает внешний сервер имён как скрытый сервер (без записи NS) в зонах.

Варианты:

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

tsig_key

string

Задаёт ключ DNS TSIG для защиты передачи зон (AFXRs) на сервер имён.

tsig_key_alg

string

Указывает используемый алгоритм для ключа tsig_key.

Варианты:

  • "HMAC-MD5" ← (по умолчанию)
  • "HMAC-SHA256"

tsig_key_name

string / обязательный

Задаёт метку для значения tsig_key

stealth

boolean

Настраивает внешний сервер имён как скрытый сервер (без записи NS) в зонах.

Варианты:

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

is_grid_default

boolean

Если задано значение True, эта группа серверов имён станет группой по умолчанию для новых зон.

Варианты:

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

name

string / обязательный

Указывает имя группы серверов имён NIOS, которой необходимо управлять.

provider

dictionary

Объект dict со сведениями о подключении.

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"

use_external_primary

boolean

Этот флаг определяет, использует ли группа внешний первичный сервер имён. Обратите внимание: для изменения этого поля необходимо передать значения для grid_secondaries и external_primaries.

Варианты:

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

Примечания

Примечание

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

Примеры

- name: Create simple infoblox nameserver group
  infoblox.nios_modules.nios_nsgroup:
    name: my-simple-group
    comment: "this is a simple nameserver group"
    grid_primary:
      - name: infoblox-test.example.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create infoblox nameserver group with external primaries
  infoblox.nios_modules.nios_nsgroup:
    name: my-example-group
    use_external_primary: true
    comment: "this is my example nameserver group"
    external_primaries: "{{ ext_nameservers }}"
    grid_secondaries:
      - name: infoblox-test.example.com
        lead: true
        preferred_primaries: "{{ ext_nameservers }}"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Delete infoblox nameserver group
  infoblox.nios_modules.nios_nsgroup:
    name: my-simple-group
    comment: "this is a simple nameserver group"
    grid_primary:
      - name: infoblox-test.example.com
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

  • Erich Birngruber (@ebirn)
  • Sumit Jaiswal (@sjaiswal)

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

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 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_nsgroup_module.html

Spec-Zone.ru

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