Documentation ¶
Index ¶
- Constants
- Variables
- type AWSProvider
- func (p *AWSProvider) ApplyChanges(changes *plan.Changes) error
- func (p *AWSProvider) CreateRecords(endpoints []*endpoint.Endpoint) error
- func (p *AWSProvider) DeleteRecords(endpoints []*endpoint.Endpoint) error
- func (p *AWSProvider) Records() (endpoints []*endpoint.Endpoint, _ error)
- func (p *AWSProvider) UpdateRecords(endpoints, _ []*endpoint.Endpoint) error
- func (p *AWSProvider) Zones() (map[string]*route53.HostedZone, error)
- type AzureProvider
- type CloudFlareProvider
- type DigitalOceanChange
- type DigitalOceanProvider
- type DomainFilter
- type GoogleProvider
- func (p *GoogleProvider) ApplyChanges(changes *plan.Changes) error
- func (p *GoogleProvider) CreateRecords(endpoints []*endpoint.Endpoint) error
- func (p *GoogleProvider) DeleteRecords(endpoints []*endpoint.Endpoint) error
- func (p *GoogleProvider) Records() (endpoints []*endpoint.Endpoint, _ error)
- func (p *GoogleProvider) UpdateRecords(records, oldRecords []*endpoint.Endpoint) error
- func (p *GoogleProvider) Zones() (map[string]*dns.ManagedZone, error)
- type InMemoryOption
- type InMemoryProvider
- type InfobloxConfig
- type InfobloxProvider
- type Provider
- type RecordsClient
- type Route53API
- type ZoneTypeFilter
- type ZonesClient
Constants ¶
const ( // DigitalOceanCreate is a ChangeAction enum value DigitalOceanCreate = "CREATE" // DigitalOceanDelete is a ChangeAction enum value DigitalOceanDelete = "DELETE" // DigitalOceanUpdate is a ChangeAction enum value DigitalOceanUpdate = "UPDATE" )
Variables ¶
var ( // ErrZoneAlreadyExists error returned when zone cannot be created when it already exists ErrZoneAlreadyExists = errors.New("specified zone already exists") // ErrZoneNotFound error returned when specified zone does not exists ErrZoneNotFound = errors.New("specified zone not found") // ErrRecordAlreadyExists when create request is sent but record already exists ErrRecordAlreadyExists = errors.New("record already exists") // ErrRecordNotFound when update/delete request is sent but record not found ErrRecordNotFound = errors.New("record not found") // ErrDuplicateRecordFound when record is repeated in create/update/delete ErrDuplicateRecordFound = errors.New("invalid batch request") )
Functions ¶
This section is empty.
Types ¶
type AWSProvider ¶
type AWSProvider struct {
// contains filtered or unexported fields
}
AWSProvider is an implementation of Provider for AWS Route53.
func NewAWSProvider ¶
func NewAWSProvider(domainFilter DomainFilter, zoneTypeFilter ZoneTypeFilter, dryRun bool) (*AWSProvider, error)
NewAWSProvider initializes a new AWS Route53 based Provider.
func (*AWSProvider) ApplyChanges ¶
func (p *AWSProvider) ApplyChanges(changes *plan.Changes) error
ApplyChanges applies a given set of changes in a given zone.
func (*AWSProvider) CreateRecords ¶
func (p *AWSProvider) CreateRecords(endpoints []*endpoint.Endpoint) error
CreateRecords creates a given set of DNS records in the given hosted zone.
func (*AWSProvider) DeleteRecords ¶
func (p *AWSProvider) DeleteRecords(endpoints []*endpoint.Endpoint) error
DeleteRecords deletes a given set of DNS records in a given zone.
func (*AWSProvider) Records ¶
func (p *AWSProvider) Records() (endpoints []*endpoint.Endpoint, _ error)
Records returns the list of records in a given hosted zone.
func (*AWSProvider) UpdateRecords ¶
func (p *AWSProvider) UpdateRecords(endpoints, _ []*endpoint.Endpoint) error
UpdateRecords updates a given set of old records to a new set of records in a given hosted zone.
func (*AWSProvider) Zones ¶
func (p *AWSProvider) Zones() (map[string]*route53.HostedZone, error)
Zones returns the list of hosted zones.
type AzureProvider ¶ added in v0.4.0
type AzureProvider struct {
// contains filtered or unexported fields
}
AzureProvider implements the DNS provider for Microsoft's Azure cloud platform.
func NewAzureProvider ¶ added in v0.4.0
func NewAzureProvider(configFile string, domainFilter DomainFilter, resourceGroup string, dryRun bool) (*AzureProvider, error)
NewAzureProvider creates a new Azure provider.
Returns the provider or an error if a provider could not be created.
func (*AzureProvider) ApplyChanges ¶ added in v0.4.0
func (p *AzureProvider) ApplyChanges(changes *plan.Changes) error
ApplyChanges applies the given changes.
Returns nil if the operation was successful or an error if the operation failed.
type CloudFlareProvider ¶ added in v0.4.0
type CloudFlareProvider struct { Client cloudFlareDNS DryRun bool // contains filtered or unexported fields }
CloudFlareProvider is an implementation of Provider for CloudFlare DNS.
func NewCloudFlareProvider ¶ added in v0.4.0
func NewCloudFlareProvider(domainFilter DomainFilter, proxied bool, dryRun bool) (*CloudFlareProvider, error)
NewCloudFlareProvider initializes a new CloudFlare DNS based Provider.
func (*CloudFlareProvider) ApplyChanges ¶ added in v0.4.0
func (p *CloudFlareProvider) ApplyChanges(changes *plan.Changes) error
ApplyChanges applies a given set of changes in a given zone.
func (*CloudFlareProvider) Records ¶ added in v0.4.0
func (p *CloudFlareProvider) Records() ([]*endpoint.Endpoint, error)
Records returns the list of records.
func (*CloudFlareProvider) Zones ¶ added in v0.4.0
func (p *CloudFlareProvider) Zones() ([]cloudflare.Zone, error)
Zones returns the list of hosted zones.
type DigitalOceanChange ¶ added in v0.4.0
type DigitalOceanChange struct { Action string ResourceRecordSet godo.DomainRecord }
DigitalOceanChange differentiates between ChangActions
type DigitalOceanProvider ¶ added in v0.4.0
type DigitalOceanProvider struct { Client godo.DomainsService DryRun bool // contains filtered or unexported fields }
DigitalOceanProvider is an implementation of Provider for Digital Ocean's DNS.
func NewDigitalOceanProvider ¶ added in v0.4.0
func NewDigitalOceanProvider(domainFilter DomainFilter, dryRun bool) (*DigitalOceanProvider, error)
NewDigitalOceanProvider initializes a new DigitalOcean DNS based Provider.
func (*DigitalOceanProvider) ApplyChanges ¶ added in v0.4.0
func (p *DigitalOceanProvider) ApplyChanges(changes *plan.Changes) error
ApplyChanges applies a given set of changes in a given zone.
type DomainFilter ¶ added in v0.4.0
type DomainFilter struct {
// contains filtered or unexported fields
}
DomainFilter holds a lists of valid domain names
func NewDomainFilter ¶ added in v0.4.0
func NewDomainFilter(domainFilters []string) DomainFilter
NewDomainFilter returns a new DomainFilter given a comma separated list of domains
func (DomainFilter) Match ¶ added in v0.4.0
func (df DomainFilter) Match(domain string) bool
Match checks whether a domain can be found in the DomainFilter.
type GoogleProvider ¶ added in v0.4.0
type GoogleProvider struct {
// contains filtered or unexported fields
}
GoogleProvider is an implementation of Provider for Google CloudDNS.
func NewGoogleProvider ¶
func NewGoogleProvider(project string, domainFilter DomainFilter, dryRun bool) (*GoogleProvider, error)
NewGoogleProvider initializes a new Google CloudDNS based Provider.
func (*GoogleProvider) ApplyChanges ¶ added in v0.4.0
func (p *GoogleProvider) ApplyChanges(changes *plan.Changes) error
ApplyChanges applies a given set of changes in a given zone.
func (*GoogleProvider) CreateRecords ¶ added in v0.4.0
func (p *GoogleProvider) CreateRecords(endpoints []*endpoint.Endpoint) error
CreateRecords creates a given set of DNS records in the given hosted zone.
func (*GoogleProvider) DeleteRecords ¶ added in v0.4.0
func (p *GoogleProvider) DeleteRecords(endpoints []*endpoint.Endpoint) error
DeleteRecords deletes a given set of DNS records in a given zone.
func (*GoogleProvider) Records ¶ added in v0.4.0
func (p *GoogleProvider) Records() (endpoints []*endpoint.Endpoint, _ error)
Records returns the list of records in all relevant zones.
func (*GoogleProvider) UpdateRecords ¶ added in v0.4.0
func (p *GoogleProvider) UpdateRecords(records, oldRecords []*endpoint.Endpoint) error
UpdateRecords updates a given set of old records to a new set of records in a given hosted zone.
func (*GoogleProvider) Zones ¶ added in v0.4.0
func (p *GoogleProvider) Zones() (map[string]*dns.ManagedZone, error)
Zones returns the list of hosted zones.
type InMemoryOption ¶ added in v0.4.0
type InMemoryOption func(*InMemoryProvider)
InMemoryOption allows to extend in-memory provider
func InMemoryWithDomain ¶ added in v0.4.0
func InMemoryWithDomain(domainFilter DomainFilter) InMemoryOption
InMemoryWithDomain modifies the domain on which dns zones are filtered
func InMemoryWithLogging ¶ added in v0.4.0
func InMemoryWithLogging() InMemoryOption
InMemoryWithLogging injects logging when ApplyChanges is called
type InMemoryProvider ¶
type InMemoryProvider struct { OnApplyChanges func(changes *plan.Changes) OnRecords func() // contains filtered or unexported fields }
InMemoryProvider - dns provider only used for testing purposes initialized as dns provider with no records
func NewInMemoryProvider ¶
func NewInMemoryProvider(opts ...InMemoryOption) *InMemoryProvider
NewInMemoryProvider returns InMemoryProvider DNS provider interface implementation
func (*InMemoryProvider) ApplyChanges ¶
func (im *InMemoryProvider) ApplyChanges(changes *plan.Changes) error
ApplyChanges simply modifies records in memory error checking occurs before any modifications are made, i.e. batch processing create record - record should not exist update/delete record - record should exist create/update/delete lists should not have overlapping records
func (*InMemoryProvider) CreateZone ¶
func (im *InMemoryProvider) CreateZone(newZone string) error
CreateZone adds new zone if not present
func (*InMemoryProvider) Records ¶
func (im *InMemoryProvider) Records() ([]*endpoint.Endpoint, error)
Records returns the list of endpoints
func (*InMemoryProvider) Zones ¶ added in v0.4.0
func (im *InMemoryProvider) Zones() map[string]string
Zones returns filtered zones as specified by domain
type InfobloxConfig ¶ added in v0.4.6
type InfobloxConfig struct { DomainFilter DomainFilter Host string Port int Username string Password string Version string SSLVerify bool DryRun bool }
InfobloxConfig clarifies the method signature
type InfobloxProvider ¶ added in v0.4.6
type InfobloxProvider struct {
// contains filtered or unexported fields
}
InfobloxProvider implements the DNS provider for Infoblox.
func NewInfobloxProvider ¶ added in v0.4.6
func NewInfobloxProvider(infobloxConfig InfobloxConfig) (*InfobloxProvider, error)
NewInfobloxProvider creates a new Infoblox provider.
func (*InfobloxProvider) ApplyChanges ¶ added in v0.4.6
func (p *InfobloxProvider) ApplyChanges(changes *plan.Changes) error
ApplyChanges applies the given changes.
type Provider ¶
type Provider interface { Records() ([]*endpoint.Endpoint, error) ApplyChanges(changes *plan.Changes) error }
Provider defines the interface DNS providers should implement.
func NewDnsimpleProvider ¶ added in v0.4.6
func NewDnsimpleProvider(domainFilter DomainFilter, dryRun bool) (Provider, error)
NewDnsimpleProvider initializes a new Dnsimple based provider
type RecordsClient ¶ added in v0.4.0
type RecordsClient interface { ListByDNSZone(resourceGroupName string, zoneName string, top *int32) (result dns.RecordSetListResult, err error) ListByDNSZoneNextResults(list dns.RecordSetListResult) (result dns.RecordSetListResult, err error) Delete(resourceGroupName string, zoneName string, relativeRecordSetName string, recordType dns.RecordType, ifMatch string) (result autorest.Response, err error) CreateOrUpdate(resourceGroupName string, zoneName string, relativeRecordSetName string, recordType dns.RecordType, parameters dns.RecordSet, ifMatch string, ifNoneMatch string) (result dns.RecordSet, err error) }
RecordsClient is an interface of dns.RecordClient that can be stubbed for testing.
type Route53API ¶
type Route53API interface { ListResourceRecordSetsPages(input *route53.ListResourceRecordSetsInput, fn func(resp *route53.ListResourceRecordSetsOutput, lastPage bool) (shouldContinue bool)) error ChangeResourceRecordSets(*route53.ChangeResourceRecordSetsInput) (*route53.ChangeResourceRecordSetsOutput, error) CreateHostedZone(*route53.CreateHostedZoneInput) (*route53.CreateHostedZoneOutput, error) ListHostedZonesPages(input *route53.ListHostedZonesInput, fn func(resp *route53.ListHostedZonesOutput, lastPage bool) (shouldContinue bool)) error }
Route53API is the subset of the AWS Route53 API that we actually use. Add methods as required. Signatures must match exactly. mostly taken from: https://github.com/kubernetes/kubernetes/blob/853167624edb6bc0cfdcdfb88e746e178f5db36c/federation/pkg/dnsprovider/providers/aws/route53/stubs/route53api.go
type ZoneTypeFilter ¶ added in v0.4.5
type ZoneTypeFilter struct {
// contains filtered or unexported fields
}
ZoneTypeFilter holds a zone type to filter for.
func NewZoneTypeFilter ¶ added in v0.4.5
func NewZoneTypeFilter(zoneType string) ZoneTypeFilter
NewZoneTypeFilter returns a new ZoneTypeFilter given a zone type to filter for.
func (ZoneTypeFilter) Match ¶ added in v0.4.5
func (f ZoneTypeFilter) Match(zone *route53.HostedZone) bool
Match checks whether a zone matches the zone type that's filtered for.
type ZonesClient ¶ added in v0.4.0
type ZonesClient interface { ListByResourceGroup(resourceGroupName string, top *int32) (result dns.ZoneListResult, err error) ListByResourceGroupNextResults(lastResults dns.ZoneListResult) (result dns.ZoneListResult, err error) }
ZonesClient is an interface of dns.ZoneClient that can be stubbed for testing.