Skip to content

Latest commit

 

History

History
55 lines (39 loc) · 1.64 KB

README.md

File metadata and controls

55 lines (39 loc) · 1.64 KB
Raw

dnslink-route53

Used to deploy dnslink txt records to AWS Route53

Can be used as a library, or as a cli

Install

  • go get -v github.com/RTradeLtd/dnslink-route53
  • cd $GOPATH/src/github.com/RTradeLTd/dnslink-route53
  • make install

Usage - CLI

To install run make install

By default it uses ENV authentication which expects the following environment variables to be set:

  • AWS_ACCESS_KEY_ID
  • AWS_SECRET_ACCESS_KEY
  • Optinonally AWS_SECURITY_TOKEN

If your AWS account needs a security token, you have to use the env auth method.

You can provide a region if you want, but it looks like AWS Route53 doesn't require a specific region, so it should be fine to leave the default at us-east-1. If you want to specify a different region use the -region flag.

You must provide the zone id of your hosted zone through the -zone.id flag

Example invocation using env auth:

$ dlink53 -record.name _dnslink.foo.bar -record.value dnslink=/ipns/foo/bar -zone.id <zone-ID>

successfully deployed dnslink entry to route53

To show the help menu:

$ dlink53 -h
  -access.key string
        aws access key to use if not using env auth
  -name string
        set aws authentication method, valid values are env or get (default "env")
  -record.name string
        the name of the dnslink record, ie _dnslink.foo.bar
  -record.value string
        the value of the dnslink record, ie dnslink=/ipns/foo/bar
  -region string
        the aws region your domain is hosted in (default "us-east-1")
  -secret.key string
        aws secret key use if not using env auth method
  -zone.id string
        the id of the hosted zone for your domain