This document shows how to download the gkeadm command-line tool and other
components that are part of Google Distributed Cloud.
Typically, gkeadm is the only component that you have to download manually.
For example, you do not need to manually download gkectl, or the
Google Distributed Cloud bundle file, because they are automatically copied
to the admin workstation. Also, you do not have to manually download the Admin
workstation Open Virtual Appliance (OVA), because gkeadm automatically copies
the OVA to your vSphere environment.
Before you begin
You must be logged in with a Google Account.
To see whether you are logged in, view your SDK account
property:
gcloud config get-value account
To log in:
gcloud auth login
Download gkeadm
You use the gkeadm command-line tool to create an admin workstation. Then you
get an SSH connection to your admin workstation, and from there, you create
clusters.
The gkeadm command-line tool is available for 64-bit Linux, Windows 10,
Windows Server 2019, and macOS 10.15 and higher.
1.12.7-gke.20
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.7-gke.20/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.7-gke.20/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.7-gke.20/darwin/gkeadm ./ chmod +x gkeadm
1.12.6-gke.35
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.6-gke.35/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.6-gke.35/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.6-gke.35/darwin/gkeadm ./ chmod +x gkeadm
1.12.5-gke.34
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.5-gke.34/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.5-gke.34/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.5-gke.34/darwin/gkeadm ./ chmod +x gkeadm
1.12.4-gke.42
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.4-gke.42/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.4-gke.42/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.4-gke.42/darwin/gkeadm ./ chmod +x gkeadm
1.12.3-gke.23
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.3-gke.23/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.3-gke.23/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.3-gke.23/darwin/gkeadm ./ chmod +x gkeadm
1.12.2-gke.21
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.2-gke.21/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.2-gke.21/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.2-gke.21/darwin/gkeadm ./ chmod +x gkeadm
1.12.1-gke.57
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.1-gke.57/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.1-gke.57/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.1-gke.57/darwin/gkeadm ./ chmod +x gkeadm
1.12.0-gke.446
Linux
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.0-gke.446/linux/gkeadm ./ chmod +x gkeadm
Windows
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.0-gke.446/windows/gkeadm.exe ./
macOS Catalina
gcloud storage cp gs://gke-on-prem-release/gkeadm/1.12.0-gke.446/darwin/gkeadm ./ chmod +x gkeadm
Google Distributed Cloud bundle
In certain cases, you might want to download an Google Distributed Cloud bundle to your admin workstation.
1.12.7-gke.20
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.7-gke.20/gke-onprem-vsphere-1.12.7-gke.20.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.7-gke.20.tgz
1.12.6-gke.35
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.6-gke.35/gke-onprem-vsphere-1.12.6-gke.35.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.6-gke.35.tgz
1.12.5-gke.34
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.5-gke.34/gke-onprem-vsphere-1.12.5-gke.34.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.5-gke.34.tgz
1.12.4-gke.42
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.4-gke.42/gke-onprem-vsphere-1.12.4-gke.42.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.4-gke.42.tgz
1.12.3-gke.23
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.3-gke.23/gke-onprem-vsphere-1.12.3-gke.23.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.3-gke.23.tgz
1.12.2-gke.21
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.2-gke.21/gke-onprem-vsphere-1.12.2-gke.21.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.2-gke.21.tgz
1.12.1-gke.57
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.1-gke.57/gke-onprem-vsphere-1.12.1-gke.57.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.1-gke.57.tgz
1.12.0-gke.446
On your admin workstation, run this command:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.12.0-gke.446/gke-onprem-vsphere-1.12.0-gke.446.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.12.0-gke.446.tgz
Admin workstation Open Virtual Appliance
In certain cases, you might want to download the admin workstation Open Virtual Appliance (OVA).
1.12.7-gke.20
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.7-gke.20/gke-on-prem-admin-appliance-vsphere-1.12.7-gke.20 ./
1.12.6-gke.35
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.6-gke.35/gke-on-prem-admin-appliance-vsphere-1.12.6-gke.35 ./
1.12.5-gke.34
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.5-gke.34/gke-on-prem-admin-appliance-vsphere-1.12.5-gke.34 ./
1.12.4-gke.42
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.4-gke.42/gke-on-prem-admin-appliance-vsphere-1.12.4-gke.42.ova ./
1.12.3-gke.23
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.3-gke.23/gke-on-prem-admin-appliance-vsphere-1.12.3-gke.23.ova ./
1.12.2-gke.21
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.2-gke.21/gke-on-prem-admin-appliance-vsphere-1.12.2-gke.21.ova ./
1.12.1-gke.57
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.1-gke.57/gke-on-prem-admin-appliance-vsphere-1.12.1-gke.57.ova ./
1.12.0-gke.446
To download the admin workstation OVA:
gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.12.0-gke.446/gke-on-prem-admin-appliance-vsphere-1.12.0-gke.446.ova ./
gkectl
Normally there is no reason for your to download the gkectl command-line
tool. In the rare case that you want to download gkectl, you can find it
here:
1.12.7-gke.20
gs://gke-on-prem-release/gkectl/1.12.7-gke.20/gkectl
1.12.6-gke.35
gs://gke-on-prem-release/gkectl/1.12.6-gke.35/gkectl
1.12.5-gke.34
gs://gke-on-prem-release/gkectl/1.12.5-gke.34/gkectl
1.12.4-gke.42
gs://gke-on-prem-release/gkectl/1.12.4-gke.42/gkectl
1.12.3-gke.23
gs://gke-on-prem-release/gkectl/1.12.3-gke.23/gkectl
1.12.2-gke.21
gs://gke-on-prem-release/gkectl/1.12.2-gke.21/gkectl
1.12.1-gke.57
gs://gke-on-prem-release/gkectl/1.12.1-gke.57/gkectl
1.12.0-gke.446
gs://gke-on-prem-release/gkectl/1.12.0-gke.446/gkectl
Verifying the OVA using openssl
You can use openssl to verify the OVA file you downloaded against a signature
file (SIG). Replace VERSION with the file's version:
openssl dgst -verify - -signature ~/gke-on-prem-admin-appliance-vsphere-VERSION.ova.1.sig ~/gke-on-prem-admin-appliance-vsphere-VERSION.ova <<'EOF' -----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw== -----END PUBLIC KEY----- EOF
The expected output of this command is Verified OK.
Verifying gkectl using openssl
You can use openssl to verify the gkectl binary against the public key.
Replace VERSION with the file's version:
gcloud storage cp gs://gke-on-prem-release/gkectl/VERSION/gkectl.1.sig /tmp/gkectl.1.sig openssl dgst -verify - -signature /tmp/gkectl.1.sig /usr/bin/gkectl <<'EOF' -----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw== -----END PUBLIC KEY----- EOF
The expected output of this command is Verified OK.
Verifying gkeadm using openssl
You can use openssl to verify the gkeadm binary against the public key.
Replace VERSION with the file's version:
gcloud storage cp gs://gke-on-prem-release/gkeadm/VERSION/gkeadm.1.sig /tmp/gkeadm.1.sig openssl dgst -verify - -signature /tmp/gkeadm.1.sig ./gkeadm <<'EOF' -----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw== -----END PUBLIC KEY----- EOF
The expected output of this command is Verified OK.