Rola Ansible: Cloudflare DNS

Jest to rola Ansible, która zarządza Cloudflare DNS. Opiera się na cloudflare_dns, oficjalnym module Ansible.

Wymagania wstępne

• Istniejące konto Cloudflare.
• Dostęp do globalnego klucza API konta Cloudflare.

Zmienne roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi (zobacz defaults/main.yml):

cloudflare_dns_account_email: average.joe@example.org

Email konta Cloudflare.

cloudflare_dns_account_api_token: 123abc456efg

Globalny token API konta Cloudflare.

cloudflare_dns_zone: example.org

Domyślna docelowa strefa DNS.

cloudflare_dns_records:
  - name: foo
    value: 127.0.0.1

Użyj cloudflare_dns_records, aby określić niestandardowe rekordy DNS.

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

Użyj zone, aby zastąpić strefę DNS dla konkretnego wpisu DNS.

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

Dodaj state: absent, aby upewnić się, że rekord DNS zostanie usunięty.

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

Rekordy DNS dla hostów w inwentarzu są tworzone automatycznie na podstawie powyższego szablonu.

cloudflare_dns_all_records: "{{ cloudflare_dns_host_records + cloudflare_dns_records }}"

Wszystkie zarządzane rekordy DNS są łączone w zmiennej cloudflare_dns_all_records.

Tagowanie

Tagi mogą być używane do ograniczenia wykonania roli do konkretnego modułu zadania. Dostępne są następujące tagi:

• cloudflare_dns, config: Obejmuje cały cykl życia roli.

Zależności

Brak.

Przykład playbooka

- hosts: all
  roles:
     - nl2go.cloudflare_dns
          

Rozwój

Użyj docker-molecule zgodnie z instrukcjami, aby uruchomić Molecule lub zainstaluj Molecule lokalnie (nie jest zalecane, mogą wystąpić konflikty wersji).

Podaj dane uwierzytelniające API Cloudflare za pomocą zmiennych środowiskowych:

export CLOUDFLARE_DNS_ACCOUNT_EMAIL[email protected]
export CLOUDFLARE_DNS_ACCOUNT_API_TOKEN=123abc456efg

Użyj poniższego polecenia do uruchomienia testów:

molecule test --all
   

Utrzymujący

• build-failure

Licencja

Szczegóły znajdują się w pliku LICENSE.md.

Informacje o autorze

Ta rola została stworzona w 2020 roku przez Newsletter2Go GmbH.