Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nosmoht/ansible-module-powerdns

Ansible module to manage PowerDNS entries
https://github.com/nosmoht/ansible-module-powerdns

Last synced: about 7 hours ago
JSON representation

Ansible module to manage PowerDNS entries

Host: GitHub
URL: https://github.com/nosmoht/ansible-module-powerdns
Owner: Nosmoht
License: apache-2.0
Created: 2016-08-05T07:59:05.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2022-12-15T14:08:00.000Z (almost 2 years ago)
Last Synced: 2023-12-16T19:23:22.309Z (11 months ago)
Language: Python
Size: 64.5 KB
Stars: 63
Watchers: 9
Forks: 44
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

***IMPORTANT NOTE***

*As i'm not using PowerDNS anymore i will not activly work on the library. Only merging your PR's.
If anyone wants to add the library to the official Ansible module library feel free to do so. Just please add a note about me as the original author and a link to this repo :-)*

PowerDNS Ansible library
==========
- [Introduction](#introduction)
- [Usage](#usage)
- [Zones](#zones)
- [Records](#records)

# Usage

## Zones
Ensure zone is present

```yaml
- powerdns_zone:
name: zone01.internal.example.com.
nameservers:
- ns-01.example.com.
- ns-02.example.com.
kind: master
state: present
pdns_host: powerdns.example.com
pdns_port: 8081
pdns_api_key: topsecret
```

Ensure zone is absent
```yaml
- powerdns_zone:
name: zone02.internal.example.com
state: absent
pdns_host: powerdns.example.com
pdns_port: 8081
pdns_api_key: topsecret
```

## Records

Ensure A record
```yaml
- powerdns_record:
name: host01.zone01.internal.example.com.
zone: zone01.internal.example.com
type: A
content: 192.168.1.234
ttl: 1440
pdns_host: powerdns.example.com
pdns_port: 443
pdns_api_key: topsecret
pdns_prot: https
```

Absent all A record: this will delete all A record, even you specified ip in content
```yaml
- powerdns_record:
name: host01.zone01.internal.example.com.
state: absent
zone: zone01.internal.example.com
type: A
content: 192.168.1.234
ttl: 1440
pdns_host: powerdns.example.com
pdns_port: 443
pdns_api_key: topsecret
pdns_prot: https
```

Absent particular A record: this will remove only one A record for specific ip
```yaml
- powerdns_record:
name: host01.zone01.internal.example.com.
state: absent
exclusive: false
zone: zone01.internal.example.com
type: A
content: 192.168.1.234
ttl: 1440
pdns_host: powerdns.example.com
pdns_port: 443
pdns_api_key: topsecret
pdns_prot: https
```

Ensure AAAA record
```yaml
- powerdns_record:
name: host01.zone01.internal.example.com.
zone: zone01.internal.example.com
type: AAAA
content: 2001:cdba:0000:0000:0000:0000:3257:9652
ttl: 1440
pdns_host: powerdns.example.com
pdns_port: 8443
pdns_api_key: topsecret
pdns_prot: https
```

Do not verify SSL certificate (this is a security risk)

```yaml
- powerdns_record:
name: host01.zone01.internal.example.com.
zone: zone01.internal.example.com
type: AAAA
content: 2001:cdba:0000:0000:0000:0000:3257:9652
ttl: 1440
pdns_host: powerdns.example.com
pdns_port: 8443
pdns_api_key: topsecret
pdns_prot: https
strict_ssl_checking: false
```

Ensure CNAME record
```yaml
- powerdns_record:
name: database.zone01.internal.example.com.
zone: zone01.internal.example.com
type: CNAME
content: host01.zone01.internal.example.com
pdns_host: powerdns.example.com
pdns_port: 80
pdns_api_key: topsecret
pdns_prot: http
```

Ensure multiple MX records
```yaml
- powerdns_record:
name: zone01.internal.example.com.
zone: zone01.internal.example.com
type: MX
content:
- 10 mx1.zone01.internal.example.com
- 10 mx2.zone01.internal.example.com
pdns_host: powerdns.example.com
pdns_port: 80
pdns_api_key: topsecret
pdns_prot: http
```

Use HTTP Basic Auth instead of API Key
```yaml
- powerdns_record:
name: database.zone01.internal.example.com.
zone: zone01.internal.example.com
type: CNAME
content: host01.zone01.internal.example.com
pdns_host: powerdns.example.com
pdns_port: 80
pdns_api_username: myuser
pdns_api_password: mytopsecretpassword
pdns_prot: http
```

`pdns_api_key` takes preference if both `pdns_api_key` and `pdns_api_username`/`pdns_api_password` are supplied.

Note the trailing '.' following most records, if not present will result in the error "Domain record is not canonical".