Rol de Ansible: TransIP

Interactúa de manera idempotente con la API de TransIP para, por ejemplo, la gestión de nombres de servidor y DNS.

Requisitos

Los paquetes de Python pyOpenSSL y requests son necesarios en el nodo ejecutor de Ansible.

Módulos del rol

Este rol contiene un par de módulos de Ansible utilizados internamente en este rol:

• transip_auth: Responsable de generar un token API con una validez de 1 hora. El token API generado se usará para interactuar con la API de TransIP.
• transip_dns: Responsable de establecer registros DNS para los dominios especificados.
• transip_nameserver: Responsable de establecer nombres de servidor para los dominios especificados.

Variables del rol

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

transip_user: <no establecido>

El usuario de TransIP que se usará para interactuar con la API de TransIP (requerido).

transip_private_key: <no establecido>

La clave privada para el usuario especificado, de modo que se pueda generar un token API. Es necesario generar un par de claves en el panel de control de TransIP y especificarlo aquí (ya sea en texto claro o como valor cifrado con Ansible Vault).

transip_domains: []

Los dominios a gestionar y qué nombres de servidor y configuraciones DNS establecer.

Datos de ejemplo

transip_domains:
  - name: my-domain-1.com
    nameservers: # Usa los servidores de nombres de TransIP para este dominio
      - ns0.transip.net
      - ns1.transip.nl
      - ns2.transip.eu
    dns_records: # Todos los registros DNS para el dominio, las entradas no especificadas se eliminarán
      - name: www
        expire: 86400
        type: "A"
        content: "1.2.3.4"

  - name: my-domain-2.com
    nameservers: # Este dominio usa los servidores de nombres de Cloudflare; por lo tanto, no especifiques registros DNS aquí.
      - kate.ns.cloudflare.com
      - ram.ns.cloudflare.com