nios_zone – Настройка зон DNS Infoblox NIOS
Новая версия 2.5.
Обзор
- Добавляет и/или удаляет экземпляры объектов зоны DNS с серверов Infoblox NIOS. Этот модуль управляет объектами NIOS
zone_authс использованием интерфейса Infoblox WAPI через REST.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment - | Настраивает строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка текста будет настроена в экземпляре объекта. | ||
| extattrs - | Позволяет настроить расширенные атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| fqdn - / обязательно | Указывает полное доменное имя, которое нужно добавить или удалить из экземпляра NIOS в зависимости от настроенного значения state.псевдонимы: name | ||
| grid_primary - | Настраивает первичные серверы сетки для этой зоны. | ||
| name - | Имя первичного сервера сетки | ||
| grid_secondaries - | Настраивает вторичные серверы сетки для этой зоны. | ||
| name - | Имя вторичного сервера сетки | ||
| ns_group - добавлен в 2.6 | Настраивает группу серверов имен для этой зоны. Группа серверов имен взаимоисключает первичные и вторичные серверы сетки. | ||
| 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. | ||
| ssl_verify boolean |
| Булево значение для включения или отключения проверки сертификатов SSL Значение также можно указать, используя переменную среды INFOBLOX_SSL_VERIFY. | |
| username - | Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать, используя переменную среды INFOBLOX_USERNAME. | ||
| wapi_version - | По умолчанию: 1.4 | Указывает версию WAPI для использования Значение также можно указать, используя переменную среды INFOBLOX_WAP_VERSION. | |
| restart_if_needed boolean добавлен в 2.6 |
| Если установлено в значение true, приводит к перезапуску службы DNS NIOS и загрузке новой конфигурации зоны | |
| state - |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в значение present, объект настраивается на устройстве, а когда это значение установлено в значение absent, значение удаляется (при необходимости) с устройства. | |
| view - / обязательно | По умолчанию: "default" | Настраивает имя представления DNS для настроенного ресурса. Указанная зона DNS должна уже существовать в работающем экземпляре NIOS перед настройкой зон. псевдонимы: dns_view | |
| zone_format - добавлен в 2.7 | По умолчанию: "FORWARD" | Создаёт авторитетную зону обратного отображения, которая представляет собой область сетевого пространства, за которую один или несколько серверов имен — первичный и вторичный — несут ответственность за ответ на запросы адрес-в-имя. Он поддерживает зоны обратного отображения для адресов IPv4 и IPv6. | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local. - Для получения более подробной информации о работе с Infoblox в Ansible, пожалуйста, ознакомьтесь с руководством Infoblox Guide.
Примеры
- name: configure a zone on the system using grid primary and secondaries
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
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
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
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
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
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
nios_zone:
name: 10.10.10.0/24
zone_format: IPV4
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Статус
- Интерфейс этого модуля не гарантируется как обратный совместимый. [превью]
- Этот модуль поддерживается партнером Ansible. [сертифицировано]
Авторы
- 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.7/modules/nios_zone_module.html