GKE on-prem downloads

This topic provides commands to download the following GKE on-prem entities:

• gkectl command line tool
• upgrade bundle
• admin workstation Open Virtual Appliance (OVA).

See also:

• GKE on-prem overview
• System requirements

Before you begin

1. Check that you have already purchased GKE Enterprise, allowlisted your project and a Google Cloud service account, and created an admin workstation VM in vSphere. To get started with installing GKE on-prem, see Installing GKE on-prem.

2. SSH in to your admin workstation. (If you are installing or upgrading your admin workstation, skip this step.)

   ssh -i ~/.ssh/vsphere_workstation ubuntu@[IP_ADDRESS]
   

3. Log in to Google Cloud using your Google Cloud user account credentials. The user account must hold at least the Viewer IAM role in the Google Cloud projects referenced in the GKE on-prem configuration file:

   gcloud auth login

4. Create a private key for your allowlisted service account.

   Copy the service account's email address:

   gcloud iam service-accounts list

   Create the service account's private key, where [KEY_FILE] is a name you choose for the file. This command saves the file to the current working directory:

   gcloud iam service-accounts keys create key.json \
   --project [PROJECT_ID] --iam-account [ALLOWLISTED_SERVICE_ACCOUNT_EMAIL]
   

   where:

   • [PROJECT_ID] is your project ID.
   • [KEY_FILE] is a name and path in which to save the service account's private key such as /home/ubuntu/key.json.
   • [ALLOWLISTED_SERVICE_ACCOUNT_EMAIL] is the allowlisted service account's email address.

5. Activate your allowlisted service account:

   gcloud auth activate-service-account --project [PROJECT_ID] \
   --key-file [KEY_FILE]
   

1.2.2-gke.2 (latest)

gkeadm

From your personal laptop or workstation, run one of the following commands to download the gkeadm command-line tool and make it executable:

• Linux:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.2.2-gke.2/linux/gkeadm ./
  chmod +x gkeadm

• Windows:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.2.2-gke.2/windows/gkeadm.exe ./ 

• macOS Catalina:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.2.2-gke.2/darwin/gkeadm ./ chmod +x gkeadm

Note: If you run this Linux, Windows, or macOS command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.2-gke.2/gke-on-prem-admin-appliance-vsphere-1.2.2-gke.2.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.2-gke.2/gke-on-prem-admin-appliance-vsphere-1.2.2-gke.2.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.2.2-gke.2/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.2.2-gke.2/gke-onprem-vsphere-1.2.2-gke.2.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.2.2-gke.2.tgz

1.5.0-gke.27

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

• Linux:

  gcloud storage cp gs://gke-on-prem-release-public/gkeadm/1.5.0-gke.27/linux/gkeadm ./
  chmod +x gkeadm

• Windows:

  gcloud storage cp gs://gke-on-prem-release-public/gkeadm/1.5.0-gke.27/windows/gkeadm.exe ./ 

• macOS:

  gcloud storage cp gs://gke-on-prem-release-public/gkeadm/1.5.0-gke.27/darwin/gkeadm ./
  chmod +x gkeadm

Note: If you run this Linux, Windows, or macOS command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.5.0-gke.27/gke-on-prem-admin-appliance-vsphere-1.5.0-gke.27.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.5.0-gke.27/gke-on-prem-admin-appliance-vsphere-1.5.0-gke.27.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.5.0-gke.27/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.5.0-gke.27/gke-onprem-vsphere-1.5.0-gke.27.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.5.0-gke.27.tgz

1.4.3-gke.3

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

• Linux:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.3-gke.3/linux/gkeadm ./
  chmod +x gkeadm

• Windows:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.3-gke.3/windows/gkeadm.exe ./ 

Note: If you run this Linux or Windows command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.3-gke.3/gke-on-prem-admin-appliance-vsphere-1.4.3-gke.3.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.3-gke.3/gke-on-prem-admin-appliance-vsphere-1.4.3-gke.3.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.4.3-gke.3/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.4.3-gke.3/gke-onprem-vsphere-1.4.3-gke.3.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.4.3-gke.3.tgz

1.4.2-gke.3

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

• Linux:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.2-gke.3/linux/gkeadm ./
  chmod +x gkeadm

• Windows:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.2-gke.3/windows/gkeadm.exe ./ 

Note: If you run this Linux or Windows command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.2-gke.3/gke-on-prem-admin-appliance-vsphere-1.4.2-gke.3.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.2-gke.3/gke-on-prem-admin-appliance-vsphere-1.4.2-gke.3.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.4.2-gke.3/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.4.2-gke.3/gke-onprem-vsphere-1.4.2-gke.3.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.4.2-gke.3.tgz

