hostutils

Documentation

Index

• Constants
• func BuildFederatedFQDN(serviceRef ezkube.ClusterResourceId, virtualMeshSpec *v1.VirtualMeshSpec) string
• func GetFederatedHostnameSuffix(virtualMeshSpec *v1.VirtualMeshSpec) string
• type ClusterDomainRegistry
  • func NewClusterDomainRegistry(clusters skv1alpha1sets.KubernetesClusterSet, ...) ClusterDomainRegistry

Constants

const (
	// this suffix is used as the default for federated fqdns; this is due to the
	// fact that istio Coredns comes with the *.global suffix already configured:
	// https://istio.io/latest/docs/setup/install/multicluster/gateways/
	DefaultHostnameSuffix = "global"
)

Functions

func BuildFederatedFQDN

func BuildFederatedFQDN(serviceRef ezkube.ClusterResourceId, virtualMeshSpec *v1.VirtualMeshSpec) string

Construct a federated FQDN for the given service, using the provided hostname suffix if provided, otherwise use default suffix.

func GetFederatedHostnameSuffix

func GetFederatedHostnameSuffix(virtualMeshSpec *v1.VirtualMeshSpec) string

Types

type ClusterDomainRegistry

type ClusterDomainRegistry interface {
	// get the domain suffix used by the cluster
	GetClusterDomain(clusterName string) string

	// get the local FQDN of a service in a given cluster.
	// this is the Kubernetes DNS name that clients within that cluster
	// can use to communicate to this cluster.
	GetLocalFQDN(serviceRef ezkube.ClusterResourceId) string

	// get the remote FQDN of a service in a given cluster.
	// this is the DNS name used by Gloo Mesh
	// to establish cross-cluster connectivity.
	GetFederatedFQDN(serviceRef ezkube.ClusterResourceId) string

	// get the FQDN of a service which is being addressed as a
	// destination, e.g. for a traffic split or mirror policy.
	// this will either be the Local or Remote FQDN, depending on the
	// originating cluster.
	GetDestinationFQDN(originatingCluster string, serviceRef ezkube.ClusterResourceId) string
}

ClusterDomainRegistry retrieves known cluster domain suffixes for registered clusters. Returns the default 'cluster.local' when domain cannot be found

func NewClusterDomainRegistry

func NewClusterDomainRegistry(
	clusters skv1alpha1sets.KubernetesClusterSet,
	destinations discoveryv1sets.DestinationSet,
) ClusterDomainRegistry