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 - |
| Определяет алгоритм, используемый для ключа tsig_key. | |
| tsig_key_name - | Устанавливает метку для значения tsig_key. | ||
| external_secondaries - | Позволяет предоставить список внешних вторичных именных серверов, которые не являются членами сетки. | ||
| address - / обязательно | Настраивает IP-адрес внешнего именного сервера. | ||
| name - / обязательно | Устанавливает метку для внешнего именного сервера. | ||
| stealth boolean |
| Настраивает внешний именной сервер как скрытый сервер (без записи NS) в зонах. | |
| tsig_key - | Устанавливает ключ DNS TSIG для именного сервера для защиты переноса зон (AFXRs). | ||
| tsig_key_alg - |
| Определяет алгоритм, используемый для ключа 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 - |
| Настраивает желаемое состояние экземпляра объекта на сервере 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