Ansible-Rolle: Cloudflare DNS

Eine Ansible-Rolle, die Cloudflare DNS verwaltet. Basierend auf dem offiziellen Ansible-Modul cloudflare_dns.

Voraussetzungen

• Ein bestehendes Cloudflare-Konto.
• Zugriff auf den globalen API-Schlüssel des Cloudflare-Kontos.

Rollenvariablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit Standardwerten (siehe defaults/main.yml):

cloudflare_dns_account_email: average.joe@example.org

[E-Mail-Adresse] des Cloudflare-Kontos.

cloudflare_dns_account_api_token: 123abc456efg

[Globaler API-Token] des Cloudflare-Kontos.

cloudflare_dns_zone: example.org

Standard-Ziel-DNS-Zone.

cloudflare_dns_records:
  - name: foo
    value: 127.0.0.1

Verwenden Sie cloudflare_dns_records, um benutzerdefinierte DNS-Einträge anzugeben.

cloudflare_dns_records:
  - name: foo
    value: 127.0.0.1
    zone: example.com

Verwenden Sie zone, um die DNS-Zone für einen bestimmten DNS-Eintrag zu überschreiben.

cloudflare_dns_records:
  - name: foo
    value: 127.0.0.1
    state: absent

Fügen Sie state: absent hinzu, um sicherzustellen, dass ein DNS-Eintrag entfernt wird.

cloudflare_dns_host_records:
  - name: "{{ inventory_hostname }}"
    value: "{{ hostvars[inventory_hostname].ansible_default_ipv4.address }}"

DNS-Einträge für die Inventar-Hosts werden automatisch basierend auf der obigen Vorlage erstellt.

cloudflare_dns_all_records: "{{ cloudflare_dns_host_records + cloudflare_dns_records }}"

Alle verwalteten DNS-Einträge werden in der Variable cloudflare_dns_all_records kombiniert.

Tags

Tags können verwendet werden, um die Ausführung der Rolle auf ein bestimmtes Aufgabenmodul zu beschränken. Die folgenden Tags sind verfügbar:

• cloudflare_dns, config: Beinhaltet den gesamten Lebenszyklus der Rolle.

Abhängigkeiten

Keine.

Beispiel-Playbook

- hosts: all
  roles:
     - nl2go.cloudflare_dns

Entwicklung

Verwenden Sie docker-molecule gemäß den Anweisungen, um Molecule auszuführen oder installieren Sie Molecule lokal (nicht empfohlen, es können Versionskonflikte auftreten).

Geben Sie die [Cloudflare]-API-Anmeldeinformationen über Umgebungsvariablen an:

export CLOUDFLARE_DNS_ACCOUNT_EMAIL[email protected]
export CLOUDFLARE_DNS_ACCOUNT_API_TOKEN=123abc456efg

Verwenden Sie Folgendes, um Tests auszuführen:

molecule test --all

Wartungsarbeiten

• build-failure

Lizenz

Siehe die Datei LICENSE.md für Einzelheiten.

Autorinformation

Diese Rolle wurde 2020 von Newsletter2Go GmbH erstellt.