Spec-Zone.ru › Ansible 2.8

nios_nsgroup – Настройка групп DNS-серверов InfoBlox

Новая в версии 2.8.

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Статус

Описание

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

Требования

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

  • infoblox_client

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
comment
-
Настраивает строку комментария, которая будет связана с экземпляром этого объекта. Указанная строка будет настроена в экземпляре объекта.
extattrs
-
Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
external_primaries
-
Настраивает список внешних именных серверов (не являющихся членами сетки). Этот параметр требуется при установке use_external_primaries в true.
address
- / обязательно
Настраивает IP-адрес внешнего именного сервера.
name
- / обязательно
Устанавливает метку для внешнего именного сервера.
stealth
boolean
    Варианты:
  • нет ←
  • да
Настраивает внешний именной сервер как скрытый сервер (без записи NS) в зонах.
tsig_key
-
Устанавливает ключ DNS TSIG для именного сервера для защиты переноса зон (AFXRs).
tsig_key_alg
-
    Варианты:
  • HMAC-MD5 ←
  • HMAC-SHA256
Определяет алгоритм, используемый для ключа tsig_key.
tsig_key_name
-
Устанавливает метку для значения tsig_key.
external_secondaries
-
Позволяет предоставить список внешних вторичных именных серверов, которые не являются членами сетки.
address
- / обязательно
Настраивает IP-адрес внешнего именного сервера.
name
- / обязательно
Устанавливает метку для внешнего именного сервера.
stealth
boolean
    Варианты:
  • нет ←
  • да
Настраивает внешний именной сервер как скрытый сервер (без записи NS) в зонах.
tsig_key
-
Устанавливает ключ DNS TSIG для именного сервера для защиты переноса зон (AFXRs).
tsig_key_alg
-
    Варианты:
  • HMAC-MD5 ←
  • HMAC-SHA256
Определяет алгоритм, используемый для ключа tsig_key.
tsig_key_name
-
Устанавливает метку для значения tsig_key.
grid_primary
-
Этот хост будет использоваться в качестве первичного сервера в этой группе именных серверов. Он должен быть членом сетки. Этот параметр требуется при установке use_external_primaries в false.
enable_preferred_primaries
boolean
    Варианты:
  • нет ←
  • да
Этот флаг указывает, используются ли значения поля preferred_primaries для этого члена (см. документацию Infoblox WAPI).
grid_replicate
boolean
    Варианты:
  • нет ←
  • да
Использовать перенос зон DNS, если установлено True, или репликацию ID сетки, если установлено False.
lead
boolean
    Варианты:
  • нет ←
  • да
Этот флаг управляет тем, выполняет ли вторичный именной сервер сетки перенос зон на вторичные серверы, не являющиеся лидерами.
name
- / обязательно
Укажите имя члена сетки для идентификации хоста.
stealth
boolean
    Варианты:
  • нет ←
  • да
Настраивает внешний именной сервер как скрытый сервер (без записи NS) в зонах.
grid_secondaries
-
Настраивает список хостов-членов сетки, которые действуют как вторичные именные серверы. Этот параметр требуется при установке use_external_primaries в true.
enable_preferred_primaries
boolean
    Варианты:
  • нет ←
  • да
Этот флаг указывает, используются ли значения поля preferred_primaries для этого члена (см. документацию Infoblox WAPI).
grid_replicate
boolean
    Варианты:
  • нет ←
  • да
Использовать перенос зон DNS, если установлено True, или репликацию ID сетки, если установлено False.
lead
boolean
    Варианты:
  • нет ←
  • да
Этот флаг управляет тем, выполняет ли вторичный именной сервер сетки перенос зон на вторичные серверы, не являющиеся лидерами.
name
- / обязательно
Укажите имя члена сетки для идентификации хоста.
preferred_primaries
-
Предоставьте список элементов, как в external_primaries, чтобы установить приоритет предпочтительных первичных именных серверов.
stealth
boolean
    Варианты:
  • нет ←
  • да
Настраивает внешний именной сервер как скрытый сервер (без записи NS) в зонах.
is_grid_default
boolean
    Варианты:
  • нет ←
  • да
Если установлено True, эта группа именных серверов станет группой именных серверов по умолчанию для новых зон.
name
- / обязательно
Указывает имя группы именных серверов NIOS, подлежащей управлению.
provider
dictionary
Объект типа dict, содержащий сведения о подключении.
host
string / обязательно
Указывает имя DNS-хоста или адрес для подключения к удалённому экземпляру NIOS WAPI через REST.
Значение также может быть задано с помощью переменной среды INFOBLOX_HOST.
http_request_timeout
integer
По умолчанию:
10
Время ожидания получения ответа.
Значение также может быть задано с помощью переменной среды INFOBLOX_HTTP_REQUEST_TIMEOUT.
max_results
целое число
Значение по умолчанию:
1000
Указывает максимальное количество объектов, которые должны быть возвращены. Если значение задано отрицательным, прибор вернёт ошибку, если количество возвращённых объектов превысит заданное значение.
Значение также можно указать с помощью переменной среды INFOBLOX_MAX_RESULTS.
max_retries
целое число
Значение по умолчанию:
3
Настраивает количество попыток повторных подключений перед тем, как соединение будет объявлено пригодным для использования.
Значение также можно указать с помощью переменной среды INFOBLOX_MAX_RETRIES.
password
строка
Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS.
Значение также можно указать с помощью переменной среды INFOBLOX_PASSWORD.
username
строка
Настраивает имя пользователя для аутентификации подключения к удалённому экземпляру NIOS.
Значение также можно указать с помощью переменной среды INFOBLOX_USERNAME.
validate_certs
логическое значение
    Варианты:
  • нет ←
  • да
Логическое значение для включения или отключения проверки сертификатов SSL
Значение также можно указать с помощью переменной среды INFOBLOX_SSL_VERIFY.

Псевдонимы: ssl_verify
wapi_version
строка
Значение по умолчанию:
"2.1"
Указывает версию WAPI для использования
Значение также можно указать с помощью переменной среды INFOBLOX_WAP_VERSION.
До Ansible 2.8 по умолчанию использовалась версия WAPI 1.4
state
-
    Варианты:
  • present ←
  • absent
Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства.
use_external_primary
логическое значение
    Варианты:
  • нет ←
  • да
Этот флаг управляет тем, использует ли группа внешний первичный сервер имен. Обратите внимание, что для изменения этого поля необходимо передать значения для grid_secondaries и external_primaries.

Примечания

Примечание

  • Этот модуль должен выполняться локально, что можно сделать, указав connection: local.
  • Для получения более подробной информации об использовании Infoblox с Ansible, обратитесь к Руководству Infoblox.

Примеры

- name: create simple infoblox nameserver group
  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
  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
  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

Статус

  • Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
  • Этот модуль поддерживается партнёром Ansible. [сертифицировано]

Авторы

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

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/nios_nsgroup_module.html

Spec-Zone.ru

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