robertdebock.dns

Ansibleロールdns

システムにdnsをインストールして設定します。

GitHub GitLab ダウンロード バージョン
github gitlab downloads バージョン

例のプレイブック

この例はmolecule/default/converge.ymlから取られており、各プッシュ、プルリクエスト、リリースでテストされています。

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: robertdebock.dns
      dns_allow_transfer:
        - none
        - "127.0.0.1"
      dns_zones:
        - name: localhost
          type: primary
          soa: localhost
          serial: 1
          refresh: 604800
          retry: 86400
          expire: 2419200
          ttl: 604800
          records:
            - name: "@"
              type: NS
              value: localhost.
            - name: "@"
              value: "127.0.0.1"
            - name: "@"
              type: AAAA
              value: "::1"
        - name: "127.in-addr.arpa"
          ttl: 604800
          type: primary
          records:
            - name: "@"
              type: NS
              value: localhost.
            - name: "1.0.0"
              type: PTR
              value: localhost.
        - name: "0.in-addr.arpa"
          type: primary
          records:
            - name: "@"
              type: NS
              value: localhost.

        - name: "255.in-addr.arpa"
          type: primary
          records:
            - name: "@"
              type: NS
              value: localhost.
        - name: example.com
          type: primary
          ttl: 604800
          ns:
            - name: dns1.example.com.
            - name: dns2.example.com.
          mx:
            - name: mail1.example.com.
              priority: 10
            - name: mail2.example.com.
              priority: 20
          records:
            - name: dns1
              value: "127.0.0.1"
            - name: dns2
              value: "127.0.0.1"
            - name: www
              value: "127.0.0.1"
            - name: dns1
              value: "127.0.0.1"
            - name: dns2
              value: "127.0.0.1"
            - name: mail1
              value: "127.0.0.1"
            - name: mail2
              value: "127.0.0.1"
        - name: forwarded.example.com
          type: forward
          forwarders:
            - "1.1.1.1"
            - "8.8.8.8"
        - name: secondary.example.com
          type: secondary
          primaries:
            - "127.0.0.1"
            - "127.0.0.2"
        - name: lab.controlplane.info
          type: primary
          ttl: 600
          ns:
            - name: ns.lab.controlplane.info.
          mx:
            - name: mail1.lab.controlplane.info.
              priority: 10
            - name: mail2.lab.controlplane.info.
              priority: 20
          records:
            - name: ns
              value: "192.168.254.27"
            - name: git
              value: "192.168.254.19"
            - name: dl380
              value: "192.168.254.27"
            - name: mail1
              value: "192.168.123.123"
            - name: mail2
              value: "192.168.123.123"
        - name: forwarded.lab.controlplane.info
          type: forward
          ns:
            - name: forwarded.lab.controlplane.info.
          records:
            - name: ns
              value: "192.168.254.27"
            - name: "@"
              value: "192.168.123.123"
          forwarders:
            - "9.9.9.9"
            - "8.8.8.8"

マシンを準備する必要があります。CIでは、molecule/default/prepare.ymlを使って行います。

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: robertdebock.bootstrap
    - role: robertdebock.core_dependencies

これらのロールの使い方については、完全な説明と例もご覧ください。

ロールの変数

変数のデフォルト値は、defaults/main.ymlに設定されています。

---
# dns用のデフォルトファイル

# リッスンするポート。
dns_port: 53

# DNSサーバーをキャッシュDNSサーバーにするか?
dns_caching_dns: true

# ゾーンと各ゾーンのプロパティのリスト。
dns_zones:
  - name: localhost
    type: primary
    soa: localhost
    serial: 1
    refresh: 604800
    retry: 86400
    expire: 2419200
    ttl: 604800
    records:
      - name: "@"
        type: NS
        value: localhost.
      - name: "@"
        value: "127.0.0.1"
      - name: "@"
        type: AAAA
        value: "::1"
  - name: "127.in-addr.arpa"
    ttl: 604800
    type: primary
    records:
      - name: "@"
        type: NS
        value: localhost.
      - name: "1.0.0"
        type: PTR
        value: localhost.
  - name: "0.in-addr.arpa"
    type: primary
    records:
      - name: "@"
        type: NS
        value: localhost.
  - name: "255.in-addr.arpa"
    type: primary
    records:
      - name: "@"
        type: NS
        value: localhost.

# 再帰を許可するためのACLのオプショナルリスト。("any"と"none"は常に利用可能。)
dns_allow_recursion:
  - none

# DNSサーバーがリッスンするIPv4のオプショナルリスト。("any"と"none"は常に利用可能。)
dns_listen_on:
  - any

# DNSサーバーがリッスンするIPv6のオプショナルリスト。("any"と"none"は常に利用可能。)
dns_listen_on_v6:
  - any

# サーバーをクエリすることを許可されたIPのオプショナルリスト。("any"と"none"は常に利用可能。)
# デフォルト: "any"
# dns_allow_query:
#  - any
#  - "127.0.0.1"

# AXFRクエリを実行することを許可されたIPのオプショナルリスト。("any"と"none"は常に利用可能。)
# デフォルト: "none"
# dns_allow_transfer:
#   - none
#   - "172.16.0.1"

# pidファイルを作成するパスを設定するオプショナル設定。
dns_pid_file: /run/named/named.pid

# トラフィックを他のDNSサーバーに転送するオプショナル設定。
# dns_forwarders:
#   - "1.1.1.1"
#   - "8.8.8.8"

要件

使用されるロールの状態

次のロールがシステムを準備するために使用されます。他の方法でシステムを準備することもできます。

要件 GitHub GitLab
robertdebock.bootstrap ビルド状態 GitHub ビルド状態 GitLab
robertdebock.core_dependencies ビルド状態 GitHub ビルド状態 GitLab

コンテキスト

このロールは多くの互換性のあるロールの一部です。詳細については、これらのロールのドキュメントを参照してください。

関連ロールの概要を以下に示します: 依存関係

互換性

このロールは次のコンテナイメージでテストされています:

コンテナ タグ
Alpine すべて
Amazon 候補
EL 9
Debian すべて
Fedora すべて
Ubuntu すべて

必要なAnsibleの最小バージョンは2.12で、以下のテストが行われました:

  • 前のバージョン。
  • 現在のバージョン。
  • 開発バージョン。

問題が見つかった場合は、GitHubに報告してください。

ライセンス

Apache-2.0

著者情報

robertdebock

スポンサーすることを検討してください

プロジェクトについて

Install and configure dns on your system.

インストール
ansible-galaxy install robertdebock.dns
ライセンス
apache-2.0
ダウンロード
1.2k
所有者
I know my way around (Linux) infrastructure, have a passion for automation, Docker, Ansible, Molecule and ci/cd.