Skip to content
/ redzone Public
forked from justenwalker/redzone

RedZone - Generate BIND zone files from simple YAML configuration.

License

Notifications You must be signed in to change notification settings

qub/redzone

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RedZone

Gem Version Build Status

Generate BIND zone files from simple yaml configuration.

Introduction

RedZone is a command-line utility for generating BIND DNS zone files from a YAML file.

RedZone was inspired by Daniel P. Berrange's NoZone script which does something very similar in Perl. The notable differences are:

  • Added support for reverse-dns generation
  • Removed zone inheritance, opting instead to just use a common section from which all zones inherit details.
  • No generation of named.conf.

Disclaimer

This gem was just released (pre 1.0) and is not ready for production use yet.

During pre 1.0, things may change that break backwards compatibility between releases. Most likely these breaking changes would be related to the YAML file syntax.

To Do

See the Issue Tracker

Installation

$ gem install redzone

gem install redzone

Usage

RedZone commands:
  redzone generate [DIRECTORY]  # Generates a bind database files into the given DIRECTORY. If DIRECTORY is not supplied, it defaults to '/var/named'
  redzone help [COMMAND]        # Describe available commands or one specific command
  redzone version               # Shows the current version of redzone

Options:
  [--zones=ZONES]  # RedZone zone configuration.
                   # Default: /etc/redzone/zones.yml

Generating zone databases

  • Create a zones.yml file (See [zones.yml.example]) in /etc/redzone
  • Execute redzone generate /var/named/data
  • Each zone and reverse record database should be present in /var/named

For example, if your zone.yml file is like the zones.yml.example file then the resulting db files are:

$ ls -1 /var/named/data
0.0.0.0.0.0.0.0.0.0.c.f.ip6.arpa.db
1.168.192.in-addr.arpa.db
32.12.in-addr.arpa.db
9.8.7.6.4.3.2.1.1.0.0.2.ip6.arpa.db
qa.redzone.com.db
redzone.com.db

How to Contribute

Running the tests

$ bundle
$ bundle exec rake spec

Installing locally

$ bundle
$ [bundle exec] rake install

Reporting Issues

Please include a reproducible test case.

License

Copyright (c) 2014 Justen Walker.

Released under the terms of the MIT License. For further information, please see the file LICENSE.md.

About

RedZone - Generate BIND zone files from simple YAML configuration.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%