Ansible Rolle: TransIP

Interagiert auf idempotente Weise mit der TransIP API für zum Beispiel Nameserver- und DNS-Verwaltung.

Anforderungen

Die Python-Pakete pyOpenSSL und requests sind auf dem Ansible-Ausführungsnode erforderlich.

Rollenmoudle

Diese Rolle enthält ein paar Ansible-Module, die intern in dieser Rolle verwendet werden:

• transip_auth: Verantwortlich für die Generierung eines API-Tokens mit einer Gültigkeit von 1 Stunde. Das generierte API-Token wird für die Interaktion mit der TransIP API verwendet.
• transip_dns: Verantwortlich für das Setzen von DNS-Einträgen für die angegebenen Domain(s).
• transip_nameserver: Verantwortlich für das Setzen von Nameservern für die angegebenen Domain(s).

Rollenvariablen

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

transip_user: <nicht gesetzt>

Der TransIP-Benutzer, der für die Interaktion mit der TransIP API verwendet werden soll (erforderlich).

transip_private_key: <nicht gesetzt>

Der private Schlüssel für den angegebenen Benutzer, damit ein API-Token generiert werden kann. Ein Schlüsselpaar muss im TransIP-Kontrollpanel generiert und hier angegeben werden (entweder im Klartext oder als Ansible Vault verschlüsselter Wert).

transip_domains: []

Die Domains, die verwaltet werden sollen und für die Nameserver und DNS-Einstellungen festgelegt werden sollen.

Beispieldaten

transip_domains:
  - name: mein-domain-1.com
    nameservers: # Verwenden Sie die TransIP-Nameserver für diese Domain
      - ns0.transip.net
      - ns1.transip.nl
      - ns2.transip.eu
    dns_records: # Alle DNS-Einträge für die Domain, nicht spezifizierte Einträge werden entfernt
      - name: www
        expire: 86400
        type: "A"
        content: "1.2.3.4"

  - name: mein-domain-2.com
    nameservers: # Diese Domain verwendet die Cloudflare-Nameserver; daher hier keine DNS-Einträge angeben.
      - kate.ns.cloudflare.com
      - ram.ns.cloudflare.com