Downloads do GKE no VMware

Neste documento, mostramos como fazer o download da ferramenta de linha de comando gkeadm e de outros componentes que fazem parte do GKE no VMware.

Normalmente, gkeadm é o único componente que você precisa transferir manualmente. Por exemplo, não é necessário fazer o download manual de gkectl ou do arquivo de pacote do GKE no VMware, porque eles são copiados automaticamente para a estação de trabalho do administrador. Além disso, não é necessário fazer o download manual do Open Virtual Appliance (OVA) da estação de trabalho do administrador, porque gkeadm copia automaticamente o OVA para o ambiente do vSphere.

Antes de começar

Você precisa estar conectado com uma Conta do Google.

Para verificar se você fez login, veja a propriedade do SDK account:

gcloud config get-value account

Para fazer login:

gcloud auth login

Fazer o download de gkeadm

Use a ferramenta de linha de comando gkeadm para criar uma estação de trabalho de administrador. Em seguida, estabeleça uma conexão SSH com a estação de trabalho do administrador e, a partir daí, crie os clusters.

A ferramenta de linha de comando gkeadm está disponível para Linux de 64 bits.

gkeadm também está disponível para macOS 10.15 e mais recentes, Windows 10 e Windows Server 2019. No entanto, a compatibilidade com macOS e Windows está obsoleta e será removida em uma versão futura.

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

Substitua VERSION pela versão do GKE no VMware em que você quer instalar ou fazer upgrade dos clusters. A versão de patch mais recente disponível é 1.16.8-gke.19. Para conferir uma lista de versões disponíveis, consulte o Histórico de versões.

Verificar gkeadm usando openssl

É possível usar openssl para verificar o binário gkeadm em relação à chave pública.

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

A saída esperada desse comando é Verified OK.

Fazer o download do pacote do GKE no VMware

Em determinados casos, convém fazer o download de um pacote do GKE no VMware para sua estação de trabalho do administrador.

Na estação de trabalho de administrador, execute este comando:

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

Substitua VERSION pela versão do GKE no VMware em que você quer instalar ou fazer upgrade dos clusters. A versão de patch mais recente disponível é 1.16.8-gke.19. Para conferir uma lista de versões disponíveis, consulte o Histórico de versões.

Verificar o pacote

gsutil cp gs://gke-on-prem-release/gke-onprem-bundle/VERSION/gke-onprem-vsphere-VERSION.tgz.1.sig /tmp/gke-onprem-vsphere-VERSION.tgz.1.sig
echo "-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----" > key.pem
openssl dgst -verify key.pem -signature /tmp/gke-onprem-vsphere-VERSION.tgz.1.sig /var/lib/gke/bundles/gke-onprem-vsphere-VERSION.tgz

Fazer o download de gkectl

Normalmente, não há motivo para fazer o download da ferramenta de linha de comando gkectl. No caso raro de fazer o download de gkectl, você pode encontrá-lo aqui:

gsutil cp gs://gke-on-prem-release/gkectl/VERSION/gkectl ./

Substitua VERSION pela versão do GKE no VMware em que você quer instalar ou fazer upgrade dos clusters. A versão de patch mais recente disponível é 1.16.8-gke.19. Para conferir uma lista de versões disponíveis, consulte o Histórico de versões.

Verificar gkectl usando openssl

É possível usar openssl para verificar o binário gkectl em relação à chave pública.

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

A saída esperada desse comando é Verified OK.

Fazer o download do OVA

Em alguns casos, é possível fazer o download do Open Virtual Appliance (OVA) da estação de trabalho de administrador.

Para fazer o download do OVA da estação de trabalho de administrador:

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

Substitua VERSION pela versão do GKE no VMware em que você quer instalar ou fazer upgrade dos clusters. A versão de patch mais recente disponível é 1.16.8-gke.19. Para conferir uma lista de versões disponíveis, consulte o Histórico de versões.

Verificar o OVA usando openssl

É possível usar openssl para verificar o arquivo OVA recebido por download em relação a um arquivo de assinatura (SIG).

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

A saída esperada desse comando é Verified OK.