community.general.dig – запрос DNS с использованием библиотеки dnspython

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

Описание

• Поиск dig выполняет запросы к DNS-серверам для получения DNS-записей для определенного имени (FQDN — полностью квалифицированное доменное имя). Таким образом, можно выполнить поиск любой DNS-записи.
• Существует несколько различных синтаксических конструкций для указания записываемой записи и для которого имени. Также можно явно указать DNS-сервер(ы), которые следует использовать для поиска.
• В своем самом простом виде плагин поиска dig можно использовать для получения 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
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.dig', 'example.com.')}}"

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

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

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

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

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

Возвращаемые значения

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

Авторы

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