https://github.com/stuttgart-things/install-configure-powerdns
deploy, configure & manage powerdns
https://github.com/stuttgart-things/install-configure-powerdns
Last synced: about 1 month ago
JSON representation
deploy, configure & manage powerdns
- Host: GitHub
- URL: https://github.com/stuttgart-things/install-configure-powerdns
- Owner: stuttgart-things
- Created: 2023-05-10T11:47:17.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-17T06:17:40.000Z (5 months ago)
- Last Synced: 2025-02-15T19:38:37.977Z (3 months ago)
- Language: Jinja
- Size: 43.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# stuttgart-things/install-configure-powerdns
This Ansible role can completely set up and configure a PowerDNS DNS server with a mariadb backend and a managment frontend within a podman container with a NGINX reverse proxy for secure access. The entire ansible logic is based on api calls. No client binary is required.
In addition to the installation, this role can also be used to create and delete dns entrys manage dns zones and much more.
### Role installation:
Install this role on your ansible host (click here)
```
cat < /tmp/requirements.yaml
roles:
- src: https://github.com/stuttgart-things/install-configure-powerdns.git
scm: git
- src: https://github.com/stuttgart-things/install-configure-vault.git
scm: git
- src: https://github.com/stuttgart-things/install-requirements.git
scm: git
- src: https://github.com/stuttgart-things/deploy-podman-pod.git
scm: git
- src: https://github.com/stuttgart-things/install-configure-podman.git
scm: git
collections:
- name: containers.podman
version: 1.6.1
- name: community.general
version: 3.4.0
- name: community.crypto
version: 1.7.1
- name: ansible.posix
version: 1.2.0
EOF
ansible-galaxy install -r /tmp/requirements.yaml --force && ansible-galaxy collection install -r /tmp/requirements.yaml -f
```
## Example playbooks to use this role
Install and initializing a powerdns server within a podman container and get cert from vault (click here)
### Ansible command:
```
ansible-playbook -i inventory.ini playbook.yml
```
### Playbook: playbook.yml
```
---
- hosts: "powerdns-server"
become: true
vars:
powerdns_install: true
vault_ca_cert_role_name: labul.sthings.de
vault_url: "https://vault.labul.sthings.de:8200"
vault_token: "example-token-12345"
vault_cert: true
roles:
- install-configure-powerdns
```
### Playbook: inventory.ini
```
[powerdns-server]
example.com
```
Create or delete DNS entrys based on ansible vars profile (click here)
### Ansible command:
```
ansible-playbook -i inventory.ini playbook.yml
```
### Playbook: playbook.yml
```
---
- hosts: "powerdns-server"
vars:
pdns_api_executor: localhost
pdns_url: "https://ns.sthings.de:8443"
pdns_token: "password123"
entry_zone: "sthings.sthings.de."
pdns_create_record:
- fqdn: "*.atalanta.sthings.sthings.de."
content: 10.100.136.242
record_type: A
zone: "{{ entry_zone }}"
state: present
ttl: 60
note: Created with ansible
- fqdn: "vault.sthings.sthings.de."
content: "vault-labul.sthings.de."
record_type: CNAME
zone: "{{ entry_zone }}"
state: present
ttl: 60
note: Created with ansible
roles:
- install-configure-powerdns
```
### Playbook: inventory.ini
```
[powerdns-server]
example.com
```
Create or delete DNS zone based on ansible vars profile (click here)
### Ansible command:
```
ansible-playbook -i inventory.ini playbook.yml
```
### Playbook: playbook.yml
```
---
- hosts: "powerdns-server"
vars:
pdns_api_executor: localhost
pdns_url: "https://ns.sthings.de:8443"
pdns_token: "password123"
pdns_create_zone:
- name: "sthings.sthings.de."
state: present
kind: NATIVE
roles:
- install-configure-powerdns
```
### Playbook: inventory.ini
```
[powerdns-server]
example.com
```
## Requirements and Dependencies:
- Ubuntu 20.04
- Fedora 34
- CentOS 8
- CentOS 7
### Features:
- Install PowerDNS with frontend and backend with NGINX reverse proxy
- Create/delete DNS records
- Create/delete DNS zones
## Version:
```
DATE WHO WHAT
2021-12-14 Marcel Zapf Add logic to create pdns zones
2021-12-14 Marcel Zapf Add feature to disable DNSStubListener systemd-resolved
2021-12-13 Marcel Zapf Initial commit
```
License
-------
BSD
Author Information
------------------
Marcel Zapf; 11/2021; Stuttgart-Things