PowerDNS on Rails is a Ruby on Rails application made to manage PowerDNS installations using the generic MySQL/PostgreSQL backends.
Instructions for running a demo version with Vagrant is provided further down.
$ git clone git://github.com/jfqd/powerdns-on-rails.git
$ cd powerdns-on-rails
$ gem install bundler
$ bundle install --without development test
$ rm -rf public/assets/*
$ bundle exec rails assets:precompile
Review env.bak and modify as needed. By default it will use the MySQL connection settings.
$ cp env.bak .env
$ bundle exec rake db:setup
$ RAILS_SERVE_STATIC_FILES=true RAILS_ENV=production bundle exec rails s
Point your browser to http://localhost:3000, and login with 'admin@example.com' and 'secret'.
Note on versions: PowerDNS on Rails is version-less, and the master branch will nearly always have stable useable code.
- RESTful architecture to support rich UI and API access
- Multi-user support (admins, owners, API clients)
- CLI clients to show integration capabilities
- Conversion and import tools
- Zone/Record Templates
- DNS Insight
- Full audit record of all changes
- Macros for easy bulk updating of domains
- Support for PowerDNS MASTER, NATIVE & SLAVE record types
PowerDNS is a reliable alternative to BIND and sports a flexible, feature rich design and support for various backends, including MySQL and PostgreSQL. This simplifies the management of thousands of zones, and provides added redundancy (by way of database replication) and opens the doors for web frontends that ease this even more.
PowerDNS on Rails is built based on our experience of managing thousands of DNS records through various (often crude) techniques, that included building zone files from databases via cron, and implementing PowerDNS for its database backends.
We first built BIND DLZ on Rails that allowed us to migrate back to BIND using a MySQL 5.0 backend, but after several failed production runs we decided to split the project off to use our existing PowerDNS infrastructure. Using Rails 2 for a interface just makes sense because we can build a rich interface and an REST API in a single go. We have a lot of integration needs, and this was our main driver.
There is now a vagrant/virtualbox demo environment included.
You will need to have virtualbox and vagrant already installed.
Once you have Vagrant installed, you can follow these steps:
$ git clone git://github.com/jfqd/powerdns-on-rails.git
$ cd powerdns-on-rails
$ vagrant up
Once this command completes, you can access the powerdns-on-rails by pointing your browser to http://localhost:8080 and logging in with 'admin@example.com' & secret.
The first time you run this it will download a base virtual machine and bootstrap a working powerdns-on-rails system. This might take some time, use some storage space (~2GB) and bandwidth (~500MB).
Please note that this is just a demo, we don't install or configure PowerDNS itself in the VM.
The PowerDNS project can be found at http://www.powerdns.com/. The documentation is in-depth on that site, I won't repeat anything here unless its related to this project specifically.
It is however worth noting that this interface excepts the "Generic MySQL and PgSQL backend" to be used, as per http://doc.powerdns.com/generic-mypgsql-backends.html
PowerDNS does not allow you to alter the database schema at all, and you're forced to use at least one set database table. It can however handle additions to the table without problems.
We also add several additional tables to accommodate users, templates, macros and other features.
PowerDNS does provide a suite of migration tools, and they're all covered in the official documentation.
PowerDNS on Rails is built using extensive RSpec suites, often termed "Behaviour Driven Development". It is critical for a core service like DNS to be reliable and that all changes are correct and won't impact services offered to clients.
Apart from the extensive programmatic tests, we'll be implementing tests that actually seed a DNS database and use BIND's dig utility to query a configured PowerDNS installation.