Downloading the troubleshooting tool
This page shows you how to download the troubleshooting tool for Cloud Service Mesh. To debug and review your Cloud Service Mesh deployment you need to install the istioctl component for Google Cloud CLI.
Download istioctl
Managed control plane
Update Google Cloud CLI:
gcloud components update
Download the embedded Cloud Service Mesh troubleshooting tool:
gcloud components install istioctl
If you receive error message You cannot perform this action because the
Google Cloud CLI component manager is disabled for this installation
, you
have previously installed Google Cloud CLI through
Debian/Ubuntu. Use the
following commands instead:
Update Google Cloud CLI
sudo apt-get update
Download the embedded Cloud Service Mesh troubleshooting tool:
sudo apt-get install google-cloud-sdk-istioctl
In-cluster control plane
Linux
Download the Cloud Service Mesh installation file to your current working directory:
curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-linux-amd64.tar.gz
Download the signature file and use
openssl
to verify the signature:curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-linux-amd64.tar.gz.1.sig openssl dgst -verify /dev/stdin -signature istio-1.23.3-asm.1-linux-amd64.tar.gz.1.sig istio-1.23.3-asm.1-linux-amd64.tar.gz <<'EOF' -----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw== -----END PUBLIC KEY----- EOF
The expected output is:
Verified OK
.Extract the contents of the file to any location on your file system. For example, to extract the contents to the current working directory:
tar xzf istio-1.23.3-asm.1-linux-amd64.tar.gz
The command creates an installation directory in your current working directory named
istio-1.23.3-asm.1
that contains:- Sample applications in the `samples` directory. - The `istioctl` command-line tool that you use to install Cloud Service Mesh is in the <code>bin</code> directory. - The Cloud Service Mesh configuration profiles are in the `manifests/profiles` directory.
Ensure that you're in the Cloud Service Mesh installation's root directory.
cd istio-1.23.3-asm.1
Mac OS
Download the Cloud Service Mesh installation file to your current working directory:
curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-osx.tar.gz
Download the signature file and use
openssl
to verify the signature:curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-osx.tar.gz.1.sig openssl dgst -sha256 -verify /dev/stdin -signature istio-1.23.3-asm.1-osx.tar.gz.1.sig istio-1.23.3-asm.1-osx.tar.gz <<'EOF' -----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw== -----END PUBLIC KEY----- EOF
The expected output is:
Verified OK
.Extract the contents of the file to any location on your file system. For example, to extract the contents to the current working directory:
tar xzf istio-1.23.3-asm.1-osx.tar.gz
The command creates an installation directory in your current working directory named
istio-1.23.3-asm.1
that contains:- Sample applications in the `samples` directory. - The `istioctl` command-line tool that you use to install Cloud Service Mesh is in the <code>bin</code> directory. - The Cloud Service Mesh configuration profiles are in the `manifests/profiles` directory.
Ensure that you're in the Cloud Service Mesh installation's root directory.
cd istio-1.23.3-asm.1
Windows
Download the Cloud Service Mesh installation file to your current working directory:
curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-win.zip
Download the signature file and use
openssl
to verify the signature:curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-win.zip.1.sig openssl dgst -verify - -signature istio-1.23.3-asm.1-win.zip.1.sig istio-1.23.3-asm.1-win.zip <<'EOF' -----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw== -----END PUBLIC KEY----- EOF
The expected output is:
Verified OK
.Extract the contents of the file to any location on your file system. For example, to extract the contents to the current working directory:
tar xzf istio-1.23.3-asm.1-win.zip
The command creates an installation directory in your current working directory named
istio-1.23.3-asm.1
that contains:- Sample applications in the `samples` directory. - The `istioctl` command-line tool that you use to install Cloud Service Mesh is in the <code>bin</code> directory. - The Cloud Service Mesh configuration profiles are in the `manifests/profiles` directory.
Ensure that you're in the Cloud Service Mesh installation's root directory.
cd istio-1.23.3-asm.1