community.general.nios_zone – Настройка зон DNS Infoblox NIOS
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в плейбуке, укажите: community.general.nios_zone.
Обзор
- Добавляет и/или удаляет экземпляры объектов зон DNS с серверов Infoblox NIOS. Этот модуль управляет объектами NIOS
zone_authс помощью интерфейса Infoblox WAPI по протоколу REST.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment строка | Настраивает строку комментария, которая будет связана с экземпляром этого объекта. Предоставленная строка текста будет настроена в экземпляре объекта. | ||
| extattrs строка | Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| fqdn строка / обязательно | Указывает полное доменное имя, которое нужно добавить или удалить с экземпляра NIOS в зависимости от значения, заданного параметром state. псевдонимы: имя | ||
| grid_primary список / элементы=словарь | Настраивает первичные серверы сетки для этой зоны. | ||
| name строка / обязательно | Имя первичного сервера сетки. | ||
| grid_secondaries список / элементы=словарь | Настраивает вторичные серверы сетки для этой зоны. | ||
| name строка / обязательно | Имя вторичного сервера сетки. | ||
| ns_group строка | Настраивает группу именных серверов для этой зоны. Группа именных серверов взаимоисключает первичные и вторичные серверы сетки. | ||
| provider словарь | Объект словаря, содержащий данные подключения. | ||
| 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 строка | Значение по умолчанию: "2.1" | Указывает используемую версию WAPI. Значение также можно указать с помощью переменной среды INFOBLOX_WAP_VERSION. До Ansible 2.8 значение по умолчанию было 1.4 | |
| restart_if_needed булево |
| Если установлено в значение «да», вызывает перезапуск службы DNS NIOS и загрузку новой конфигурации зоны. | |
| state строка |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства. | |
| view строка | Значение по умолчанию: "default" | Настраивает имя представления DNS для настроенного ресурса. Указанная зона DNS должна уже существовать на работающем экземпляре NIOS перед настройкой зон. псевдонимы: dns_view | |
| zone_format строка | Значение по умолчанию: "FORWARD" | Создаёт авторизованную обратную зону отображения, которая представляет собой область пространства сети, за которую один или несколько именных серверов — первичный и вторичный — несут ответственность за ответы на запросы преобразования адресов в имена. Поддерживает обратные зоны отображения для адресов IPv4 и IPv6. | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local. - Для получения более подробной информации о том, как использовать Infoblox с Ansible, обратитесь к руководству Infoblox.
Примеры
- name: Configure a zone on the system using grid primary and secondaries
community.general.nios_zone:
name: ansible.com
grid_primary:
- name: gridprimary.grid.com
grid_secondaries:
- name: gridsecondary1.grid.com
- name: gridsecondary2.grid.com
restart_if_needed: true
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Configure a zone on the system using a name server group
community.general.nios_zone:
name: ansible.com
ns_group: examplensg
restart_if_needed: true
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Configure a reverse mapping zone on the system using IPV4 zone format
community.general.nios_zone:
name: 10.10.10.0/24
zone_format: IPV4
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Configure a reverse mapping zone on the system using IPV6 zone format
community.general.nios_zone:
name: 100::1/128
zone_format: IPV6
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Update the comment and ext attributes for an existing zone
community.general.nios_zone:
name: ansible.com
comment: this is an example comment
extattrs:
Site: west-dc
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Remove the dns zone
community.general.nios_zone:
name: ansible.com
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Remove the reverse mapping dns zone from the system with IPV4 zone format
community.general.nios_zone:
name: 10.10.10.0/24
zone_format: IPV4
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Авторы
- Peter Sprygada (@privateip)
© 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_zone_module.html