Downloading the correct istioctl version

Cloud Service Mesh and istioctl versions

Your Cloud Service Mesh version must match the istioctl client version. Download the installation file to ensure that these versions match.

Downloading the installation file

The following commands download the installation file for the most recent version of Cloud Service Mesh 1.23.3. You can update the following commands with any supported version listed on the Versions page to download the installation file for a different version.

Linux

  1. 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
  2. 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.

  3. 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 bin directory.
    • The Cloud Service Mesh configuration profiles are in the manifests/profiles directory.
  4. Ensure that you're in the Cloud Service Mesh installation's root directory.

    cd istio-1.23.3-asm.1

Mac OS

  1. 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
  2. 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.

  3. 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 bin directory.
    • The Cloud Service Mesh configuration profiles are in the manifests/profiles directory.
  4. Ensure that you're in the Cloud Service Mesh installation's root directory.

    cd istio-1.23.3-asm.1

Windows

  1. 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
  2. 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.

  3. 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 bin directory.
    • The Cloud Service Mesh configuration profiles are in the manifests/profiles directory.
  4. Ensure that you're in the Cloud Service Mesh installation's root directory.

    cd istio-1.23.3-asm.1