mirror of
				https://github.com/coredns/coredns.git
				synced 2025-10-30 17:53:21 -04:00 
			
		
		
		
	Start working on a etcd backend
This commit is contained in:
		
							
								
								
									
										159
									
								
								middleware/etcd/backend.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										159
									
								
								middleware/etcd/backend.go
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,159 @@ | ||||
| // Package etcd provides the etcd server Backend implementation, | ||||
| package etcd | ||||
|  | ||||
| import ( | ||||
| 	"encoding/json" | ||||
| 	"fmt" | ||||
| 	"strings" | ||||
|  | ||||
| 	"github.com/miekg/coredns/middleware/etcd/msg" | ||||
|  | ||||
| 	etcdc "github.com/coreos/etcd/client" | ||||
| ) | ||||
|  | ||||
| func (g *Backend) Records(name string, exact bool) ([]msg.Service, error) { | ||||
| 	path, star := msg.PathWithWildcard(name) | ||||
| 	r, err := g.get(path, true) | ||||
| 	if err != nil { | ||||
| 		return nil, err | ||||
| 	} | ||||
| 	segments := strings.Split(msg.Path(name), "/") | ||||
| 	switch { | ||||
| 	case exact && r.Node.Dir: | ||||
| 		return nil, nil | ||||
| 	case r.Node.Dir: | ||||
| 		return g.loopNodes(r.Node.Nodes, segments, star, nil) | ||||
| 	default: | ||||
| 		return g.loopNodes([]*etcdc.Node{r.Node}, segments, false, nil) | ||||
| 	} | ||||
| } | ||||
|  | ||||
| func (g *Backend) ReverseRecord(name string) (*msg.Service, error) { | ||||
| 	path, star := msg.PathWithWildcard(name) | ||||
| 	if star { | ||||
| 		return nil, fmt.Errorf("reverse can not contain wildcards") | ||||
| 	} | ||||
| 	r, err := g.get(path, true) | ||||
| 	if err != nil { | ||||
| 		return nil, err | ||||
| 	} | ||||
| 	if r.Node.Dir { | ||||
| 		return nil, fmt.Errorf("reverse must not be a directory") | ||||
| 	} | ||||
| 	segments := strings.Split(msg.Path(name), "/") | ||||
| 	records, err := g.loopNodes([]*etcdc.Node{r.Node}, segments, false, nil) | ||||
| 	if err != nil { | ||||
| 		return nil, err | ||||
| 	} | ||||
| 	if len(records) != 1 { | ||||
| 		return nil, fmt.Errorf("must be only one service record") | ||||
| 	} | ||||
| 	return &records[0], nil | ||||
| } | ||||
|  | ||||
| // get is a wrapper for client.Get that uses SingleInflight to suppress multiple | ||||
| // outstanding queries. | ||||
| func (g *Backend) get(path string, recursive bool) (*etcdc.Response, error) { | ||||
| 	resp, err := g.inflight.Do(path, func() (interface{}, error) { | ||||
| 		r, e := g.client.Get(g.ctx, path, &etcdc.GetOptions{Sort: false, Recursive: recursive}) | ||||
| 		if e != nil { | ||||
| 			return nil, e | ||||
| 		} | ||||
| 		return r, e | ||||
| 	}) | ||||
| 	if err != nil { | ||||
| 		return nil, err | ||||
| 	} | ||||
| 	return resp.(*etcdc.Response), err | ||||
| } | ||||
|  | ||||
| type bareService struct { | ||||
| 	Host     string | ||||
| 	Port     int | ||||
| 	Priority int | ||||
| 	Weight   int | ||||
| 	Text     string | ||||
| } | ||||
|  | ||||
| // skydns/local/skydns/east/staging/web | ||||
| // skydns/local/skydns/west/production/web | ||||
| // | ||||
| // skydns/local/skydns/*/*/web | ||||
| // skydns/local/skydns/*/web | ||||
|  | ||||
| // loopNodes recursively loops through the nodes and returns all the values. The nodes' keyname | ||||
| // will be match against any wildcards when star is true. | ||||
| func (g *Backend) loopNodes(ns []*etcdc.Node, nameParts []string, star bool, bx map[bareService]bool) (sx []msg.Service, err error) { | ||||
| 	if bx == nil { | ||||
| 		bx = make(map[bareService]bool) | ||||
| 	} | ||||
| Nodes: | ||||
| 	for _, n := range ns { | ||||
| 		if n.Dir { | ||||
| 			nodes, err := g.loopNodes(n.Nodes, nameParts, star, bx) | ||||
| 			if err != nil { | ||||
| 				return nil, err | ||||
| 			} | ||||
| 			sx = append(sx, nodes...) | ||||
| 			continue | ||||
| 		} | ||||
| 		if star { | ||||
| 			keyParts := strings.Split(n.Key, "/") | ||||
| 			for i, n := range nameParts { | ||||
| 				if i > len(keyParts)-1 { | ||||
| 					// name is longer than key | ||||
| 					continue Nodes | ||||
| 				} | ||||
| 				if n == "*" || n == "any" { | ||||
| 					continue | ||||
| 				} | ||||
| 				if keyParts[i] != n { | ||||
| 					continue Nodes | ||||
| 				} | ||||
| 			} | ||||
| 		} | ||||
| 		serv := new(msg.Service) | ||||
| 		if err := json.Unmarshal([]byte(n.Value), serv); err != nil { | ||||
| 			return nil, err | ||||
| 		} | ||||
| 		b := bareService{serv.Host, serv.Port, serv.Priority, serv.Weight, serv.Text} | ||||
| 		if _, ok := bx[b]; ok { | ||||
| 			continue | ||||
| 		} | ||||
| 		bx[b] = true | ||||
|  | ||||
| 		serv.Key = n.Key | ||||
| 		serv.Ttl = g.calculateTtl(n, serv) | ||||
| 		if serv.Priority == 0 { | ||||
| 			serv.Priority = int(g.config.Priority) | ||||
| 		} | ||||
| 		sx = append(sx, *serv) | ||||
| 	} | ||||
| 	return sx, nil | ||||
| } | ||||
|  | ||||
| // calculateTtl returns the smaller of the etcd TTL and the service's | ||||
| // TTL. If neither of these are set (have a zero value), the server | ||||
| // default is used. | ||||
| func (g *Backend) calculateTtl(node *etcdc.Node, serv *msg.Service) uint32 { | ||||
| 	etcdTtl := uint32(node.TTL) | ||||
|  | ||||
| 	if etcdTtl == 0 && serv.Ttl == 0 { | ||||
| 		return g.config.Ttl | ||||
| 	} | ||||
| 	if etcdTtl == 0 { | ||||
| 		return serv.Ttl | ||||
| 	} | ||||
| 	if serv.Ttl == 0 { | ||||
| 		return etcdTtl | ||||
| 	} | ||||
| 	if etcdTtl < serv.Ttl { | ||||
| 		return etcdTtl | ||||
| 	} | ||||
| 	return serv.Ttl | ||||
| } | ||||
|  | ||||
| // Client exposes the underlying Etcd client (used in tests). | ||||
| func (g *Backend) Client() etcdc.KeysAPI { | ||||
| 	return g.client | ||||
| } | ||||
							
								
								
									
										34
									
								
								middleware/etcd/etcd.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										34
									
								
								middleware/etcd/etcd.go
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,34 @@ | ||||
| // Package etcd provides the etcd backend. | ||||
| package etcd | ||||
|  | ||||
| import ( | ||||
| 	"github.com/skynetservices/skydns/singleflight" | ||||
|  | ||||
| 	etcd "github.com/coreos/etcd/client" | ||||
| 	"golang.org/x/net/context" | ||||
| ) | ||||
|  | ||||
| type ( | ||||
| 	Etcd struct { | ||||
| 		Ttl      uint32 | ||||
| 		Priority uint16 | ||||
| 		Backend  *Backend | ||||
| 	} | ||||
| ) | ||||
|  | ||||
| type Backend struct { | ||||
| 	client   etcd.KeysAPI | ||||
| 	ctx      context.Context | ||||
| 	config   *Config | ||||
| 	inflight *singleflight.Group | ||||
| } | ||||
|  | ||||
| // NewBackend returns a new Backend. | ||||
| func NewBackend(client etcd.KeysAPI, ctx context.Context, config *Config) *Backend { | ||||
| 	return &Backend{ | ||||
| 		client:   client, | ||||
| 		ctx:      ctx, | ||||
| 		config:   config, | ||||
| 		inflight: &singleflight.Group{}, | ||||
| 	} | ||||
| } | ||||
							
								
								
									
										26
									
								
								middleware/etcd/etcd.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										26
									
								
								middleware/etcd/etcd.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,26 @@ | ||||
