lighthouse

README

lighthouse

Name

Lighthouse - DNS Discovery for services across clusters.

Description

Lighthouse plugin allows Cross Cluster Service Discovery between Kubernetes clusters connected by Submariner.

If the default Kubernetes plugin fails to resolve a DNS request, the lighthouse plugin will try to resolve it using the information it gathered from other clusters that have joined the submariner control plane. On a successful resolution, lighthouse plugin returns the cluster IP of the service in the remote cluster. Submariner ensures that this IP is reachable.

Syntax

Lighthouse requires kubernetes plugin to be present.

lighthouse

Examples

. {
    errors
    log
    kubernetes cluster.local {
      fallthrough
    }
    lighthouse
}

Documentation

Index

• Constants
• type ClusterStatus
• type EndpointsStatus
• type Lighthouse
  • func (lh *Lighthouse) Name() string
  • func (lh *Lighthouse) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)
• type LocalServices

Constants

const (
	Svc = "svc"
	Pod = "pod"
)

const PluginName = "lighthouse"

const (
	ServiceDiscoveryQueryCounterName = "submariner_service_discovery_query"
)

Types

type ClusterStatus

type ClusterStatus interface {
	IsConnected(clusterID string) bool
	LocalClusterID() string
}

type EndpointsStatus

type EndpointsStatus interface {
	IsHealthy(name, namespace, clusterID string) bool
}

type Lighthouse

type Lighthouse struct {
	Next            plugin.Handler
	Fall            fall.F
	Zones           []string
	TTL             uint32
	ServiceImports  *serviceimport.Map
	EndpointSlices  *endpointslice.Map
	ClusterStatus   ClusterStatus
	EndpointsStatus EndpointsStatus
	LocalServices   LocalServices
}

func (*Lighthouse) Name

func (lh *Lighthouse) Name() string

Name implements the Handler interface.

func (*Lighthouse) ServeDNS

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

ServeDNS implements the plugin.Handler interface.

type LocalServices

type LocalServices interface {
	GetIP(name, namespace string) (*serviceimport.DNSRecord, bool)
}