From bfc5a59521a61a188e41b241d3937aa3092c822a Mon Sep 17 00:00:00 2001 From: Tom Limoncelli Date: Thu, 13 Apr 2017 11:26:53 -0400 Subject: [PATCH] convertzone: Add build instructions. --- README.md | 9 ++++++++- misc/convertzone/README.md | 14 ++++++++++++-- 2 files changed, 20 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index cfc1dcd58..382f0cd38 100644 --- a/README.md +++ b/README.md @@ -86,8 +86,15 @@ Writing new plugins is very easy. # Installation +## From source + +This command will download the source code, compile it, and put the resulting +binary in `~/bin/` + ```cmd go get github.com/StackExchange/dnscontrol ``` -or get prebuilt binaries from [github releases](https://github.com/StackExchange/dnscontrol/releases/latest). +## Via packages + +Get prebuilt binaries from [github releases](https://github.com/StackExchange/dnscontrol/releases/latest) diff --git a/misc/convertzone/README.md b/misc/convertzone/README.md index 3a6161ae3..018c55c7d 100644 --- a/misc/convertzone/README.md +++ b/misc/convertzone/README.md @@ -60,7 +60,17 @@ create a dnsconfig.js file that exactly replicates your existing configuration. Only when that is complete should you make any changes to the DNS zone data. This is not required, but it is a lot safer. -### Phase 1: Convert exactly as-is. +### Step 0: Build the software. + +Build the software and install in your personal bin: + +```cmd +$ cd misc/convertzone/ +$ go build +$ cp convertzone ~/bin/. +``` + +### Step 1: Convert exactly as-is. In this phase the goal is to create a dnsconfig.js that exactly replicates the existing DNS data. @@ -75,7 +85,7 @@ time leads to difficult-to-find errors. If convertzone could have done a better job, please let us know! -### Phase 2: Make any changes you desire. +### Step 2: Make any changes you desire. Once `dnscontrol preview` lists no changes, do any cleanups you want. For example, remove obsolete records or add new ones.