Rôle Ansible : Cloudflare DNS

Un rôle Ansible qui gère Cloudflare DNS. Basé sur le cloudflare_dns, le module Ansible officiel.

Prérequis

• Un compte Cloudflare existant.
• Accès à la clé API globale du compte Cloudflare.

Variables du Rôle

Les variables disponibles sont listées ci-dessous, avec leurs valeurs par défaut (voir defaults/main.yml):

cloudflare_dns_account_email: average.joe@example.org

[Email] du compte Cloudflare.

cloudflare_dns_account_api_token: 123abc456efg

[Token] API global du compte Cloudflare.

cloudflare_dns_zone: example.org

Zone DNS cible par défaut.

cloudflare_dns_records:
  - name: foo
    value: 127.0.0.1

Utilisez cloudflare_dns_records pour spécifier des enregistrements DNS personnalisés.

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

Utilisez zone pour remplacer la zone DNS pour un enregistrement DNS particulier.

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

Ajoutez state: absent pour vous assurer qu'un enregistrement DNS est supprimé.

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

Les enregistrements DNS pour les hôtes de l'inventaire sont créés automatiquement en fonction du modèle ci-dessus.

cloudflare_dns_all_records: "{{ cloudflare_dns_host_records + cloudflare_dns_records }}"

Tous les enregistrements DNS gérés sont combinés dans la variable cloudflare_dns_all_records.

Tags

Les tags peuvent être utilisés pour limiter l'exécution du rôle à une tâche module particulière. Les tags suivants sont disponibles :

• cloudflare_dns, config: Couvre tout le cycle de vie du rôle.

Dépendances

Aucune.

Exemple de Playbook

- hosts: all
  roles:
     - nl2go.cloudflare_dns
          

Développement

Utilisez docker-molecule en suivant les instructions pour exécuter Molecule ou installez Molecule localement (pas recommandé, des conflits de version peuvent apparaître).

Fournissez les informations d'identification API Cloudflare en utilisant des variables d'environnement :

export CLOUDFLARE_DNS_ACCOUNT_EMAIL[email protected]
export CLOUDFLARE_DNS_ACCOUNT_API_TOKEN=123abc456efg

Utilisez ce qui suit pour exécuter les tests :

molecule test --all
   

Mainteneurs

• build-failure

Licence

Voir le fichier LICENSE.md pour les détails.

Informations sur l'Auteur

Ce rôle a été créé en 2020 par Newsletter2Go GmbH.