community.general.nios_nsgroup – Настройка групп серверов DNS InfoBlox
Примечание
Этот плагин является частью коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в playbook, укажите: community.general.nios_nsgroup.
Обзор
- Добавляет и/или удаляет группы серверов имен из серверов NIOS Infoblox. Этот модуль управляет объектами NIOS
nsgroupс использованием интерфейса Infoblox. WAPI по протоколу REST.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- infoblox_client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment строка | Настраивает текстовую строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка будет настроена на экземпляре объекта. | ||
| extattrs строка | Позволяет настроить расширяемые атрибуты на экземпляре объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки. | ||
| external_primaries список / элементы=словарь | Настраивает список внешних серверов имен (не являющихся членами сетки). Этот параметр обязателен при установке use_external_primaries в true. | ||
| address строка / обязательно | Настраивает IP-адрес внешнего сервера имен. | ||
| name строка / обязательно | Устанавливает метку для внешнего сервера имен. | ||
| stealth булево |
| Настраивает внешний сервер имен как сервер «скрытый» (без записи NS) в зонах. | |
| tsig_key строка | Устанавливает ключ DNS TSIG для сервера имен для обеспечения безопасности переноса зон (AFXRs). | ||
| tsig_key_alg строка |
| Указывает алгоритм, используемый для ключа tsig_key. | |
| tsig_key_name строка | Устанавливает метку для значения tsig_key. | ||
| external_secondaries список / элементы=словарь | Позволяет предоставить список внешних вторичных серверов имен, которые не являются членами сетки. | ||
| address строка / обязательно | Настраивает IP-адрес внешнего сервера имен. | ||
| name строка / обязательно | Устанавливает метку для внешнего сервера имен. | ||
| stealth булево |
| Настраивает внешний сервер имен как сервер «скрытый» (без записи 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 булево |
| Этот флаг указывает, используются ли значения поля preferred_primaries для этого члена (см. документацию Infoblox WAPI). | |
| grid_replicate булево |
| Использовать перенос зон DNS, если установлено в True, или репликацию сетки ID, если установлено в False. | |
| lead булево |
| Этот флаг управляет тем, выполняет ли вторичный сервер имен сетки перенос зон на вторичные серверы, которые не являются лидерами. | |
| name строка / обязательно | Укажите имя члена сетки для идентификации хоста. | ||
| preferred_primaries список / элементы=словарь | Укажите список элементов, как в external_primaries, для установки приоритета предпочтительных первичных серверов имен. | ||
| stealth булево |
| Настраивает внешний сервер имен как сервер «скрытый» (без записи NS) в зонах. | |
| grid_secondaries список / элементы=словарь | Настраивает список хостов-членов сетки, которые действуют как вторичные серверы имен. Этот параметр обязателен при установке use_external_primaries в true. | ||
| enable_preferred_primaries булево |
| Этот флаг указывает, используются ли значения поля preferred_primaries для этого члена (см. документацию Infoblox WAPI). | |
| grid_replicate булево |
| Использовать перенос зон DNS, если установлено в True, или репликацию сетки ID, если установлено в False.
| |
| lead булево |
| Этот флаг управляет тем, выполняет ли вторичный сервер имен сетки перенос зон на вторичные серверы, которые не являются лидерами. | |
| name строка / обязательно | Укажите имя члена сетки для идентификации хоста. | ||
| preferred_primaries список / элементы=словарь | Укажите список элементов, как в external_primaries, для установки приоритета предпочтительных первичных серверов имен. | ||
| stealth булево |
| Настраивает внешний сервер имен как сервер «скрытый» (без записи NS) в зонах. | |
| is_grid_default булево |
| Если установлено в True, эта группа серверов имен станет группой по умолчанию для новых зон. | |
| name строка / обязательно | Указывает имя группы серверов имен NIOS, которую необходимо управлять. | ||
| provider словарь | Объект типа dict, содержащий данные подключения. | ||
| host строка | Указывает имя хоста DNS или адрес для подключения к удаленному экземпляру NIOS WAPI через REST. Значение также можно указать с помощью переменной среды INFOBLOX_HOST. | ||
| http_request_timeout целое число | По умолчанию: 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 string | Значение по умолчанию: "2.1" | Указывает используемую версию WAPI Значение также можно указать с помощью переменной среды INFOBLOX_WAP_VERSION. До Ansible 2.8 значением по умолчанию для WAPI была версия 1.4 | |
| state string |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. При значении present, объект настраивается на устройстве, а при значении absent, значение удаляется (при необходимости) с устройства. | |
| use_external_primary boolean |
| Этот флаг управляет использованием внешнего первичного сервера имен группой. Обратите внимание, что для изменения этого поля необходимо передать значения для grid_secondaries и external_primaries. | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local. - Для получения более подробной информации о том, как использовать Infoblox с Ansible, ознакомьтесь с Руководством Infoblox.
Примеры
- name: Create simple infoblox nameserver group
community.general.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
community.general.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
community.general.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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/nios_nsgroup_module.html