README
¶
libdns-coredns
libdns-coredns is a libdns Go
library and comman d-line tool for interacting with a CoreDNS setup backed by
etcd.
This package implements the libdns interfaces for CoreDNS backed by etcd, allowing you to manage DNS records.
Installation
go get git.mills.io/prologic/libdns-coredns
usage
package main
import (
"context"
"git.mills.io/prologic/libdns-coredns"
)
func main() {
ctx := context.Background()
zone := "test."
// configure the DNS provider (choose any from github.com/libdns)
provider := coredns.Provider{
Endpoints: []string{"http://127.0.0.1:2379"},
PathPrefix: "/coredns",
}
// ...
}
See example for a full example.
License
libdns-coredns is licensed under the terms of the MIT License
Documentation
¶
Overview ¶
Package coredns implements a DNS record management client compatible with the libdns interfaces for CoreDNS backed by etcd.
Index ¶
- type Provider
- func (p *Provider) AppendRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)
- func (p *Provider) DeleteRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)
- func (p *Provider) GetRecords(ctx context.Context, zone string) ([]libdns.Record, error)
- func (p *Provider) SetRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Provider ¶
type Provider struct {
// Endpoints if a list of etcd endpoints to use
Endpoints []string `json:"endpoints,omitempty"`
// PathPrefix is the etcd path prefix used for records
PathPrefix string `json:"path_prefix,omitempty"`
// Debug - can set this to stdout or stderr to dump
// debugging information about the API interaction with
// powerdns. This will dump your auth token in plain text
// so be careful.
Debug string `json:"debug,omitempty"`
// contains filtered or unexported fields
}
Provider facilitates DNS record manipulation with CoreDNS backed by etcd.
func (*Provider) AppendRecords ¶
func (p *Provider) AppendRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)
AppendRecords adds records to the zone. It returns the records that were added.
func (*Provider) DeleteRecords ¶
func (p *Provider) DeleteRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)
DeleteRecords deletes the records from the zone. It returns the records that were deleted.
func (*Provider) GetRecords ¶
GetRecords lists all the records in the zone.
Source Files
Directories