route53

README

route53

Name

route53 - enables serving zone data from AWS route53.

Description

The route53 plugin is useful for serving zones from resource record sets in AWS route53. This plugin supports all Amazon Route 53 records (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html). The route53 plugin can be used when coredns is deployed on AWS or elsewhere.

Syntax

route53 [ZONE:HOSTED_ZONE_ID...] {
    [aws_access_key AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY]
    upstream [ADDRESS...]
}

• ZONE the name of the domain to be accessed.
• HOSTED_ZONE_ID the ID of the hosted zone that contains the resource record sets to be accessed.
• AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY the AWS access key ID and secret access key to be used when query AWS (optional). If they are not provided, then coredns tries to access AWS credentials the same way as AWS CLI, e.g., environmental variables, AWS credentials file, instance profile credentials, etc.
• upstream [ADDRESS...] specifies upstream resolver(s) used for resolving services that point to external hosts (eg. used to resolve CNAMEs). If no ADDRESS is given, CoreDNS will resolve against itself. ADDRESS can be an IP, an IP:port or a path to a file structured like resolv.conf (NB: Currently a bug (#2099) is preventing the use of self-resolver).

Examples

Enable route53 with implicit aws credentials and an upstream:

. {
    route53 example.org.:Z1Z2Z3Z4DZ5Z6Z7
    upstream 10.0.0.1
}

Enable route53 with explicit aws credentials:

. {
    route53 example.org.:Z1Z2Z3Z4DZ5Z6Z7 {
      aws_access_key AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY
  }
}

Documentation

Overview

Package route53 implements a plugin that returns resource records from AWS route53.

Index

• type Route53
  • func New(ctx context.Context, c route53iface.Route53API, keys map[string]string, ...) (*Route53, error)
  • func (h *Route53) Name() string
  • func (h *Route53) Run(ctx context.Context) error
  • func (h *Route53) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

Types

type Route53

type Route53 struct {
	Next plugin.Handler
	// contains filtered or unexported fields
}

Route53 is a plugin that returns RR from AWS route53.

func New

func New(ctx context.Context, c route53iface.Route53API, keys map[string]string, up *upstream.Upstream) (*Route53, error)

New returns new *Route53.

func (*Route53) Name

func (h *Route53) Name() string

Name implements plugin.Handler.Name.

func (*Route53) Run

func (h *Route53) Run(ctx context.Context) error

Run executes first update, spins up an update forever-loop. Returns error if first update fails.

func (*Route53) ServeDNS

func (h *Route53) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the plugin.Handler.ServeDNS.