Using a Custom Cluster Domain

For Kubernetes clusters that use custom cluster domain, Linkerd must be installed using the --cluster-domain option:

  1. # first, install the Linkerd CRDs:
  2. linkerd install --crds | kubectl apply -f -
  4. # next, install the Linkerd control plane, using the custom cluster domain:
  5. linkerd install --cluster-domain=example.org \
  6.     --identity-trust-domain=example.org \
  7.     | kubectl apply -f -
  9. # The Linkerd Viz extension also requires a similar setting:
  10. linkerd viz install --set clusterDomain=example.org | kubectl apply -f -
  12. # And so does the Multicluster extension:
  13. 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.

Using a Custom Cluster Domain - 图1

Note

Note that the identity trust domain must match the cluster domain for mTLS to work.

Using a Custom Cluster Domain - 图2

Note

Changing the cluster domain while upgrading Linkerd isn’t supported.