Enabling and disabling the Canonical Service controller

When you install or upgrade Anthos Service Mesh on GKE, you have the option to deploy the Canonical Service controller to your cluster. The Canonical Service controller groups workloads belonging to the same logical service, and it is required to unlock extra functionality in 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 it makes no changes to your services or workloads.

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:

  1. 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.6-asm
    
  2. Apply the controller configuration:

        kubectl apply -f asm/canonical-service/controller.yaml
    

If you want to disable the Canonical Service controller:

  1. 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.6-asm
    
  2. Delete the controller from your cluster:

        kubectl delete -f asm/canonical-service/controller.yaml