Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Для использования в playbook, укажите: infoblox.nios_modules.nios_nsgroup.

Новое в infoblox.nios_modules 1.0.0

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

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

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

Требования

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

  • infoblox_client

Параметры

Параметр

Комментарии

comment

string

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

extattrs

string

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

external_primaries

list / elements=dictionary

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

address

string / required

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

name

string / required

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

stealth

boolean

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

Варианты:

  • false ← (default)
  • true

tsig_key

string

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

tsig_key_alg

string

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

Варианты:

  • "HMAC-MD5" ← (default)
  • "HMAC-SHA256"

tsig_key_name

string / required

Устанавливает метку для значения tsig_key

external_secondaries

list / elements=dictionary

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

address

string / required

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

name

string / required

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

stealth

boolean

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

Варианты:

  • false ← (default)
  • true

tsig_key

string

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

tsig_key_alg

string

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

Варианты:

  • "HMAC-MD5" ← (default)
  • "HMAC-SHA256"

tsig_key_name

string / required

Устанавливает метку для значения tsig_key

grid_primary

list / elements=dictionary

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

enable_preferred_primaries

boolean

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

Варианты:

  • false ← (default)
  • true

grid_replicate

boolean

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

Варианты:

  • false ← (default)
  • true

lead

boolean

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

Choices:

  • false ← (default)
  • true

name

string / required

Укажите имя члена сетки для идентификации хоста.

preferred_primaries

list / elements=dictionary

Предоставьте список элементов, как в external_primaries, чтобы установить приоритет предпочтительных основных серверов имен.

address

string / required

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

name

string / required

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

stealth

boolean

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

Choices:

  • false ← (default)
  • true

tsig_key

string

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

tsig_key_alg

string

Предоставляет алгоритм, используемый для tsig_key.

Choices:

  • "HMAC-MD5" ← (default)
  • "HMAC-SHA256"

tsig_key_name

string / required

Устанавливает метку для значения tsig_key

stealth

boolean

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

Choices:

  • false ← (default)
  • true

grid_secondaries

list / elements=dictionary

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

enable_preferred_primaries

boolean

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

Choices:

  • false ← (default)
  • true

grid_replicate

boolean

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

Choices:

  • false ← (default)
  • true

lead

boolean

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

Choices:

  • false ← (default)
  • true

name

string / required

Укажите имя члена сетки для идентификации хоста.

preferred_primaries

list / elements=dictionary

Предоставьте список элементов, как в external_primaries, чтобы установить приоритет предпочтительных основных серверов имен.

address

string / required

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

name

string / required

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

stealth

boolean

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

Choices:

  • false ← (default)
  • true

tsig_key

string

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

tsig_key_alg

string

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

Варианты:

  • "HMAC-MD5" ← (default)
  • "HMAC-SHA256"

tsig_key_name

string / required

Устанавливает метку для значения tsig_key

stealth

boolean

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

Варианты:

  • false ← (default)
  • true

is_grid_default

boolean

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

Варианты:

  • false ← (default)
  • true

name

string / required

Указывает имя группы серверов имен 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 ← (default)

username

string

Настраивает имя пользователя, которое будет использоваться для аутентификации подключения к удаленному экземпляру NIOS.

Значение также может быть указано с помощью переменной среды INFOBLOX_USERNAME.

validate_certs

aliases: ssl_verify

boolean

Логическое значение для включения или отключения проверки SSL-сертификатов

Значение также может быть указано с помощью переменной среды INFOBLOX_SSL_VERIFY.

Варианты:

  • false ← (default)
  • true

wapi_version

string

Указывает версию WAPI для использования

Значение также может быть указано с помощью переменной среды INFOBLOX_WAPI_VERSION.

До Ansible 2.8 значением WAPI по умолчанию было 1.4

Default: "2.12.3"

state

string

Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства.

Choices:

  • "present" ← (default)
  • "absent"

use_external_primary

boolean

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

Choices:

  • false ← (default)
  • 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infoblox/nios_modules/nios_nsgroup_module.html

Spec-Zone.ru

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