Rol de Ansible: Cloudflare DNS

Una Rol de Ansible que gestiona Cloudflare DNS. Se basa en el módulo cloudflare_dns, que es el módulo oficial de Ansible.

Requisitos

• Cuenta de Cloudflare existente.
• Acceso a la clave API global de la cuenta de Cloudflare.

Variables de Rol

Las variables disponibles se enumeran a continuación, junto con sus valores predeterminados (ver defaults/main.yml):

cloudflare_dns_account_email: average.joe@example.org

[Correo electrónico de la] cuenta de Cloudflare.

cloudflare_dns_account_api_token: 123abc456efg

[Token de API global de la] cuenta de Cloudflare.

cloudflare_dns_zone: example.org

Zona DNS objetivo predeterminada.

cloudflare_dns_records:
  - name: foo
    value: 127.0.0.1

Se utiliza cloudflare_dns_records para especificar registros DNS personalizados.

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

Usa zone para anular la zona DNS para una entrada DNS particular.

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

Agrega state: absent para asegurarte de que se elimine un registro DNS.

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

Los registros DNS para los hosts de inventario se crean automáticamente basados en la plantilla anterior.

cloudflare_dns_all_records: "{{ cloudflare_dns_host_records + cloudflare_dns_records }}"

Todos los registros DNS gestionados se combinan dentro de la variable cloudflare_dns_all_records.

Etiquetas

Se pueden usar etiquetas para limitar la ejecución del rol a un módulo de tarea particular. Las siguientes etiquetas están disponibles:

• cloudflare_dns,config: Cubre todo el ciclo de vida del rol.

Dependencias

Ninguna.

Ejemplo de Playbook

- hosts: all
  roles:
     - nl2go.cloudflare_dns
          

Desarrollo

Usa docker-molecule siguiendo las instrucciones para ejecutar Molecule o instala Molecule localmente (no recomendado, pueden aparecer conflictos de versión).

Proporciona las credenciales de la API de Cloudflare utilizando variables de entorno:

export CLOUDFLARE_DNS_ACCOUNT_EMAIL[email protected]
export CLOUDFLARE_DNS_ACCOUNT_API_TOKEN=123abc456efg

Usa lo siguiente para ejecutar pruebas:

molecule test --all
   

Mantenedores

• build-failure

Licencia

Consulta el archivo LICENSE.md para más detalles.

Información del Autor

Esta rol fue creada en 2020 por Newsletter2Go GmbH.