Note: Canonical Services are supported automatically in Anthos Service Mesh version 1.6.8 and higher.
When you install or upgrade Anthos Service Mesh using the
install_asm
script, it deploys
the
Canonical Service controller
to your cluster. The Canonical Service controller groups workloads belonging to
the same logical service, and it is required for the full functionality of
the Services dashboard in the Google Cloud console. Deploying the controller
creates the canonical-service-controller-manager
Deployment in your cluster in
the asm-system
namespace, and does not affect your services or workloads.
If you didn't use the install_asm
script to install Anthos Service Mesh, you
might not have the Canonical Service controller enabled on your cluster. To
determine if the Canonical Service controller is enabled on your cluster:
kubectl get services -n asm-system
If the Canonical Service controller isn't enabled, you can enable it with the following steps:
Download the
kpt
package that contains the controller to the current working directory:kpt pkg get https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.8-asm asm
Apply the controller configuration:
kubectl apply -f asm/canonical-service/controller.yaml
If you want to disable the Canonical Service controller:
Download the kpt package that contains the controller to the current working directory:
kpt pkg get https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.8-asm asm
Delete the controller from your cluster:
kubectl delete -f asm/canonical-service/controller.yaml
What's next
Learn about:
- Canonical Services
- Best practices in Canonical Services
- Defining a Canonical Service
- Resolving Canonical Service issues