README
¶
DynDNS Route53
This is a little program written in Go that takes the WAN ip of your current infrastructure to update a hostname on Amazon Route53.
Installation
Make a binary
The main reasons to choose Go to develop this tool was the fact that Go can build executable binaries. This makes installation very easy. Secondly with Go it's also very easy to cross compile the program for different platforms.
To make a binary just run:
make build
This will result in an executable binary named dyndns_route53.
Cross compile
This real power however is that you can cross compile the code for a number of
platforms.
Personally I have this program running on my (Synology) NAS.
This NAS is running Linux and has a x86-64 architecture. In order to
get the program running on that device you need to cross compile it for that specific platform.
To achieve this, you have to specify two extra parameters on the build command:
GOOS and GOARCH, you can find the appropriate values for
these variables here.
Here's how I build an executable binary for my NAS:
# env GOOS=linux GOARCH=amd64 go build dyndns_route53.go
Configuration
All configuration is done using a .dyndns/config.toml file in your user's home directory.
An example toml config file is
included. Copy config.example and rename it to .dyndns/config.toml. Adjust the values to reflect your environment.
The minimal configuration should look like this:
AccessKeyID = 'AWS Access Key ID'
SecretAccessKey = 'AWS Secret Access Key'
HostedZoneID = 'Route53 Hosted Zone ID'
Fqdn = 'www.example.com'
Debug = true
Logging
The program will write its output to a file named dyndns.log under the same directory as you executable.
Usage
Test and run locally:
go build dyndns_route53.go
go run dyndns_route53.go
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D
Directories