Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Rails frontend for PowerDNS running MySQL or PostgreSQL backends
Ruby JavaScript CSS Other
branch: master
Failed to load latest commit information.
app chore: cleaned up some unused code
config add support for specifying the domain type in the zone template.
db add support for specifying the domain type in the zone template.
doc Tons of work, mostly focused around getting devise in place
features use current factory girl syntax
lib Removed usage of iconv in a fairly old rake task
log Skeleton Rails 2.0.2 app for bind-dlz-on-rails
public add support for specifying the domain type in the zone template.
script refactor: updated Vagrantfile and provision script to get us going
spec
stories rspec and rspec_on_rails
test Rough upgrade to Rails 3
vendor/plugins dynamic_form plugin replaced with the gem
.gitignore
.rspec Initial refactoring of models, specs and db upgrades
.ruby-version chore: bump local Ruby version to 2.1.4
.travis.yml feat: more rubies, faster ci, thanks @joshk
CONVENTIONS.textile More love for the docs
CREDITS.textile More love for the docs
Gemfile Merge branch 'master' of github.com:kennethkalmer/powerdns-on-rails
Gemfile.lock fix: missed in previous push
LICENSE Adding an MIT LICENSE file
README.md style: reworked the README with details on the demo
Rakefile Rough upgrade to Rails 3
TODO.textile More love for the docs
Vagrantfile refactor: updated Vagrantfile and provision script to get us going
config.ru Rough upgrade to Rails 3

README.md

Important update

The current master branch of the PowerDNS on Rails project is in turmoil as we fast-forward the project into the future. The very old previous release can be found in the 'rails-2.3.3' branch.

Thanks for your support and understanding.

PowerDNS on Rails

Build Status Code Climate Dependency Status

PowerDNS on Rails is a Ruby on Rails application made to manage PowerDNS installations using the generic MySQL/PostgreSQL backends.

More information:

Quick Installation

Instructions for running a demo version with Vagrant is provided further down.

$ git clone git://github.com/kennethkalmer/powerdns-on-rails.git
$ cd powerdns-on-rails
$ bundle install
$ cp config/database.yml.template config/database.yml

Review config/database.yml and modify as needed. By default it will use the MySQL connection settings.

$ bundle exec rake generate_secret_token db:setup
$ 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.

Features (current and planned)

  • 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

Overview

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.

Demo with Vagrant

There is now a vagrant/virtualbox demo environment included.

Requirements

You will need to have virtualbox and vagrant already installed.

Running locally

Once you have Vagrant installed, you can follow these steps:

$ git clone git://github.com/kennethkalmer/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.

PowerDNS Information

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

Database Structure

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 accomodate users, templates, macros and other features.

Migration to PowerDNS

PowerDNS does provide a suite of migration tools, and they're all covered in the official documentation.

Testing

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.

Something went wrong with that request. Please try again.