Cloud Service Mesh 和 Traffic Director 现已更名为 Cloud Service Mesh。如需了解详情，请参阅 Cloud Service Mesh 概览。

从集群内规范化服务控制器迁移到托管式规范化服务控制器

注意：Cloud Service Mesh 1.6.8 及更高版本会自动支持规范化服务。

本指南介绍了从集群内规范化服务控制器迁移到托管式规范化服务控制器的步骤。

集群内规范化服务控制器已弃用，将不再接收更新。虽然现有的集群内控制器部署将继续运行，但我们强烈建议您迁移到托管式规范化服务控制器，以确保与未来版本兼容、获得最新功能并继续获得支持。从 1.25 版开始，所有使用 asmcli 的 Cloud Service Mesh 安装都将使用托管式规范化服务控制器进行预配。

1. 启用 Cloud Service Mesh 舰队功能

托管式规范化服务控制器作为 Cloud Service Mesh 舰队功能的一部分安装，您可以使用以下命令启用该功能：

  gcloud container fleet mesh enable --project FLEET_PROJECT_ID

将 FLEET_PROJECT_ID 替换为您的舰队宿主项目的 ID。通常，FLEET_PROJECT_ID 的名称与项目名称相同。

请注意，如果您计划注册多个集群，则启用 Cloud Service Mesh 是在舰队级层进行的，因此您只需运行一次此命令。

向 Cloud Service Mesh 服务账号授予权限

如果集群的项目与舰队宿主项目不同，您必须允许舰队项目中的 Cloud Service Mesh 服务账号访问集群项目。

您只需为每个集群项目执行一次此操作。如果您之前为此集群项目和舰队项目的组合配置了托管式 Cloud Service Mesh，则这些更改已应用，您无需运行以下命令。

向舰队项目中的服务账号授予访问集群项目的权限：

  gcloud projects add-iam-policy-binding "CLUSTER_PROJECT_ID" \
    --member "serviceAccount:service-FLEET_PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \
    --role roles/anthosservicemesh.serviceAgent

将 CLUSTER_PROJECT_ID 替换为集群的项目 ID，将 FLEET_PROJECT_NUMBER 替换为舰队的项目编号。

如需确定舰队的项目编号，请参阅 Google Cloud 项目文档中的说明。

2. 停用集群内规范化服务控制器

托管式规范化服务控制器无法与集群内规范化服务控制器同时运行。因此，您必须停用集群内控制器。

检查集群内控制器：验证集群内规范化控制器是否存在。

kubectl get deployment canonical-service-controller-manager -n asm-system

删除集群内控制器：如果找到了部署，您可以通过运行以下命令来删除该部署（以及整个 asm-system 命名空间）：
```
kubectl delete namespace asm-system
```

3. 验证托管式规范化控制器可正常运行

托管式规范化服务控制器会在功能状态中报告其状态，因此您可以通过检查功能状态来确认安装是否正常运行：

检查功能状态：使用以下命令检索功能状态：

gcloud container fleet mesh describe --project FLEET_PROJECT_ID

验证状态：检查集群的状态，并验证 state.code 为 OK。
- 重要提示：状态最多可能需要 15 分钟才能转换为 OK。请稍加等待，然后重新运行该命令。
- 仅当 state.code 为 OK 时，才继续执行下一步。
- 如果 state.code 在 15 分钟后未变为 OK，请参阅解决托管式规范化服务控制器问题，获取问题排查指南。
输出示例：
```
membershipStates:
    projects/<project-number>/locations/<location>/memberships/<membership-name>:
      state:
        code: OK
        description:
          Revision(s) ready for use: istiod-asm-183-2.
```
检查托管式规范化控制器是否正常运行：通过部署注入边车的 Pod 来验证托管式规范化控制器正确运行，并检查该控制器是否自动创建相应的规范化服务。
1. 创建启用自动边车注入的命名空间：
```
kubectl create namespace NAMESPACE_NAME
```
  按照启用自动边车注入部分中的步骤，在新创建的命名空间中启用自动边车注入。
2. 创建一个名为 simple_pod.yaml 的 YAML 文件，其中包含以下内容：
```
    apiVersion: v1
    kind: Pod
    metadata:
      name: simple-pod
      labels:
        app: my-app
    spec:
      containers:
      - name: my-container
        image: nginx:latest
        ports:
        - containerPort: 80
```
  app 标签决定了规范化服务的名称。如需了解详情，请参阅定义规范化服务。
3. 使用以下命令部署 Pod。将 NAMESPACE_NAME 替换为启用自动边车注入的命名空间的名称。
```
kubectl apply -f simple_pod.yaml -n NAMESPACE_NAME
```
4. 确认 Pod 已创建：
```
kubectl get pods -n NAMESPACE_NAME
```
  输出示例：
```
NAME                             READY   STATUS    RESTARTS   AGE
simple-pod                       2/2     Running   0          9s
```
  Note：确认“READY”列显示 2/2。这表示主容器和边车代理均正确运行。如果您看到其他值，则表示命名空间可能未启用自动边车注入。
5. 验证规范化服务创建：运行以下命令以列出命名空间中的所有规范化服务。验证规范化服务 my-app 已创建：
```
kubectl get canonicalservices -n NAMESPACE_NAME
```
  输出示例：
```
  NAME          AGE
  my-app        3s
```
6. 清理：删除 Pod、规范化服务和命名空间：
```
kubectl delete -f simple_pod.yaml -n NAMESPACE_NAME
kubectl delete canonicalservices my-app -n NAMESPACE_NAME
kubectl delete namespace NAMESPACE_NAME
```
问题排查：
- 如果所需的规范化服务未成功创建，请参阅解决 Cloud Service Mesh 中的规范化服务问题。
- 如果问题仍然存在，您可以还原为集群内控制器。请参阅还原为集群内规范化服务控制器。

还原为集群内规范化服务控制器

如果您在使用托管式规范化服务控制器时遇到问题，可以使用以下命令重新安装集群内控制器：

  kubectl apply -f \
  https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-service-mesh-packages/release-1.25/asm/canonical-service/controller.yaml

后续步骤

了解：