Anthos clusters on VMware downloads

This document shows how to download the gkeadm command-line tool and other components that are part of Anthos clusters on VMware (GKE on-prem).

Typically, gkeadm is the only component that you have to download manually. For example, you do not need to manually download gkectl, or the Anthos clusters on VMware 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.10.5-gke.26

Linux

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.5-gke.26/linux/gkeadm ./
chmod +x gkeadm

Windows

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.5-gke.26/windows/gkeadm.exe ./

macOS Catalina

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.5-gke.26/darwin/gkeadm ./
chmod +x gkeadm

1.10.4-gke.32

Linux

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.4-gke.32/linux/gkeadm ./
chmod +x gkeadm

Windows

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.4-gke.32/windows/gkeadm.exe ./

macOS Catalina

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.4-gke.32/darwin/gkeadm ./
chmod +x gkeadm

1.10.3-gke.49

Linux

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.3-gke.49/linux/gkeadm ./
chmod +x gkeadm

Windows

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.3-gke.49/windows/gkeadm.exe ./

macOS Catalina

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.3-gke.49/darwin/gkeadm ./
chmod +x gkeadm

1.10.2-gke.34

Linux

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.2-gke.34/linux/gkeadm ./
chmod +x gkeadm

Windows

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.2-gke.34/windows/gkeadm.exe ./

macOS Catalina

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.2-gke.34/darwin/gkeadm ./
chmod +x gkeadm

1.10.1-gke.19

Linux

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.1-gke.19/linux/gkeadm ./
chmod +x gkeadm

Windows

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.1-gke.19/windows/gkeadm.exe ./

macOS Catalina

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.1-gke.19/darwin/gkeadm ./
chmod +x gkeadm

1.10.0-gke.194

Linux

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.0-gke.194/linux/gkeadm ./
chmod +x gkeadm

Windows

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.0-gke.194/windows/gkeadm.exe ./

macOS Catalina

gsutil cp gs://gke-on-prem-release/gkeadm/1.10.0-gke.194/darwin/gkeadm ./
chmod +x gkeadm

Anthos clusters on VMware bundle

In certain cases, you might want to download an Anthos clusters on VMware bundle to your admin workstation.

1.10.5-gke.26

On your admin workstation, run this command:

gsutil cp gs://gke-on-prem-release/gke-onprem-bundle/1.10.5-gke.26/gke-onprem-vsphere-1.10.5-gke.26.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.10.5-gke.26.tgz

1.10.4-gke.32

On your admin workstation, run this command:

gsutil cp gs://gke-on-prem-release/gke-onprem-bundle/1.10.4-gke.32/gke-onprem-vsphere-1.10.4-gke.32.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.10.4-gke.32.tgz

1.10.3-gke.49

On your admin workstation, run this command:

gsutil cp gs://gke-on-prem-release/gke-onprem-bundle/1.10.3-gke.49/gke-onprem-vsphere-1.10.3-gke.49.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.10.3-gke.49.tgz

1.10.2-gke.34

On your admin workstation, run this command:

gsutil cp gs://gke-on-prem-release/gke-onprem-bundle/1.10.2-gke.34/gke-onprem-vsphere-1.10.2-gke.34.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.10.2-gke.34.tgz

1.10.1-gke.19

On your admin workstation, run this command:

gsutil cp gs://gke-on-prem-release/gke-onprem-bundle/1.10.1-gke.19/gke-onprem-vsphere-1.10.1-gke.19.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.10.1-gke.19.tgz

1.10.0-gke.194

On your admin workstation, run this command:

gsutil cp gs://gke-on-prem-release/gke-onprem-bundle/1.10.0-gke.194/gke-onprem-vsphere-1.10.0-gke.194.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.10.0-gke.194.tgz

Admin workstation Open Virtual Appliance

In certain cases, you might want to download the admin workstation Open Virtual Appliance (OVA).

1.10.5-gke.26

To download the admin workstation OVA:

gsutil cp gs://gke-on-prem-release/admin-appliance/1.10.5-gke.26/gke-on-prem-admin-appliance-vsphere-1.10.5-gke.26.ova ./

1.10.4-gke.32

To download the admin workstation OVA:

gsutil cp gs://gke-on-prem-release/admin-appliance/1.10.4-gke.32/gke-on-prem-admin-appliance-vsphere-1.10.4-gke.32.ova ./

1.10.3-gke.49

To download the admin workstation OVA:

gsutil cp gs://gke-on-prem-release/admin-appliance/1.10.3-gke.49/gke-on-prem-admin-appliance-vsphere-1.10.3-gke.49.ova ./

1.10.2-gke.34

To download the admin workstation OVA:

gsutil cp gs://gke-on-prem-release/admin-appliance/1.10.2-gke.34/gke-on-prem-admin-appliance-vsphere-1.10.2-gke.34.ova ./

1.10.1-gke.19

To download the admin workstation OVA:

gsutil cp gs://gke-on-prem-release/admin-appliance/1.10.1-gke.19/gke-on-prem-admin-appliance-vsphere-1.10.1-gke.19.ova ./

1.10.0-gke.194

To download the admin workstation OVA:

gsutil cp gs://gke-on-prem-release/admin-appliance/1.10.0-gke.194/gke-on-prem-admin-appliance-vsphere-1.10.0-gke.194.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.10.5-gke.26

gs://gke-on-prem-release/gkectl/1.10.5-gke.26/gkectl

1.10.4-gke.32

gs://gke-on-prem-release/gkectl/1.10.4-gke.32/gkectl

1.10.3-gke.49

gs://gke-on-prem-release/gkectl/1.10.3-gke.49/gkectl

1.10.2-gke.34

gs://gke-on-prem-release/gkectl/1.10.2-gke.34/gkectl

1.10.1-gke.19

gs://gke-on-prem-release/gkectl/1.10.1-gke.19/gkectl

1.10.0-gke.194

gs://gke-on-prem-release/gkectl/1.10.0-gke.194/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:

gsutil 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.