Ansible役割: TransIP

TransIP APIと冪等的に対話し、例えば名前サーバーやDNS管理を行います。

要件

PythonのpyOpenSSLとrequestsパッケージがAnsible実行ノードに必要です。

役割モジュール

この役割には、内部で使用されるいくつかのAnsibleモジュールが含まれています：

• transip_auth: 有効期限1時間のAPIトークンを生成します。この生成されたAPIトークンはTransIP APIとの対話に使用されます。
• transip_dns: 指定されたドメインのDNSレコードを設定します。
• transip_nameserver: 指定されたドメインの名前サーバーを設定します。

役割変数

利用可能な変数は以下に示されており、デフォルト値も記載されています（defaults/main.ymlを参照）：

transip_user: <未設定>

TransIP APIと対話するために使用するTransIPユーザー（必須）。

transip_private_key: <未設定>

指定されたユーザーのプライベートキーで、APIトークンを生成するために必要です。鍵ペアはTransIPコントロールパネルで生成し、ここに指定する必要があります（プレーンテキストまたはAnsible Vaultで暗号化された値のいずれか）。

transip_domains: []

管理するドメインと、設定する名前サーバーおよびDNS設定。

例データ

transip_domains:
  - name: my-domain-1.com
    nameservers: # このドメインにはTransIPの名前サーバーを使用します
      - ns0.transip.net
      - ns1.transip.nl
      - ns2.transip.eu
    dns_records: # ドメインのすべてのDNSレコード、指定されていないエントリは削除されます
      - name: www
        expire: 86400
        type: "A"
        content: "1.2.3.4"

  - name: my-domain-2.com
    nameservers: # このドメインはCloudflareの名前サーバーを使用しているため、DNSレコードはここには指定しません。
      - kate.ns.cloudflare.com
      - ram.ns.cloudflare.com