本页面介绍了如何下载 Cloud Service Mesh 的问题排查工具。如需调试和查看 Cloud Service Mesh 部署，您需要为 Google Cloud CLI 安装 istioctl 组件。
下载 istioctl
代管式控制平面
更新 Google Cloud CLI：
gcloudcomponentsupdate
下载嵌入式 Cloud Service Mesh 问题排查工具：
gcloudcomponentsinstallistioctl
如果您收到错误消息 You cannot perform this action because the
Google Cloud CLI component manager is disabled for this installation，则表示您之前已通过 Debian/Ubuntu 安装了 Google Cloud CLI。请改用以下命令：
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-19。"],[],[],null,["# Downloading the troubleshooting tool\n====================================\n\nThis page shows you how to download the troubleshooting tool for\nCloud Service Mesh. To debug and review your Cloud Service Mesh deployment\nyou need to install the istioctl component for Google Cloud CLI.\n\nDownload istioctl\n-----------------\n\n### Managed control plane\n\n1. Update Google Cloud CLI:\n\n gcloud components update\n\n2. Download the embedded Cloud Service Mesh troubleshooting tool:\n\n gcloud components install istioctl\n\nIf you receive error message `You cannot perform this action because the\nGoogle Cloud CLI component manager is disabled for this installation`, you\nhave previously installed Google Cloud CLI through\n[Debian/Ubuntu](https://cloud.google.com/sdk/docs/install#deb). Use the\nfollowing commands instead:\n\n1. Update Google Cloud CLI\n\n sudo apt-get update\n\n2. Download the embedded Cloud Service Mesh troubleshooting tool:\n\n sudo apt-get install google-cloud-sdk-istioctl\n\n### In-cluster control plane\n\n### Linux\n\n1. Download the Cloud Service Mesh installation file to your current working directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-linux-amd64.tar.gz\n ```\n2. Download the signature file and use `openssl` to verify the\n signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-linux-amd64.tar.gz.1.sig\n openssl dgst -verify /dev/stdin -signature istio-1.26.0-asm.11-linux-amd64.tar.gz.1.sig istio-1.26.0-asm.11-linux-amd64.tar.gz \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.0-asm.11-linux-amd64.tar.gz\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.0-asm.11` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.0-asm.11\n ```\n\n### Mac OS\n\n1. Download the Cloud Service Mesh installation file to your current working\n directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-osx.tar.gz\n ```\n2. Download the signature file and use `openssl` to verify the signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-osx.tar.gz.1.sig\n openssl dgst -sha256 -verify /dev/stdin -signature istio-1.26.0-asm.11-osx.tar.gz.1.sig istio-1.26.0-asm.11-osx.tar.gz \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.0-asm.11-osx.tar.gz\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.0-asm.11` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.0-asm.11\n ```\n\n### Windows\n\n1. Download the Cloud Service Mesh installation file to your current working\n directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-win.zip\n ```\n2. Download the signature file and use `openssl` to verify the signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-win.zip.1.sig\n openssl dgst -verify - -signature istio-1.26.0-asm.11-win.zip.1.sig istio-1.26.0-asm.11-win.zip \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.0-asm.11-win.zip\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.0-asm.11` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.0-asm.11\n ```\n\nWhat's next\n-----------\n\n- [Troubleshoot Cloud Service Mesh step-by-step](/service-mesh/docs/troubleshooting/troubleshoot-intro)"]]
