Project

redzone

0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
RedZone is a command-line too that can generate bind zone files and configuration from yaml syntax.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

~> 1.5
>= 0

Runtime

~> 0.18.1
 Project Readme

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.