Модуль infoblox.nios_modules.nios_zone — настройка DNS-зон Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: infoblox.nios_modules.nios_zone.

Добавлено в infoblox.nios_modules 1.0.0

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Добавляет и/или удаляет экземпляры объектов DNS-зон на серверах Infoblox NIOS. Модуль управляет объектами NIOS zone_auth с помощью интерфейса Infoblox WAPI через REST.

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

infoblox-client

Параметры

Параметр	Описание
comment string	Задаёт текстовый комментарий, связанный с экземпляром этого объекта. Указанная строка будет сохранена в экземпляре объекта.
extattrs dictionary	Позволяет настраивать расширяемые атрибуты экземпляра объекта. Аргумент принимает для настройки набор пар «ключ/значение».
fqdn псевдонимы: name string / обязательный	Задаёт полное доменное имя, которое нужно добавить в экземпляр NIOS или удалить из него в зависимости от заданного значения `state`.
grid_primary list / элементы=dictionary	Настраивает основные серверы Grid для этой зоны.
name string / обязательный	Имя основного сервера Grid
grid_secondaries list / элементы=dictionary	Настраивает вторичные серверы Grid для этой зоны.
name string / обязательный	Имя вторичного сервера Grid
ns_group string	Задаёт группу серверов имён для этой зоны. Группу серверов имён нельзя использовать одновременно с основными и вторичными серверами Grid.
provider dictionary	Словарь с параметрами подключения.
cert string	Задаёт файл сертификата клиента с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удалённым экземпляром NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_CERT`.
host string	Задаёт DNS-имя узла или адрес для подключения к удалённому экземпляру NIOS WAPI через REST. Значение также можно задать с помощью переменной окружения `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте сюда описание. По умолчанию: `10`
http_pool_maxsize integer	Вставьте сюда описание. По умолчанию: `10`
http_request_timeout integer	Время ожидания ответа. Значение также можно задать с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Задаёт файл закрытого ключа для шифрования с помощью сертификата при подключении к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_KEY`.
max_results integer	Задаёт максимальное количество возвращаемых объектов. Если указано отрицательное число, устройство вернёт ошибку, когда количество объектов в ответе превысит заданное значение. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Задаёт количество повторных попыток перед тем, как подключение будет признано пригодным к использованию. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Задаёт пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте сюда описание. Варианты: `false` `true` ← (по умолчанию)
username string	Задаёт имя пользователя для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение, включающее или отключающее проверку SSL-сертификатов. Значение также можно задать с помощью переменной окружения `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Задаёт версию WAPI. Значение также можно задать с помощью переменной окружения `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4. По умолчанию: `"2.12.3"`
restart_if_needed boolean	Если задано значение true, служба DNS NIOS перезапускается и загружает новую конфигурацию зоны. Варианты: `false` `true`
state string	Задаёт требуемое состояние экземпляра объекта на сервере NIOS. Если задано значение `present`, объект настраивается на устройстве; если задано значение `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
view псевдонимы: dns_view string	Задаёт имя DNS-представления для настраиваемого ресурса. Указанная DNS-зона должна уже существовать в работающем экземпляре NIOS до настройки зон. По умолчанию: `"default"`
zone_format string	Создаёт авторитетную зону обратного отображения — область адресного пространства сети, за которую один или несколько серверов имён (основной и вторичные) отвечают на запросы преобразования адреса в имя. Поддерживаются зоны обратного отображения как для адресов IPv4, так и для IPv6. По умолчанию: `"FORWARD"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Модуль необходимо запускать локально. Для этого можно указать connection: local.
Дополнительные сведения об использовании Infoblox с Ansible см. в :ref:`nios_guide`.

Примеры

- name: Configure a zone on the system using grid primary and secondaries
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/infoblox/nios_modules/nios_zone_module.html