Download gkeadm

This document shows how to download the gkeadm command-line tool that you use to create an admin workstation for GKE on VMware.

Typically, gkeadm is the only component that you have to download manually. In some cases, you might want to manually downolad one or more of these other components:

  • Admin workstation Open Virtual Appliance (OVA)
  • GKE on VMware bundle
  • gkectl command-line tool

For more information, see Downloads.

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

gkeadm is also available for macOS 10.15 and higher, Windows 10, and Windows Server 2019. However, support for macOS and Windows is deprecated and will be removed in a future release.

Linux

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

Windows

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

macOS Catalina

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

Replace VERSION with the version of GKE on VMware you want to install or upgrade your clusters to. The latest available patch version is 1.28.300-gke.123. For a list of available versions, see Version history.

Verify gkeadm using openssl

You can use openssl to verify the gkeadm binary against the public key.

gsutil cp gs://gke-on-prem-release/gkeadm/VERSION/linux/gkeadm.1.sig /tmp/gkeadm.1.sig
echo "-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----" > key.pem
openssl dgst -verify key.pem -signature /tmp/gkeadm.1.sig ./gkeadm

The expected output of this command is Verified OK.