Spec-Zone.ru › Ansible 2.11

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

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: 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_pool_connections
целое число
По умолчанию:
10
Количество пулов, которые будут использоваться объектом infoblox_client.Connector.
Это передается как есть в базовый класс requests.adapters.HTTPAdapter.
http_pool_maxsize
целое число
По умолчанию:
10
Максимальное количество подключений на пул, которые будут использоваться объектом infoblox_client.Connector.
Это передается как есть в базовый класс requests.adapters.HTTPAdapter.
http_request_timeout
целое число
По умолчанию:
10
Время ожидания ответа перед получением ответа.
Значение также можно указать с помощью переменной среды INFOBLOX_HTTP_REQUEST_TIMEOUT.
max_results
целое число
По умолчанию:
1000
Указывает максимальное количество возвращаемых объектов. Если значение установлено в отрицательное число, прибор вернёт ошибку, если количество возвращаемых объектов превысит установленное значение.
Значение также можно указать с помощью переменной среды INFOBLOX_MAX_RESULTS.
max_retries
целое число
По умолчанию:
3
Настраивает количество попыток повтора перед тем, как подключение будет объявлено работоспособным.
Значение также можно указать с помощью переменной среды INFOBLOX_MAX_RETRIES.
password
строка
Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS.
Значение также можно указать с помощью переменной среды INFOBLOX_PASSWORD.
silent_ssl_warnings
логическое значение
    Варианты:
  • нет
  • да ←
Отключить предупреждения SSL urllib3 в объекте infoblox_client.Connector.
Это передается как есть в базовый класс requests.adapters.HTTPAdapter.
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
логическое значение
    Варианты:
  • нет
  • да
Если установлено в значение true, приводит к перезапуску службы DNS NIOS и загрузке новой конфигурации зоны.
state
строка
    Варианты:
  • present ←
  • absent
Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в значение present, объект настраивается на устройстве, а когда это значение установлено в значение absent, значение удаляется (при необходимости) с устройства.
view
строка
По умолчанию:
"default"
Настраивает имя представления DNS для настроенного ресурса. Указанная зона DNS должна уже существовать на работающем экземпляре NIOS до настройки зон.

псевдонимы: dns_view
zone_format
строка
По умолчанию:
"FORWARD"
Создаёт авторитетную зону обратного отображения, которая представляет собой область сетевого пространства, за которую один или несколько серверов имен — первичный и вторичный — несут ответственность за ответы на запросы адреса-в-имя. Поддерживает зоны обратного отображения для адресов IPv4 и IPv6.

Примечания

Примечание

  • Этот модуль должен выполняться локально, что можно сделать, указав connection: local.
  • Обратитесь к Руководству по Infoblox для получения более подробной информации о работе с Infoblox с Ansible.

Примеры

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

Spec-Zone.ru

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