pdns-authoritative-api

Эта роль Ansible управляет DNS-зонами через HTTP API PowerDNS.

Требования

Debian или Ubuntu

Переменные роли

Название	Обязательное/По умолчанию	Описание
`pdns_auth_api_connect`	:heavy_check_mark:	URL для подключения (например, `http://127.0.0.1:1234`)
`pdns_auth_api_server`	`localhost`	Сервер, к которому нужно подключиться
`pdns_auth_api_key`	:heavy_check_mark:	API-ключ для использования (может быть пустым)
`pdns_auth_api_zones`	:heavy_check_mark:	Словарь с именами и содержимым DNS-зон (см. ниже)
`pdns_auth_api_remove_unknown_zones`	`false`	Удалять зоны, которые не известны этой роли
`pdns_auth_api_default_metadata`		Метаданные по умолчанию, которые могут быть переопределены для каждой зоны

DNS-зоны

Название	Обязательное/По умолчанию	Описание
`kind`	`Master`	Тип этой зоны (`Master`, `Slave` или `Native`)
`soaEdit`	(:heavy_check_mark:)	(не для Slave-зон) значение SOA-EDIT для этой зоны
`soaEditApi`	(`{{soaEdit}}`	(не для Slave-зон) значение SOA-EDIT-API
`dnssec`	`false`	(не для Slave-зон) Включить DNSSEC и NSEC3 для этой зоны
`presigned`	`false`	(не для Slave-зон) Является ли зона предварительно подписанной и не требует подписания PowerDNS
`apiRectify`	`true`	(не для Slave-зон) Автоматически исправлять изменения через API
`nsec3Param`		(не для Slave-зон) значение записи NSEC3PARAM
`nsec3Narrow`	`false`	(не для Slave-зон) Использовать ли NSEC3 в узком режиме (небольшие обман)
`masters`	(:heavy_check_mark:)	Список мастеров этой зоны
`records`	не для Slave-зон	Список всех записей в этой зоне (см. ниже)
`defaultTTL`	(:heavy_check_mark:)	(не для Slave-зон) TTL для всех RRset без явно установленного TTL
`metadata`		Словарь с метаданными домена. Элементы, присутствующие в базе данных, но отсутствующие здесь, удаляются

Записи

Эта роль автоматически сортирует записи с одинаковыми именами и типами в RRset. Каждая запись может либо указывать содержимое (c), или устанавливать TTL, который применяется ко всему RRset (t).

Записи группируются по типам, которые, в свою очередь, группируются по именам. См. пример ниже. Неизвестные RRset удаляются.

Если запись SOA имеет AUTO в качестве своего серийного номера, текущее значение из текущей зоны используется. Это полезно при установке soaEditApi, чтобы автоматически увеличивать серийный номер.

Содержимое

Название	Обязательное/По умолчанию	Описание
`c`	(:heavy_check_mark:)	Содержимое этой записи. Должно быть опущено, если задано `t`
`t`	(:heavy_check_mark:)	TTL этого RRset. Должно быть опущено, если задано `c`
`r`		Также установить PTR-запись в обратной зоне

Пример плейбука

- hosts: dns
  roles:
  - pdns-authoritative-api
     pdns_auth_api_connect: 'http://127.0.0.1:1234'
     pdns_auth_api_key: 'secretsecretkey'
     pdns_auth_api_zones:
       - name: example.com
         dnssec: true
         nsec3Salt: abab
         defaultNameservers:
           - ns1.example.com
           - ns2.example.com
         metadata:
           ALLOW-AXFR-FROM:
             - AUTO-NS
             - 2001:db8::/48
         records:
           example.com:
             SOA:
               - c: ns1.example.com admin.example.com AUTO 3600 1800 604800 600
             NS:
               - c: ns1.example.com.
               - c: ns2.example.com.
               - t: 15200
           ns1.example.com:
             A:
               - c: 10.0.0.2
                 r: True
             AAAA:
               - c: fe80::1
                 r: True