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

Примечание

Этот модуль является частью коллекции infoblox.nios_modules (версия 1.7.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 строка	Настраивает строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка будет настроена на экземпляре объекта.
extattrs словарь	Позволяет настроить расширенные атрибуты на экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
fqdn псевдонимы: имя строка / обязательно	Указывает полное доменное имя для добавления или удаления из экземпляра NIOS в зависимости от настроенного значения `state`.
grid_primary список / элементы=словарь	Настраивает первичные серверы сетки для этой зоны.
name строка / обязательно	Имя первичного сервера сетки.
grid_secondaries список / элементы=словарь	Настраивает вторичные серверы сетки для этой зоны.
name строка / обязательно	Имя вторичного сервера сетки.
ns_group строка	Настраивает группу серверов имен для этой зоны. Группа серверов имен взаимоисключает первичные и вторичные серверы сетки.
provider словарь	Объект типа dict, содержащий данные подключения.
cert строка	Указывает файл сертификата клиента с хэш-суммой конфигурации x509 для дополнительного уровня защищённого подключения к удалённому экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_CERT`.
host строка	Указывает имя хоста DNS или адрес для подключения к удалённому экземпляру NIOS WAPI по REST. Значение также может быть указано с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections целое число	Вставьте описание здесь. По умолчанию: `10`
http_pool_maxsize целое число	Вставьте описание здесь. По умолчанию: `10`
http_request_timeout целое число	Время ожидания ответа. Значение также может быть указано с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key строка	Указывает файл закрытого ключа для шифрования с сертификатом, чтобы подключиться к удалённому экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_KEY`.
max_results целое число	Указывает максимальное количество возвращаемых объектов. Если значение отрицательное, прибор вернёт ошибку, если количество возвращаемых объектов превысит установленное значение. Значение также может быть указано с помощью переменной среды `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries целое число	Настраивает количество попыток повторной попытки подключения перед объявлением подключения работоспособным. Значение также может быть указано с помощью переменной среды `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password строка	Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_PASSWORD`.
silent_ssl_warnings логический	Вставьте описание здесь. Варианты: `false` `true` ← (по умолчанию)
username строка	Настраивает имя пользователя для аутентификации подключения к удалённому экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_USERNAME`.

validate_certs aliases: 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 aliases: dns_view string	Настраивает имя представления DNS для настроенного ресурса. Указанная зона DNS должна уже существовать на работающем экземпляре NIOS перед настройкой зон. По умолчанию: `"default"`
zone_format string	Создает авторизационную зону обратного отображения, которая представляет собой область сетевого пространства, за которую один или несколько именных серверов — первичный и вторичный — несут ответственность за ответы на запросы адреса-в-имя. Поддерживает зоны обратного отображения как для адресов IPv4, так и IPv6. По умолчанию: `"FORWARD"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль должен выполняться локально, что можно достичь, указав connection: local.
Пожалуйста, обратитесь к :ref:`nios_guide`, чтобы получить более подробную информацию о том, как использовать Infoblox с Ansible.

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infoblox/nios_modules/nios_zone_module.html