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