1.4.1-gke.1

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

• Linux:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.1-gke.1/linux/gkeadm ./
  chmod +x gkeadm

• Windows:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.1-gke.1/windows/gkeadm.exe ./ 

Note: If you run this Linux or Windows command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.1-gke.1/gke-on-prem-admin-appliance-vsphere-1.4.1-gke.1.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.1-gke.1/gke-on-prem-admin-appliance-vsphere-1.4.1-gke.1.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.4.1-gke.1/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.4.1-gke.1/gke-onprem-vsphere-1.4.1-gke.1.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.4.1-gke.1.tgz

1.4.0-gke.13

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

• Linux:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.0-gke.13/linux/gkeadm ./
  chmod +x gkeadm

• Windows:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.4.0-gke.13/windows/gkeadm.exe ./ 

Note: If you run this Linux or Windows command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.0-gke.13/gke-on-prem-admin-appliance-vsphere-1.4.0-gke.13.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.4.0-gke.13/gke-on-prem-admin-appliance-vsphere-1.4.0-gke.13.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.4.0-gke.13/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.4.0-gke.13/gke-onprem-vsphere-1.4.0-gke.13.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.4.0-gke.13.tgz

1.3.4-gke.3

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

• Linux:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.3.4-gke.3/linux/gkeadm ./
  chmod +x gkeadm

• Windows:

  gcloud storage cp gs://gke-on-prem-release/gkeadm/1.3.4-gke.3/windows/gkeadm.exe ./ 

Note: If you run this Linux or Windows command, you can skip downloading an OVA image because gkeadm will download an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.4-gke.3/gke-on-prem-admin-appliance-vsphere-1.3.4-gke.3.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.4-gke.3/gke-on-prem-admin-appliance-vsphere-1.3.4-gke.3.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.3.4-gke.3/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, be sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.3.4-gke.3/gke-onprem-vsphere-1.3.4-gke.3.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.3.4-gke.3.tgz

1.3.3-gke.0

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

gcloud storage cp gs://gke-on-prem-release/gkeadm/1.3.3-gke.0/linux/gkeadm ./
chmod +x gkeadm

Note: If you run this command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.3-gke.0/gke-on-prem-admin-appliance-vsphere-1.3.3-gke.0.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.3-gke.0/gke-on-prem-admin-appliance-vsphere-1.3.3-gke.0.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.3.3-gke.0/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.3.3-gke.0/gke-onprem-vsphere-1.3.3-gke.0.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.3.3-gke.0.tgz

1.3.2-gke.1

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

gcloud storage cp gs://gke-on-prem-release/gkeadm/1.3.2-gke.1/linux/gkeadm ./
chmod +x gkeadm

Note: If you run this command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.2-gke.1/gke-on-prem-admin-appliance-vsphere-1.3.2-gke.1.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.2-gke.1/gke-on-prem-admin-appliance-vsphere-1.3.2-gke.1.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.3.2-gke.1/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.3.2-gke.1/gke-onprem-vsphere-1.3.2-gke.1.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.3.2-gke.1.tgz

1.3.1-gke.0

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

gcloud storage cp gs://gke-on-prem-release/gkeadm/1.3.1-gke.0/linux/gkeadm ./
chmod +x gkeadm

Note: If you run this command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.1-gke.0/gke-on-prem-admin-appliance-vsphere-1.3.1-gke.0.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.1-gke.0/gke-on-prem-admin-appliance-vsphere-1.3.1-gke.0.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.3.1-gke.0/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.3.1-gke.0/gke-onprem-vsphere-1.3.1-gke.0.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.3.1-gke.0.tgz

1.3.0-gke.16

gkeadm

From your personal laptop or workstation, run the following command to download the gkeadm command-line tool and make it executable:

gcloud storage cp gs://gke-on-prem-release/gkeadm/1.3.0-gke.16/linux/gkeadm ./
chmod +x gkeadm

Note: If you run this command, you can skip downloading an OVA image because gkeadm downloads an OVA file when creating an admin workstation.

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.0-gke.16/gke-on-prem-admin-appliance-vsphere-1.3.0-gke.16.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.3.0-gke.16/gke-on-prem-admin-appliance-vsphere-1.3.0-gke.16.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.3.0-gke.16/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.3.0-gke.16/gke-onprem-vsphere-1.3.0-gke.16.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16.tgz

