Using Custom Cluster Domain

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

  1. linkerd install --cluster-domain=example.org \
  2. --identity-trust-domain=example.org \
  3. | kubectl apply -f -

This ensures that all Linkerd handles all service discovery, routing, serviceprofiles and traffic split resources using the example.org domain.

NoteNote that the identity trust domain must match the cluster domain for mTLS towork.

NoteChanging the cluster domain while upgrading Linkerd isn't supported.