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

安装依赖工具并验证集群

本页面介绍如何准备环境和集群，以在 GKE 上安装集群内 Cloud Service Mesh。

安装所需的工具

您可以在 Cloud Shell 或运行 Linux 的本地机器上运行 asmcli。Cloud Shell 会预安装所有必需的工具。

如果您在本地运行 asmcli，请确保已安装以下工具：

Google Cloud CLI
标准命令行工具：awk、curl、grep、sed、tr
git
kubectl
jq
（可选，以便测试连接）netcat (nc)

配置 gcloud

即使您使用的是 Cloud Shell，仍请执行以下步骤。

使用 Google Cloud CLI 进行身份验证：
```
gcloud auth login --project PROJECT_ID
```
更新组件：
```
gcloud components update
```

配置 kubectl 以指向集群。

gcloud container clusters get-credentials CLUSTER_NAME \
     --location CLUSTER_LOCATION \
     --project PROJECT_ID

下载 asmcli

本部分介绍如何下载 asmcli。

将用于安装 Cloud Service Mesh 1.26.0 的版本下载到当前工作目录：

curl https://storage.googleapis.com/csm-artifacts/asm/asmcli_1.26 > asmcli

预期输出：

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                             Dload  Upload   Total   Spent    Left  Speed
100  167k  100  167k    0     0   701k      0 --:--:-- --:--:-- --:--:--  701k

让该脚本可执行：
```
chmod +x asmcli
```

授予集群管理员权限

确保您已将上下文设置为您的用户集群：

注意：如需检查现有上下文，请运行 kubectl config get-contexts。
```
kubectl config use-context CONTEXT
```
向您的用户账号（您的 Google Cloud 登录邮箱）授予集群管理员权限。您需要这些权限来创建 Cloud Service Mesh 所需的基于角色的访问控制 (RBAC) 规则：
```
kubectl create clusterrolebinding cluster-admin-binding \
  --clusterrole=cluster-admin \
  --user=USER_ACCOUNT
```

验证项目和集群

您可以运行 asmcli validate，确保项目和集群已按要求设置，以便安装 Cloud Service Mesh。使用此选项时，asmcli 不会更改您的项目或集群，也不会安装 Cloud Service Mesh。

asmcli 会验证以下内容：

您的环境拥有所需的工具。
集群符合最低要求。
您对指定项目拥有所需权限。
项目已启用所有必需的 Google API。

默认情况下，asmcli 会下载并解压缩安装文件，并将 GitHub 中的 asm 配置软件包下载到临时目录中。在退出之前，asmcli 会输出一条消息，提供临时目录的名称。我们建议您使用 --output_dir DIR_PATH 选项指定下载目录。--output_dir 选项可方便您使用 istioctl 命令行工具。您可能需要 istioctl 来排查配置问题或在专用 GKE 集群上设置多集群网格。另外，启用使用 asmcli 的可选功能的配置文件包含在 asm/istio/options 目录中。

运行以下命令以验证配置并将安装文件和 asm 软件包下载到 OUTPUT_DIR 目录。

./asmcli validate \
   --project_id PROJECT_ID \
   --cluster_name CLUSTER_NAME \
   --cluster_location CLUSTER_LOCATION \
   --fleet_id FLEET_PROJECT_ID \
   --output_dir DIR_PATH

--project_id、--cluster_name 和 --cluster_location 指定集群所在的项目 ID、集群名称以及集群区域或地区。
--fleet_id：舰队宿主项目的项目 ID。asmcli validate 检查集群是否已注册到指定的舰队。
--output_dir添加此选项可指定 asmcli 在其中下载 asm 软件包并提取安装文件的目录，其中包含 istioctl、示例和清单。否则，asmcli 会将文件下载到 tmp 目录。您可以指定相对路径或完整路径。环境变量 $PWD 不适用于此处。

成功后，asmcli 输出以下内容：

asmcli: Setting up necessary files...
asmcli: Using asm_kubeconfig as the kubeconfig...
asmcli: Checking installation tool dependencies...
asmcli: Fetching/writing GCP credentials to kubeconfig file...
asmcli: Verifying connectivity (10s)...
asmcli: kubeconfig set to asm_kubeconfig
asmcli: using context gke_example-project-12345_us-central1_cluster-2
asmcli: Getting account information...
asmcli: Downloading ASM..
asmcli: Downloading ASM kpt package...
fetching package "/asm" from "https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages" to "asm"
asmcli: Checking required APIs...
asmcli: Checking for project example-project-12345...
asmcli: Reading labels for us-central1/cluster-2...
asmcli: Checking for istio-system namespace...
asmcli: Confirming node pool requirements for example-project-12345/us-central1/cluster-2...
asmcli: Checking Istio installations...
asmcli: [WARNING]: There is no way to validate that the meshconfig API has been initialized.
asmcli: [WARNING]: This needs to happen once per GCP project. If the API has not been initialized
asmcli: [WARNING]: for example-project-12345, please re-run this tool with the --enable_gcp_components
asmcli: [WARNING]: flag. Otherwise, installation will succeed but Anthos Service Mesh
asmcli: [WARNING]: will not function correctly.
asmcli: Successfully validated all requirements to install ASM.

如果某一个测试未通过验证，asmcli 将输出错误消息。例如，如果您的项目未启用所有必需的 Google API，您会看到以下错误：

ERROR: One or more APIs are not enabled. Please enable them and retry, or run
`asmcli` with the '--enable_gcp_apis' flag to allow `asmcli` to enable them
on your behalf.

如果您收到错误消息，指出需要使用启用标志运行 asmcli，您可以采取以下措施：

在运行 asmcli 来执行实际安装时，添加错误消息中的特定标志或添加 --enable_all 标志。
如果您愿意，可以在运行 asmcli 之前自行更新项目和集群，如自行设置项目和 GKE 集群所述。

请注意，asmcli validate 不允许任何启用标志，因为它仅验证项目和集群已准备好进行安装。

检查集群安装和升级要求

在升级之前，您应检查配置是否与新版本的 Cloud Service Mesh 兼容。

切换到您在 --output_dir 中指定的目录。
运行以下命令以检查 Kubernetes 集群是否满足安装和升级要求。请确保使用与新版本 Cloud Service Mesh 一起分发的 istioctl 版本。
```
istioctl experimental precheck
```