Spec-Zone.ru › Ansible 2.11

community.general.nios_host_record – Настройка записей хостов Infoblox NIOS

Примечание

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

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

Для использования в книге задач укажите: community.general.nios_host_record.

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

Обзор

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

Требования

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

  • infoblox-client

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
aliases
список / элементы=строка
Настраивает необязательный список дополнительных псевдонимов для добавления в запись хоста. Они эквивалентны CNAME, но хранятся в записи хоста. Должен быть в формате списка.
comment
строка
Настраивает текстовую строку комментария, которая должна быть связана с экземпляром этого объекта. Предоставленная текстовая строка будет настроена в экземпляре объекта.
configure_for_dns
логическое значение
    Варианты:
  • нет
  • да ←
Устанавливает DNS для определенного родительского узла. Если пользователю необходимо обойти DNS, он может установить значение в false.

псевдонимы: dns
extattrs
словарь
Позволяет настроить расширяемые атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
ipv4addrs
список / элементы=словарь
Настраивает адреса IPv4 для этой записи хоста. Этот аргумент принимает список значений (см. подопции)

псевдонимы: ipv4
add
логическое значение
добавлен в 0.2.0 community.general
    Варианты:
  • нет
  • да
Если пользователь хочет добавить адрес IPv4 в существующую запись хоста. Обратите внимание, что при использовании add необходимо сохранить state как present, так как новый IP-адрес выделяется существующей записи хоста. См. примеры.
configure_for_dhcp
логическое значение
    Варианты:
  • нет
  • да
Настройте запись хоста через DHCP вместо DNS, если пользователь изменит её на true, ему необходимо указать MAC-адрес для настройки.

псевдонимы: dhcp
ipv4addr
строка / обязательно
Настраивает адрес IPv4 для записи хоста. Пользователи могут динамически назначать IP-адрес IPv4 записи хоста, передав словарь, содержащий nios_next_ip и диапазон сети CIDR. Если пользователь хочет добавить или удалить адрес IPv4 из существующей записи, необходимо использовать параметры add/remove. См. примеры.

псевдонимы: адрес
mac
строка
Настраивает аппаратный MAC-адрес для записи хоста. Если пользователь устанавливает DHCP в значение true, необходимо указать MAC-адрес.
remove
логическое значение
добавлен в 0.2.0 community.general
    Варианты:
  • нет
  • да
Если пользователь хочет удалить адрес IPv4 из существующей записи хоста. Обратите внимание, что при использовании remove необходимо изменить state на absent, так как IP-адрес удаляется из существующей записи хоста. См. примеры.
ipv6addrs
список / элементы=словарь
Настраивает адреса IPv6 для записи хоста. Этот аргумент принимает список значений (см. параметры)

псевдонимы: ipv6
configure_for_dhcp
логическое значение
    Варианты:
  • нет
  • да
Настройте запись хоста через DHCP вместо DNS, если пользователь изменит её на true, ему необходимо указать MAC-адрес для настройки.
ipv6addr
строка / обязательно
Настраивает адрес IPv6 для записи хоста

псевдонимы: адрес
mac
строка
Настраивает аппаратный MAC-адрес для записи хоста. Если пользователь устанавливает DHCP в значение true, необходимо указать MAC-адрес.
name
строка / обязательно
Указывает полное доменное имя хоста для добавления или удаления из системы. Пользователь также может обновить имя хоста, передав словарь, содержащий new_name, old_name. См. примеры.
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
логическое значение
    Варианты:
  • нет
  • да ←
Отключить urllib3 предупреждения SSL в объекте 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
state
строка
    Варианты:
  • present ←
  • absent
Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства.
ttl
целое число
Настраивает TTL, который должен быть связан с этой записью хоста.
view
строка
По умолчанию:
"default"
Устанавливает просмотр DNS для связывания с этой записью хоста. Просмотр DNS должен быть уже настроен в системе.

псевдонимы: dns_view

Примечания

Примечание

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

Примеры

- name: Configure an ipv4 host record
  community.general.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.1
    aliases:
      - cname.ansible.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Add a comment to an existing host record
  community.general.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.1
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Remove a host record from the system
  community.general.nios_host_record:
    name: host.ansible.com
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Update an ipv4 host record
  community.general.nios_host_record:
    name: {new_name: host-new.ansible.com, old_name: host.ansible.com}
    ipv4:
      - address: 192.168.10.1
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Create an ipv4 host record bypassing DNS
  community.general.nios_host_record:
    name: new_host
    ipv4:
      - address: 192.168.10.1
    dns: false
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Create an ipv4 host record over DHCP
  community.general.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.1
        dhcp: true
        mac: 00-80-C8-E3-4C-BD
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Dynamically add host record to next available ip
  community.general.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: {nios_next_ip: 192.168.10.0/24}
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Add ip to host record
  community.general.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.2
        add: true
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Remove ip to host record
  community.general.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.1
        remove: true
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

  • Питер Спрыгада (@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_host_record_module.html

Spec-Zone.ru

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