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

Краткое описание

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

Требования

Следующие требования необходимы на локальном узле контроллера, который выполняет этот поиск.

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

Термины

Ключевые параметры

Здесь описываются ключевые параметры поиска. Это значения key1=value1, key2=value2 и так далее в следующих примерах: lookup('community.general.dig', key1=value1, key2=value2, ...) и query('community.general.dig', key1=value1, key2=value2, ...)

Примечания

Примеры

- 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) }}"

- name: Lookup multiple names at once
  ansible.builtin.debug:
    msg: "A record found {{ item }}"
  loop: "{{ query('community.general.dig', 'example.org.', 'example.com.', 'gmail.com.') }}"

- name: Lookup multiple names at once (from list variable)
  ansible.builtin.debug:
    msg: "A record found {{ item }}"
  loop: "{{ query('community.general.dig', *hosts) }}"
  vars:
    hosts:
      - example.org.
      - example.com.
      - gmail.com.

- 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) }}"

- name: Retry nameservers that return SERVFAIL
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.dig', 'example.org./A', retry_servfail=true) }}"

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