lunik.coredns

Ansible Rolle: CoreDNS

Installiert CoreDNS auf Linux und konfiguriert den Dienst sowie die DNS-Zonen.

Anforderungen

Keine.

Rollenvariablen

Variable	Typ	Beschreibung
`coredns_version`	Zeichenkette	Version von CoreDNS, die installiert werden soll
`coredns_dns_port`	Zahl	Port, auf dem der CoreDNS-Dienst lauscht
`coredns_forwarders`	Liste(Zeichenkette)	Liste von DNS-Servern, an die Anfragen weitergeleitet werden, wenn der CoreDNS-Server keine Antwort hat
`coredns_acls`	Liste(Objekt)	Liste von `acls`-Objekten, die definieren, wer DNS-Anfragen über die CoreDNS-Instanz stellen kann/darf
`coredns_zones`	Liste(Objekt)	Liste von `zone`-Objekten, die die DNS-Zone definieren, über die der CoreDNS-Server autoritär ist
`coredns_cache_prefetch`	Objekt	Parameter zur Konfiguration des Cache-Prefetch des CoreDNS Cache-Plugins
`coredns_cache_serve_stale`	Objekt	Parameter zur Konfiguration des Serving von veralteten Cache-Daten des CoreDNS Cache-Plugins
`coredns_ttl`	Objekt	Parameter zur Konfiguration der Cache-TTL des CoreDNS Cache-Plugins

ACL

Dieser Abschnitt erklärt, wie man das CoreDNS ACL-Plugin mit der Variable coredns_acls konfiguriert. Eine CoreDNS acl definiert, wer DNS-Anfragen über die CoreDNS-Instanz stellen kann/darf.

Jede acl wird mit den folgenden Attributen definiert:

Attribut	Typ	Beschreibung
`cidr`	Zeichenkette	Eine IP CIDR (@IP oder Bereich)
`action`	Zeichenkette	Aktion, die ausgeführt wird, wenn ein Client aus diesem CIDR eine Anfrage stellt

Zone

Dieser Abschnitt erklärt, wie man Zonen mit dem CoreDNS Dateiplugin unter Verwendung der Variable coredns_zones konfiguriert. Jede Zone wird mit den folgenden Attributen definiert:

Attribut	Typ	Beschreibung
`name`	Zeichenkette	Der Name der DNS-Zone
`zone`	Zeichenkette	Hostname der Zone (`example.org` zum Beispiel)
`file`	Zeichenkette	Der Name der Zonendatenbankdatei
`template`	Zeichenkette	Pfad zur Vorlage der Zonendatenbankdatei

Abhängigkeiten

Keine.

Beispiel-Playbook

- hosts: localhost
  vars:
    coredns_forwarders:
      - 9.9.9.9
    coredns_acls:
      - cidr: 192.168.0.0/24
        action: allow
    coredns_zones:
      - name: meine-zone
        zone: meine-zone.fr
        file: db.meine-zone.fr
        template: templates/dbs/meine-zone.fr
  roles:
    - lunik.coredns