Git Product home page Git Product logo

python-powerdns-management's Introduction

Python PowerDNS Management

A Pythonic method to managing PowerDNS via API calls.

Requirements

This is being converted to Python3 and will change over time obiously.

Python Virtual Environment

Create a Python virtual environment to keep things clean.

python3 -m venv venv
source venv/bin/activate

Usage

Install Python requirements for using the script:

pip install -r requirements.txt

Development

Install development Python requirements:

pip install -r requirements-dev.txt

Create a new Master Zone with info below

  • Zone: dev.vagrant.local
  • ZoneType: MASTER
  • Master: 192.168.202.200
  • Nameservers:
    • 192.168.202.200
    • 192.168.202.201
    • 192.168.202.202
python pdns.py add_zones --apihost 192.168.202.200 --zone dev.vagrant.local --zoneType MASTER --nameservers 192.168.202.200,192.168.202.201,192.168.202.202

Vagrant Testing

We have included a Vagrant environment for testing and general usages. You can spin this up by:

cd Vagrant
vagrant up

Once the provisioning occurs, you will have a usable Vagrant environment with three nodes running PowerDNS. There are three in case you'd like to play with master/slave scenarios.

When you are done testing you can tear down the Vagrant environment by:

./cleanup.sh

Create the Slave Zones with the info below

  • Zone: dev.vagrant.local
  • ZoneType: SLAVE
  • Master: 192.168.202.200
  • Slaves:
    • 192.168.202.201
    • 192.168.202.202
python pdns.py add_zones --apihost 192.168.202.201 --zone dev.vagrant.local --zoneType SLAVE --masters 192.168.202.200

Create Master Zones using a CSV file

Create a examples/master_zones.csv similar to below:

zone,zoneType,masters,nameservers
128.28.172.in-addr.arpa,MASTER,,"192.168.202.200,192.168.202.201,192.168.202.202"
202.168.192.in-addr.arpa,MASTER,,"192.168.202.200,192.168.202.201,192.168.202.202"
dev.vagrant.local,MASTER,,"192.168.202.200,192.168.202.201,192.168.202.202"
prod.vagrant.local,MASTER,,"192.168.202.200,192.168.202.201,192.168.202.202"
test.vagrant.local,MASTER,,"192.168.202.200,192.168.202.201,192.168.202.202"
vagrant.local,MASTER,,"192.168.202.200,192.168.202.201,192.168.202.202"

The first row is the header...

Now read the csv file using CLI argument:

python pdns.py add_zones --apihost 192.168.202.200 --readcsv examples/master_zones.csv

Create records with info below

  • Zone: dev.vagrant.local
    • name: test01.dev.vagrant.local
    • recordType: A
    • content: 192.168.202.161
    • name: development.dev.vagrant.local
    • recordType: CNAME
    • content: test01.dev.vagrant.local
python pdns.py add_records --zone dev.vagrant.local --name test01 --content 192.168.202.161 --recordType A
python pdns.py add_records --zone dev.vagrant.local --name development --content test01.dev.vagrant.local --recordType CNAME

Create records using a csv file

Create a examples/add_records.csv file similar to below:

name,zone,record_type,content,disabled,ttl,set_ptr,priority
development,test.vagrant.local,A,192.168.202.3,FALSE,3600,TRUE,0
mail,vagrant.local,CNAME,smtp.vagrant.local,FALSE,3600,TRUE,0
node0,test.vagrant.local,A,192.168.202.4,FALSE,3600,TRUE,0
node1,test.vagrant.local,A,192.168.202.5,FALSE,3600,TRUE,0
node100,test.vagrant.local,A,192.168.202.100,FALSE,3600,TRUE,0
node101,test.vagrant.local,A,192.168.202.101,FALSE,3600,TRUE,0
node102,test.vagrant.local,A,192.168.202.102,FALSE,3600,TRUE,0
node2,dev.vagrant.local,A,192.168.202.201,FALSE,3600,TRUE,0
node201,dev.vagrant.local,A,192.168.202.202,FALSE,3600,TRUE,0
node202,dev.vagrant.local,A,192.168.202.203,FALSE,3600,TRUE,0
node203,dev.vagrant.local,CNAME,node201.dev.vagrant.local,FALSE,3600,TRUE,0
smtp,vagrant.local,A,192.168.202.20,FALSE,3600,TRUE,0

The first row is the header...

Now read the csv file using CLI argument:

python pdns.py add_records --apihost 192.168.202.200 --readcsv examples/add_records.csv

Delete records with info below

  • Zone: vagrant.local
    • name: smtp.vagrant.local
    • recordType: A
python pdns.py delete_records --apihost 192.168.202.200 --name smtp --zone vagrant.local --recordType A

Delete records reading from a csv file

Create a examples/delete_records.csv similar to below:

name,zone,record_type
node100,test.vagrant.local,A
node101,test.vagrant.local,A
node202,dev.vagrant.local,A
node203,dev.vagrant.local,CNAME

The first row is the header...

Now read the csv file using CLI argument:

python pdns.py delete_records --apihost 192.168.202.200 --readcsv examples/delete_records.csv

Query PDNS config

python pdns.py query_config --apihost 192.168.202.200

Query zones

python pdns.py query_zones --apihost 192.168.202.200

License

MIT

Author Information

Larry Smith Jr.

python-powerdns-management's People

Contributors

dependabot[bot] avatar mrlesmithjr avatar

Stargazers

avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar avatar avatar

Forkers

stackexpress-kushal yarda7 gnalawade dsnezhkov agenttnt catding tslopes mmg1

python-powerdns-management's Issues

Refactor Code

This script needs so much work that a complete refactoring is in order. Also needs to be converted to Python3.

No new records created

Hello,

i am using a pdns.py script to add records to pdns v4.1.6 and when i run the script i am seeing success.
/pdns.py add_records --apikey 1234 --readcsv /root/devices-9.csv

DNS Record 'node1.domain.com' Successfully Added/Updated

when i check the dns database i don't see anything created. Same issue for a new Zone. If i use curl to create records or a zone via API it works.

Any help please on how to debug the issue?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.