Using a Custom Cluster Domain
For Kubernetes clusters that use custom cluster domain, Linkerd must be installed using the --cluster-domain
option:
linkerd install --cluster-domain=example.org \
--identity-trust-domain=example.org \
| kubectl apply -f -
# The Linkerd Viz extension also requires a similar setting:
linkerd viz install --set clusterDomain=example.org | kubectl apply -f -
# And so does the Multicluster extension:
linkerd multicluster install --set identityTrustDomain=example.org | kubectl apply -f -
This ensures that all Linkerd handles all service discovery, routing, service profiles and traffic split resources using the example.org
domain.
Note
Note that the identity trust domain must match the cluster domain for mTLS to work.
Note
Changing the cluster domain while upgrading Linkerd isn’t supported.