Spec-Zone.ru › Ansible 2.9

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.9/modules/nios_nsgroup_module.html

Spec-Zone.ru

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