Spec-Zone.ru › Ansible 2.9

nios_zone – Настройка зон Infoblox NIOS DNS

Новое в версии 2.5.

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

Обзор

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

Требования

Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.

  • infoblox-client

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
comment
-
Настраивает текстовую строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная текстовая строка будет настроена для экземпляра объекта.
extattrs
-
Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
fqdn
- / обязательно
Указывает полное доменное имя для добавления или удаления из экземпляра NIOS в зависимости от настроенного значения state.

псевдонимы: имя
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.
username
строка
Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS.
Значение также может быть задано с помощью переменной среды INFOBLOX_USERNAME.
validate_certs
булево
    Варианты:
  • нет ←
  • да
Булево значение для включения или отключения проверки сертификатов SSL
Значение также может быть задано с помощью переменной среды INFOBLOX_SSL_VERIFY.

псевдонимы: ssl_verify
wapi_version
строка
По умолчанию:
"2.1"
Указывает используемую версию WAPI
Значение также может быть задано с помощью переменной среды INFOBLOX_WAP_VERSION.
До версии ansible 2.8 значение по умолчанию для WAPI было 1.4.
restart_if_needed
булево
добавлено в 2.6
    Варианты:
  • нет
  • да
Если установлено в значение true, вызывает перезапуск сервиса DNS NIOS и загрузку новой конфигурации зоны
state
-
    Варианты:
  • present ←
  • absent
Настраивает желаемое состояние экземпляра объекта на сервере 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.9/modules/nios_zone_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API