ru1

ru1

TLDR just a dynamic DNS updater.

ru1, or [AWS] Route53 update 1 [record], is a tool that keeps one or more A and/or AAAA DNS records hosted in AWS Route53 zones up to date with the Internet-routable IP addresses configured on a network interface.

configuration

Config is uncomplicated YAML and looks like:

interface: em0
type: A
targets:
- zone: myzone.com
  names:
  - moist
  - ''
- zone: myzone.net
  names:
  - ''

The above configuration would watch interface em0 and generate/maintain the below DNS A records:

• moist.myzone.com
• myzone.com (zone apex is represented by an empty string in the names list)
• myzone.net (as above)

demo

Normal usage looks like this:

$ ./ru1 -config=ru1.yaml -log-timestamps
2019/08/25 14:55:17 em0 added 1.2.3.4
2019/08/25 14:55:17 em0 current 1.2.3.4
2019/08/25 14:55:19 found zone 'myzone1' ID '/hostedzone/ABCDEFGHIJKL'
2019/08/25 14:55:19 myzone1: upsert appeared to succeed
2019/08/25 14:55:35 myzone1: upsert sync status: PENDING
2019/08/25 14:55:51 myzone1: upsert sync status: INSYNC
2019/08/25 14:55:52 found zone 'myzone2' ID '/hostedzone/MNOPQRSTUVWX'
2019/08/25 14:55:52 myzone2: upsert appeared to succeed
2019/08/25 14:56:08 myzone2: upsert sync status: PENDING
2019/08/25 14:56:24 myzone2: upsert sync status: INSYNC

options

$ ./ru1 -help
Usage of ./ru1:
  -config string
        path to configuration file (default "ru1.yaml")
  -log-timestamps
        include timestamps in output messages

notes

• healthchecks would be nice
• tested on OpenBSD and macOS
• untested on Linux --- if it works for you, I'd love it if you could let me know. Email or create an issue?
• on OpenBSD, uses pledge and unveil
• investigate making it daemonize (tricky to do properly with Go)
• IPv6 records untested. I don't have working dual-stack at home yet...