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 строка |
| Настраивает требуемое состояние экземпляра объекта на сервере 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