如果您安裝了代管 Cloud Service Mesh,則系統會預設安裝 Managed Canonical Service Controller。此外,所有使用 1.25 以上版本 asmcli 的集群內部 Cloud Service Mesh 安裝作業,都會透過代管的 Canonical Service 控制器佈建。
執行下列指令,確認您正在執行 Managed Canonical Service Controller:
projects/<your project number>/locations/<location>/memberships/<membership-name>:
code: OK
description: |-
Revision(s) ready for use: asm-managed.
All Canonical Services have been reconciled successfully.
servicemeshFeatureState: {}
updateTime: '2021-11-16T21:10:36.289467777Z'
如果說明指出 Managed Canonical Service Controller 會讓位給叢集內的控制器,請按照遷移指南操作。
projects/<your project number>/locations/<location>/memberships/<membership-name>:
code: OK
description: |-
Revision(s) ready for use: istiod-asm-173-6.
The Managed Canonical Service Controller is yielding to the in-cluster controller. See https://cloud.google.com/service-mesh/v1.25/docs/canonical-service-controller-enable-and-disable#disable-in-cluster-service-controller for instructions on removing the in-cluster controller.
servicemeshFeatureState: {}
updateTime: '2021-11-16T21:05:43.286828851Z'
lifecycleState: ENABLED
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[],[],null,["# Enabling and disabling the Canonical Service controller\n=======================================================\n\n\n**Note:** Canonical Services are supported automatically in Cloud Service Mesh version 1.6.8 and higher.\n\nThe Canonical Service controller groups workloads belonging to the same logical\nservice and is required for the full functionality of the Services dashboard\nin the Google Cloud console.\n\nAll managed Cloud Service Mesh installations and in-cluster installations\nwith asmcli from version 1.25 provisioned with the managed Canonical Service\ncontroller. The in-cluster Canonical Service Controller has been deprecated and\nwill no longer receive updates. While existing deployments of in-cluster\ncontroller will continue to operate, we strongly recommend migrating to the\nmanaged Canonical Service Controller to ensure compatibility with future\nreleases, access to the latest features, and continued support.\n\nTo determine if the in-cluster Canonical Service controller is enabled on your\ncluster: \n\n kubectl get services -n asm-system\n\nDisable the in-cluster Canonical Service controller\n---------------------------------------------------\n\nFor existing in-cluster controller deployments, you should migrate to the managed\nCanonical Service controller. Follow the\n[migration guide](/service-mesh/v1.25/docs/canonical-service-migrate-from-in-cluster-controller).\n\nEnable the Managed Canonical Service Controller\n-----------------------------------------------\n\nIf you installed managed Cloud Service Mesh, then the Managed Canonical\nService Controller was installed by default. Also, all the in-cluster\nCloud Service Mesh installations with asmcli from version 1.25 will be\nprovisioned with the managed Canonical Service controller.\n\nEnsure you are running the Managed Canonical Service Controller by running\nthe following command:\n\nReplace FLEET_PROJECT_ID with the ID of your Fleet Host project. Generally,\nthe FLEET_PROJECT_ID has the same name as the project. \n\n gcloud beta container hub mesh describe --project FLEET_PROJECT_ID\n\n1. If the description states that the Canonical Services are reconciled\n successfully, then Manged Canonical Service Controller is operating as\n expected. No further action is required.\n\n projects/\u003cyour project number\u003e/locations/\u003clocation\u003e/memberships/\u003cmembership-name\u003e:\n code: OK\n description: |-\n Revision(s) ready for use: asm-managed.\n All Canonical Services have been reconciled successfully.\n servicemeshFeatureState: {}\n updateTime: '2021-11-16T21:10:36.289467777Z'\n\n2. If the description states that Managed Canonical Service Controller is\n yielding to the in-cluster controller, follow the [migration guide](/service-mesh/v1.25/docs/canonical-service-migrate-from-in-cluster-controller).\n\n projects/\u003cyour project number\u003e/locations/\u003clocation\u003e/memberships/\u003cmembership-name\u003e:\n code: OK\n description: |-\n Revision(s) ready for use: istiod-asm-173-6.\n The Managed Canonical Service Controller is yielding to the in-cluster controller. See https://cloud.google.com/service-mesh/v1.25/docs/canonical-service-controller-enable-and-disable#disable-in-cluster-service-controller for instructions on removing the in-cluster controller.\n servicemeshFeatureState: {}\n updateTime: '2021-11-16T21:05:43.286828851Z'\n lifecycleState: ENABLED\n\n3. For any other issues, refer to [Resolve Managed Canonical Service Controller issues](/service-mesh/v1.25/docs/troubleshooting/troubleshoot-canonical-service#resolve-managed-canonical-controller-issues) for\n troubleshooting guidance.\n\nWhat's next\n-----------\n\nLearn about:\n\n- [Canonical Services](/service-mesh/v1.25/docs/canonical-service)\n- [Best practices in Canonical Services](/service-mesh/v1.25/docs/canonical-service-best-practices)\n- [Define a Canonical Service](/service-mesh/v1.25/docs/define-canonical-service)\n- [Resolving Canonical Service issues](/service-mesh/v1.25/docs/troubleshooting/troubleshoot-canonical-service)"]]