1.2.2-gke.2

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.2-gke.2/gke-on-prem-admin-appliance-vsphere-1.2.2-gke.2.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.2-gke.2/gke-on-prem-admin-appliance-vsphere-1.2.2-gke.2.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.2.2-gke.2/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.2.2-gke.2/gke-onprem-vsphere-1.2.2-gke.2.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.2.2-gke.2.tgz

1.2.1-gke.4

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.1-gke.4/gke-on-prem-admin-appliance-vsphere-1.2.1-gke.4.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.1-gke.4/gke-on-prem-admin-appliance-vsphere-1.2.1-gke.4.ova.1.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.2.1-gke.4/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.2.1-gke.4/gke-onprem-vsphere-1.2.1-gke.4.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.2.1-gke.4.tgz

1.2.0-gke.6

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.0-gke.6/gke-on-prem-admin-appliance-vsphere-1.2.0-gke.6.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.2.0-gke.6/gke-on-prem-admin-appliance-vsphere-1.2.0-gke.6.ova.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.2.0-gke.6/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.2.0-gke.6/gke-onprem-vsphere-1.2.0-gke.6.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.2.0-gke.6.tgz

1.1.2-gke.0

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.1.2-gke.0/gke-on-prem-admin-appliance-vsphere-1.1.2-gke.0.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.1.2-gke.0/gke-on-prem-admin-appliance-vsphere-1.1.2-gke.0.ova.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.1.2-gke.0/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.1.2-gke.0/gke-onprem-vsphere-1.1.2-gke.0.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.1.2-gke.0.tgz

1.1.1-gke.2

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.1.1-gke.2/gke-on-prem-admin-appliance-vsphere-1.1.1-gke.2.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.1.1-gke.2/gke-on-prem-admin-appliance-vsphere-1.1.1-gke.2.ova.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.1.1-gke.2/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.1.1-gke.2/gke-onprem-vsphere-1.1.1-gke.2.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.1.1-gke.2.tgz

1.1.0-gke.6

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.1.0-gke.6/gke-on-prem-admin-appliance-vsphere-1.1.0-gke.6.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.1.0-gke.6/gke-on-prem-admin-appliance-vsphere-1.1.0-gke.6.ova.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.1.0-gke.6/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.1.0-gke.6/gke-onprem-vsphere-1.1.0-gke.6.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.1.0-gke.6.tgz

1.0.2-gke.3

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.0.2-gke.3/gke-on-prem-admin-appliance-vsphere-1.0.2-gke.3.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.0.2-gke.3/gke-on-prem-admin-appliance-vsphere-1.0.2-gke.3.ova.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.0.2-gke.3/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.0.2-gke.3/gke-onprem-vsphere-1.0.2-gke.3.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.0.2-gke.3.tgz

On your admin workstation, the bundle is stored at /var/lib/gke/bundles/ by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

1.0.1-gke.5

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.0.1-gke.5/gke-on-prem-admin-appliance-vsphere-1.0.1-gke.5.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.0.1-gke.5/gke-on-prem-admin-appliance-vsphere-1.0.1-gke.5.ova.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.0.1-gke.5/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.0.1-gke.5/gke-onprem-vsphere-1.0.1-gke.5.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.0.1-gke.5.tgz

On your admin workstation, the bundle is stored at /var/lib/gke/bundles/ by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

1.0.11

OVA

From your personal laptop or workstation, run the following commands:

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.0.11/gke-on-prem-admin-appliance-vsphere-1.0.11.ova ~/

gcloud storage cp gs://gke-on-prem-release/admin-appliance/1.0.11/gke-on-prem-admin-appliance-vsphere-1.0.11.ova.sig ~/

gkectl

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gkectl/1.0.1-gke.5/gkectl /usr/bin/gkectl
sudo chmod +x /usr/bin/gkectl
gkectl version

On your admin workstation, gkectl is stored at /usr/bin/gkectl by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

Bundle

From your admin workstation, run the following command:

sudo -E gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/1.0.11/gke-onprem-vsphere-1.0.11.tgz /var/lib/gke/bundles/gke-onprem-vsphere-1.0.11.tgz

On your admin workstation, the bundle is stored at /var/lib/gke/bundles/ by default. If you've chosen a different location on your PATH, make sure to specify it in this command.

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:

Note: As of version 1.2.1-gke.4, all SIG files are suffixed with .1. For example, gke-on-prem-admin-appliance-vsphere-[VERSION].ova.1.sig.

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

Expected output of this command is Verified OK.

Verifying gkectl using openssl

Verify the gkectl binary against the public key using openssl, where [VERSION] is the file's version:

sudo -E 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

Expected output of this command is Verified OK.

What's next

• Release notes
• Versions
• Installing GKE on-prem
• Upgrading clusters
• Upgrading admin workstation