| # etcd | ||||
|  | ||||
| `etcd` enabled reading zone data from an etcd instance. The data in etcd has to be encoded as | ||||
| a [message](https://github.com/skynetservices/skydns/blob/2fcff74cdc9f9a7dd64189a447ef27ac354b725f/msg/service.go#L26) | ||||
| like SkyDNS. | ||||
|  | ||||
| ## Syntax | ||||
|  | ||||
| ~~~ | ||||
| etcd [address...] | ||||
| ~~~ | ||||
|  | ||||
| * `address` is the endpoint of etcd. | ||||
|  | ||||
| The will default to `/skydns` as the path and the local etcd proxy (http://127.0.0.1:2379). | ||||
|  | ||||
| ~~~ | ||||
| etcd { | ||||
|     round_robin | ||||
|     path /skydns | ||||
|     address address... | ||||
|     stubzones | ||||
| } | ||||
| ~~~ | ||||
|  | ||||
| ## Examples | ||||
							
								
								
									
										212
									
								
								middleware/etcd/msg/service.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										212
									
								
								middleware/etcd/msg/service.go
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,212 @@ | ||||
| package msg | ||||
|  | ||||
| import ( | ||||
| 	"net" | ||||
| 	"path" | ||||
| 	"strings" | ||||
|  | ||||
| 	"github.com/miekg/dns" | ||||
| ) | ||||
|  | ||||
| // PathPrefix is the prefix used to store CoreDNS data in etcd. | ||||
| var PathPrefix string = "skydns" | ||||
|  | ||||
| // This *is* the rdata from a SRV record, but with a twist. | ||||
| // Host (Target in SRV) must be a domain name, but if it looks like an IP | ||||
| // address (4/6), we will treat it like an IP address. | ||||
| type Service struct { | ||||
| 	Host     string `json:"host,omitempty"` | ||||
| 	Port     int    `json:"port,omitempty"` | ||||
| 	Priority int    `json:"priority,omitempty"` | ||||
| 	Weight   int    `json:"weight,omitempty"` | ||||
| 	Text     string `json:"text,omitempty"` | ||||
| 	Mail     bool   `json:"mail,omitempty"` // Be an MX record. Priority becomes Preference. | ||||
| 	Ttl      uint32 `json:"ttl,omitempty"` | ||||
|  | ||||
| 	// When a SRV record with a "Host: IP-address" is added, we synthesize | ||||
| 	// a srv.Target domain name.  Normally we convert the full Key where | ||||
| 	// the record lives to a DNS name and use this as the srv.Target.  When | ||||
| 	// TargetStrip > 0 we strip the left most TargetStrip labels from the | ||||
| 	// DNS name. | ||||
| 	TargetStrip int `json:"targetstrip,omitempty"` | ||||
|  | ||||
| 	// Group is used to group (or *not* to group) different services | ||||
| 	// together. Services with an identical Group are returned in the same | ||||
| 	// answer. | ||||
| 	Group string `json:"group,omitempty"` | ||||
|  | ||||
| 	// Etcd key where we found this service and ignored from json un-/marshalling | ||||
| 	Key string `json:"-"` | ||||
| } | ||||
|  | ||||
| // NewSRV returns a new SRV record based on the Service. | ||||
| func (s *Service) NewSRV(name string, weight uint16) *dns.SRV { | ||||
| 	host := targetStrip(dns.Fqdn(s.Host), s.TargetStrip) | ||||
|  | ||||
| 	return &dns.SRV{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypeSRV, Class: dns.ClassINET, Ttl: s.Ttl}, | ||||
| 		Priority: uint16(s.Priority), Weight: weight, Port: uint16(s.Port), Target: host} | ||||
| } | ||||
|  | ||||
| // NewMX returns a new MX record based on the Service. | ||||
| func (s *Service) NewMX(name string) *dns.MX { | ||||
| 	host := targetStrip(dns.Fqdn(s.Host), s.TargetStrip) | ||||
|  | ||||
| 	return &dns.MX{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypeMX, Class: dns.ClassINET, Ttl: s.Ttl}, | ||||
| 		Preference: uint16(s.Priority), Mx: host} | ||||
| } | ||||
|  | ||||
| // NewA returns a new A record based on the Service. | ||||
| func (s *Service) NewA(name string, ip net.IP) *dns.A { | ||||
| 	return &dns.A{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypeA, Class: dns.ClassINET, Ttl: s.Ttl}, A: ip} | ||||
| } | ||||
|  | ||||
| // NewAAAA returns a new AAAA record based on the Service. | ||||
| func (s *Service) NewAAAA(name string, ip net.IP) *dns.AAAA { | ||||
| 	return &dns.AAAA{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypeAAAA, Class: dns.ClassINET, Ttl: s.Ttl}, AAAA: ip} | ||||
| } | ||||
|  | ||||
| // NewCNAME returns a new CNAME record based on the Service. | ||||
| func (s *Service) NewCNAME(name string, target string) *dns.CNAME { | ||||
| 	return &dns.CNAME{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypeCNAME, Class: dns.ClassINET, Ttl: s.Ttl}, Target: target} | ||||
| } | ||||
|  | ||||
| // NewNS returns a new NS record based on the Service. | ||||
| func (s *Service) NewNS(name string, target string) *dns.NS { | ||||
| 	return &dns.NS{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypeNS, Class: dns.ClassINET, Ttl: s.Ttl}, Ns: target} | ||||
| } | ||||
|  | ||||
| // NewTXT returns a new TXT record based on the Service. | ||||
| func (s *Service) NewTXT(name string) *dns.TXT { | ||||
| 	return &dns.TXT{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypeTXT, Class: dns.ClassINET, Ttl: s.Ttl}, Txt: split255(s.Text)} | ||||
| } | ||||
|  | ||||
| // NewPTR returns a new PTR record based on the Service. | ||||
| func (s *Service) NewPTR(name string, ttl uint32) *dns.PTR { | ||||
| 	return &dns.PTR{Hdr: dns.RR_Header{Name: name, Rrtype: dns.TypePTR, Class: dns.ClassINET, Ttl: ttl}, Ptr: dns.Fqdn(s.Host)} | ||||
| } | ||||
|  | ||||
| // As Path, but if a name contains wildcards (* or any), the name will be | ||||
| // chopped of before the (first) wildcard, and we do a highler evel search and | ||||
| // later find the matching names.  So service.*.skydns.local, will look for all | ||||
| // services under skydns.local and will later check for names that match | ||||
| // service.*.skydns.local.  If a wildcard is found the returned bool is true. | ||||
| func PathWithWildcard(s string) (string, bool) { | ||||
| 	l := dns.SplitDomainName(s) | ||||
| 	for i, j := 0, len(l)-1; i < j; i, j = i+1, j-1 { | ||||
| 		l[i], l[j] = l[j], l[i] | ||||
| 	} | ||||
| 	for i, k := range l { | ||||
| 		if k == "*" || k == "any" { | ||||
| 			return path.Join(append([]string{"/" + PathPrefix + "/"}, l[:i]...)...), true | ||||
| 		} | ||||
| 	} | ||||
| 	return path.Join(append([]string{"/" + PathPrefix + "/"}, l...)...), false | ||||
| } | ||||
|  | ||||
| // Path converts a domainname to an etcd path. If s looks like service.staging.skydns.local., | ||||
| // the resulting key will be /skydns/local/skydns/staging/service . | ||||
| func Path(s string) string { | ||||
| 	l := dns.SplitDomainName(s) | ||||
| 	for i, j := 0, len(l)-1; i < j; i, j = i+1, j-1 { | ||||
| 		l[i], l[j] = l[j], l[i] | ||||
| 	} | ||||
| 	return path.Join(append([]string{"/" + PathPrefix + "/"}, l...)...) | ||||
| } | ||||
|  | ||||
| // Domain is the opposite of Path. | ||||
| func Domain(s string) string { | ||||
| 	l := strings.Split(s, "/") | ||||
| 	// start with 1, to strip /skydns | ||||
| 	for i, j := 1, len(l)-1; i < j; i, j = i+1, j-1 { | ||||
| 		l[i], l[j] = l[j], l[i] | ||||
| 	} | ||||
| 	return dns.Fqdn(strings.Join(l[1:len(l)-1], ".")) | ||||
| } | ||||
|  | ||||
| // Group checks the services in sx, it looks for a Group attribute on the shortest | ||||
| // keys. If there are multiple shortest keys *and* the group attribute disagrees (and | ||||
| // is not empty), we don't consider it a group. | ||||
| // If a group is found, only services with *that* group (or no group) will be returned. | ||||
| func Group(sx []Service) []Service { | ||||
| 	if len(sx) == 0 { | ||||
| 		return sx | ||||
| 	} | ||||
|  | ||||
| 	// Shortest key with group attribute sets the group for this set. | ||||
| 	group := sx[0].Group | ||||
| 	slashes := strings.Count(sx[0].Key, "/") | ||||
| 	length := make([]int, len(sx)) | ||||
| 	for i, s := range sx { | ||||
| 		x := strings.Count(s.Key, "/") | ||||
| 		length[i] = x | ||||
| 		if x < slashes { | ||||
| 			if s.Group == "" { | ||||
| 				break | ||||
| 			} | ||||
| 			slashes = x | ||||
| 			group = s.Group | ||||
| 		} | ||||
| 	} | ||||
|  | ||||
| 	if group == "" { | ||||
| 		return sx | ||||
| 	} | ||||
|  | ||||
| 	ret := []Service{} // with slice-tricks in sx we can prolly save this allocation (TODO) | ||||
|  | ||||
| 	for i, s := range sx { | ||||
| 		if s.Group == "" { | ||||
| 			ret = append(ret, s) | ||||
| 			continue | ||||
| 		} | ||||
|  | ||||
| 		// Disagreement on the same level | ||||
| 		if length[i] == slashes && s.Group != group { | ||||
| 			return sx | ||||
| 		} | ||||
|  | ||||
| 		if s.Group == group { | ||||
| 			ret = append(ret, s) | ||||
| 		} | ||||
| 	} | ||||
| 	return ret | ||||
| } | ||||
|  | ||||
| // Split255 splits a string into 255 byte chunks. | ||||
| func split255(s string) []string { | ||||
| 	if len(s) < 255 { | ||||
| 		return []string{s} | ||||
| 	} | ||||
| 	sx := []string{} | ||||
| 	p, i := 0, 255 | ||||
| 	for { | ||||
| 		if i <= len(s) { | ||||
| 			sx = append(sx, s[p:i]) | ||||
| 		} else { | ||||
| 			sx = append(sx, s[p:]) | ||||
| 			break | ||||
|  | ||||
| 		} | ||||
| 		p, i = p+255, i+255 | ||||
| 	} | ||||
|  | ||||
| 	return sx | ||||
| } | ||||
|  | ||||
| // targetStrip strips "targetstrip" labels from the left side of the fully qualified name. | ||||
| func targetStrip(name string, targetStrip int) string { | ||||
| 	if targetStrip == 0 { | ||||
| 		return name | ||||
| 	} | ||||
|  | ||||
| 	offset, end := 0, false | ||||
| 	for i := 0; i < targetStrip; i++ { | ||||
| 		offset, end = dns.NextLabel(name, offset) | ||||
| 	} | ||||
| 	if end { | ||||
| 		// We overshot the name, use the orignal one. | ||||
| 		offset = 0 | ||||
| 	} | ||||
| 	name = name[offset:] | ||||
| 	return name | ||||
| } | ||||
							
								
								
									
										64
									
								
								middleware/etcd/singleflight/singleflight.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										64
									
								
								middleware/etcd/singleflight/singleflight.go
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,64 @@ | ||||
| /* | ||||
| Copyright 2012 Google Inc. | ||||
|  | ||||
| Licensed under the Apache License, Version 2.0 (the "License"); | ||||
| you may not use this file except in compliance with the License. | ||||
| You may obtain a copy of the License at | ||||
|  | ||||
|      http://www.apache.org/licenses/LICENSE-2.0 | ||||
|  | ||||
| Unless required by applicable law or agreed to in writing, software | ||||
| distributed under the License is distributed on an "AS IS" BASIS, | ||||
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||||
| See the License for the specific language governing permissions and | ||||
| limitations under the License. | ||||
| */ | ||||
|  | ||||
| // Package singleflight provides a duplicate function call suppression | ||||
| // mechanism. | ||||
| package singleflight | ||||
|  | ||||
| import "sync" | ||||
|  | ||||
| // call is an in-flight or completed Do call | ||||
| type call struct { | ||||
| 	wg  sync.WaitGroup | ||||
| 	val interface{} | ||||
| 	err error | ||||
| } | ||||
|  | ||||
| // Group represents a class of work and forms a namespace in which | ||||
| // units of work can be executed with duplicate suppression. | ||||
| type Group struct { | ||||
| 	mu sync.Mutex       // protects m | ||||
| 	m  map[string]*call // lazily initialized | ||||
| } | ||||
|  | ||||
| // Do executes and returns the results of the given function, making | ||||
| // sure that only one execution is in-flight for a given key at a | ||||
| // time. If a duplicate comes in, the duplicate caller waits for the | ||||
| // original to complete and receives the same results. | ||||
| func (g *Group) Do(key string, fn func() (interface{}, error)) (interface{}, error) { | ||||
| 	g.mu.Lock() | ||||
| 	if g.m == nil { | ||||
| 		g.m = make(map[string]*call) | ||||
| 	} | ||||
| 	if c, ok := g.m[key]; ok { | ||||
| 		g.mu.Unlock() | ||||
| 		c.wg.Wait() | ||||
| 		return c.val, c.err | ||||
| 	} | ||||
| 	c := new(call) | ||||
| 	c.wg.Add(1) | ||||
| 	g.m[key] = c | ||||
| 	g.mu.Unlock() | ||||
|  | ||||
| 	c.val, c.err = fn() | ||||
| 	c.wg.Done() | ||||
|  | ||||
| 	g.mu.Lock() | ||||
| 	delete(g.m, key) | ||||
| 	g.mu.Unlock() | ||||
|  | ||||
| 	return c.val, c.err | ||||
| } | ||||
		Reference in New Issue
	
	Block a user