dig – запрос DNS с помощью библиотеки dnspython

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

Обзор

• Поиск dig выполняет запросы к серверам DNS для получения записей DNS для определенного имени (FQDN — полностью квалифицированное доменное имя). Таким образом можно выполнить поиск любой записи DNS.
• Существует несколько различных синтаксисов, которые можно использовать для указания, какая запись должна быть получена и для какого имени. Также можно явно указать сервер(ы) DNS, которые нужно использовать для поиска.
• В самом простом виде плагин dig lookup можно использовать для получения IP-адреса IPv4 (запись DNS A), связанного с FQDN.
• В дополнение к записи A (по умолчанию) можно также указать другой тип записи, который нужно запросить. Это можно сделать, передав дополнительный параметр в формате qtype=TYPE в поиск dig или добавив /TYPE к запрашиваемому FQDN.
• Если нескольким значениям соответствует запрошенная запись, результаты будут возвращены в виде списка, разделенного запятыми. В таких случаях вы можете передать параметр wantlist=True в плагин, который приведет к возвращению значений записи в виде списка, по которому можно будет итерироваться впоследствии.
• По умолчанию поиск будет полагаться на настроенные в системе серверы DNS для выполнения запроса. Также можно явно указать серверы DNS для запроса с помощью обозначения @DNS_SERVER_1,DNS_SERVER_2,…,DNS_SERVER_N. Этот параметр необходимо передать как дополнительный параметр в поиск.

Требования

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

• dnspython (библиотека python, http://www.dnspython.org/)

Параметры

Примечания

Примеры

- name: Simple A record (IPV4 address) lookup for example.com
  debug: msg="{{ lookup('dig', 'example.com.')}}"

- name: "The TXT record for example.org."
  debug: msg="{{ lookup('dig', 'example.org.', 'qtype=TXT') }}"

- name: "The TXT record for example.org, alternative syntax."
  debug: msg="{{ lookup('dig', 'example.org./TXT') }}"

- name: use in a loop
  debug: msg="MX record for gmail.com {{ item }}"
  with_items: "{{ lookup('dig', 'gmail.com./MX', wantlist=True) }}"

- debug: msg="Reverse DNS for 192.0.2.5 is {{ lookup('dig', '192.0.2.5/PTR') }}"
- debug: msg="Reverse DNS for 192.0.2.5 is {{ lookup('dig', '5.2.0.192.in-addr.arpa./PTR') }}"
- debug: msg="Reverse DNS for 192.0.2.5 is {{ lookup('dig', '5.2.0.192.in-addr.arpa.', 'qtype=PTR') }}"
- debug: msg="Querying 198.51.100.23 for IPv4 address for example.com. produces {{ lookup('dig', 'example.com', '@198.51.100.23') }}"

- debug: msg="XMPP service for gmail.com. is available at {{ item.target }} on port {{ item.port }}"
  with_items: "{{ lookup('dig', '_xmpp-server._tcp.gmail.com./SRV', 'flat=0', wantlist=True) }}"

Значения возврата

Общие значения возврата описаны здесь, следующие являются полями, уникальными для этого поиска:

Статус

• Этот поиск не гарантирует обратной совместимости интерфейса. [превью]
• Этот поиск поддерживается сообществом Ansible. [сообщество]

Авторы

• Jan-Piet Mens (@jpmens) <jpmens(at)gmail.com>