Para provisionar e gerenciar clusters no Google Distributed Cloud (somente software) para VMware, você precisa de uma estação de trabalho de administrador. Essa máquina fornece as ferramentas de interface de linha de comando (CLI)
e os arquivos de configuração que você usa para implantar clusters durante
a instalação e interagir com eles depois. É possível criar a estação de trabalho
do administrador como uma VM do vSphere usando gkeadm ou configurar uma
estação de trabalho gerenciada pelo usuário em um computador de sua escolha. Este documento fornece
instruções completas para as duas abordagens. Para um conjunto mais curto de instruções,
consulte
Criar uma estação de trabalho de administrador
no guia "Criar clusters básicos".
Escolher como criar a estação de trabalho de administrador
Há duas maneiras de criar uma estação de trabalho de administrador:
- Use
gkeadmpara criar uma VM de estação de trabalho do administrador no seu ambiente vSphere. - Crie uma estação de trabalho de administrador gerenciada pelo usuário em qualquer computador.
As duas abordagens têm vantagens e desvantagens.
Quando você usa gkeadm para criar a estação de trabalho do administrador, gkeadm faz
o seguinte, o que simplifica a configuração:
- Cria a VM da estação de trabalho do administrador.
- Usa um modelo de VM que tem todo o software necessário para criar e
gerenciar clusters usando a ferramenta de linha de comando
gkectl. - Cria uma conta de usuário que você ou outros administradores usam para fazer login na estação de trabalho de administrador.
- Fornece o comando SSH para fazer login na estação de trabalho do administrador com a conta de usuário fornecida.
Uma estação de trabalho de administrador criada pelo gkeadm só pode gerenciar um cluster de administrador. Se
você planeja criar vários clusters de administrador, precisa criar uma estação de trabalho
de administrador para cada cluster de administrador.
A estação de trabalho de administrador criada pelo gkeadm está vinculada ao ciclo de vida do cluster. Ao
fazer upgrade de um cluster de administrador ou de qualquer um dos clusters de usuário gerenciados por ele, primeiro é preciso fazer upgrade da estação de trabalho de administrador.
Ao configurar sua própria estação de trabalho de administrador, é necessário instalar um dos
sistemas operacionais necessários e todos os softwares necessários. Isso torna a configuração inicial mais demorada, porque criar uma VM com base em um modelo é mais rápido do que instalar o software necessário em um computador. No entanto, depois que a estação de trabalho
é configurada, ela tem as seguintes vantagens em relação a uma estação de trabalho de administrador
criada por gkeadm:
- É possível configurar a estação de trabalho gerenciada pelo usuário para criar e gerenciar mais de um cluster de administrador.
- Não é necessário fazer upgrade de uma estação de trabalho de administrador gerenciada pelo usuário ao fazer upgrade de um cluster.
- É possível usar ferramentas de CI/CD padrão para automatizar o gerenciamento do ciclo de vida do cluster.
- É possível usar métodos de autenticação padrão, como o Active Directory, para controlar o acesso à estação de trabalho de administrador.
- É possível usar sistemas de autorização padrão para controlar o que os usuários podem acessar na estação de trabalho de administrador e auditar as ações deles.
- É possível escolher o software que você quer usar para criar snapshots ou backups da estação de trabalho de administrador.
Criar a estação de trabalho de administrador
Siga as etapas na guia para a abordagem escolhida: use gkeadm para
criar uma VM de estação de trabalho do administrador no vSphere ou configure uma estação de trabalho do administrador
gerenciada pelo usuário em um computador de sua escolha.
gkeadm
Antes de começar
Saber o endereço do servidor vCenter.
Conheça seu programa de certificação da CA.
Crie um ou mais projetos do Google Cloud , conforme descrito em Como usar vários projetos do Google Cloud .
Como planejar suas contas de serviço
Ao usar gkeadm para criar uma estação de trabalho de administrador, é possível
deixar que gkeadm crie algumas das suas contas de serviço e chaves para você. Nesse caso,
gkeadm também concede os papéis apropriados do gerenciamento de identidade e acesso às contas de
serviço.
Como alternativa, crie as contas de serviço e as chaves manualmente. Nesse caso, você precisa conceder manualmente os papéis do IAM às suas contas de serviço.
Criar contas de serviço manualmente oferece mais flexibilidade do que
gkeadm para criá-las:
Todas as contas de serviço criadas automaticamente têm o mesmo projeto pai doGoogle Cloud que a conta de serviço de acesso a componentes. Ao criar uma conta de serviço manualmente, escolha o projeto pai doGoogle Cloud .
Todas as contas de serviço criadas automaticamente recebem os papéis do IAM no projeto pai do Google Cloud referente à conta de serviço de acesso a componentes. Isso não é um problema se for o único projeto do Google Cloud associado aos clusters. Mas, se você quiser associar seus clusters a vários projetos do Google Cloud , você precisará de flexibilidade para conceder papéis a uma conta de serviço em um projeto doGoogle Cloud de sua escolha.
Se você decidir criar suas próprias contas de serviço, siga as instruções em Contas e chaves de serviço.
Se você tiver gkeadm como criar contas de serviço
automaticamente, há uma conta de serviço que precisa ser criada
manualmente: sua conta de serviço de acesso ao componente. Para saber como criar sua conta de serviço de acesso
a componentes e conceder a ela os papéis apropriados
do IAM, consulte
Conta de serviço de acesso a componentes.
Talvez seja necessário criar manualmente outra conta de serviço: a conta de serviço de registro de auditoria. Se você quiser usar um cliente da API GKE On-Prem para gerenciar seus clusters de usuários, ative a geração de registros de auditoria no cluster de administrador.
Como gerar modelos para seus arquivos de configuração
Faça o download de gkeadm no seu diretório atual.
Para gerar modelos:
./gkeadm create config
O comando acima criou esses arquivos no diretório atual:
credential.yamladmin-ws-config.yaml
Preenchendo credential.yaml
Em credential.yaml, preencha o nome de usuário e senha do vCenter. Por exemplo:
kind: CredentialFile items: - name: vCenter username: "my-account-name" password: "AadmpqGPqq!a"
Preenchendo admin-ws-config.yaml
Vários campos em admin-ws-config.yaml já estão preenchidos com valores padrão
ou gerados. Mantenha os valores preenchidos ou faça alterações à medida que
preferir.
Campos que você precisa preencher
Preencha os campos obrigatórios a seguir. Para informações sobre como preencher os campos, consulte Arquivo de configuração de estação de trabalho de administrador.
gcp: componentAccessServiceAccountKeyPath: "Fill in" vCenter: credentials: address: "Fill in" datacenter: "Fill in" datastore: "Fill in" cluster: "Fill in" network: "Fill in" resourcePool: "Fill in" caCertPath: "Fill in"
Se você quiser criar a estação de trabalho de administrador dentro de uma pasta da VM do vSphere, preencha o campo vCenter.folder:
vCenter: folder: "Fill in"
Se a estação de trabalho de administrador estiver atrás de um servidor proxy, preencha o campo
proxyURL:
adminWorkstation: proxyURL: "Fill in"
Se você quiser que sua estação de trabalho de administrador receba seu endereço IP de um servidor DHCP,
defina ipAllocationMode como "dhcp" e remova a seção hostconfig:
adminWorkstation: network: ipAllocationMode: "dhcp"
Se você quiser especificar um endereço IP estático para sua estação de trabalho de administrador, defina
ipAllocationMode como "static"
e preencha a seção
hostconfig:
adminWorkstation:
network:
ipAllocationMode: "static"
hostconfig:
ip: "Fill in"
gateway: "Fill in"
netmask: "Fill in"
dns:
- "Fill in"
Como fazer login
A Conta do Google definida como a propriedade
do account SDK
é chamada de conta do SDK. A ferramenta de linha de comando gkeadm usa a conta do SDK para fazer o download do OVA da estação de trabalho de administrador e ativar os serviços ativados no projeto doGoogle Cloud .
Se você optar por fazer com que gkeadm crie contas de serviço automaticamente,
gkeadm também usará a conta do SDK para criar contas de serviço e chaves,
bem como conceder papéis a contas de serviço.
Por isso, é importante definir a propriedade account do SDK antes de executar
gkeadm para criar uma estação de trabalho do administrador.
Faça login com qualquer Conta do Google: Isso define a propriedade
accountdo SDK:gcloud auth login
Verifique se a propriedade
accountdo SDK está configurada corretamente:gcloud config list
A saída mostra os valores da propriedade
accountdo SDK. Por exemplo:[core] account = my-name@google.com disable_usage_reporting = False Your active configuration is: [default]
Conceder papéis à conta do SDK
Sua conta do SDK precisa ter o seguinte
papel do IAM
no projeto pai do Google Cloud da conta de serviço de acesso a componentes.
Isso permite que gkeadm ative os serviços no projeto do Google Cloud .
serviceUsage.serviceUsageAdmin
Se você optar por fazer com que gkeadm crie automaticamente contas de serviço para você,
a conta do SDK também precisará ter os seguintes papéis no projeto
pai da conta de serviço de acesso a componentes. Isso permite que gkeadm
crie contas de serviço e chaves.
resourcemanager.projectIamAdminiam.serviceAccountCreatoriam.serviceAccountKeyAdmin
Para conceder papéis em um projeto do Google Cloud , é preciso ter determinadas permissões no projeto doGoogle Cloud . Para instruções detalhadas, veja Como conceder, alterar e revogar acesso a recursos.
Se tiver as permissões necessárias, você mesmo poderá conceder os papéis. Caso contrário, outra pessoa na sua organização precisará conceder esses papéis para você.
Conceder o papel necessário à conta do SDK:
Linux e macOS
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/serviceusage.serviceUsageAdmin"
Windows
gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/serviceusage.serviceUsageAdmin"
Substitua:
PROJECT_ID: o ID do projeto pai doGoogle Cloud da conta de serviço de acesso a componentesACCOUNT: a conta do SDK
Atribuir papéis adicionais caso você queira que gkeadm crie automaticamente contas de serviço:
Linux e macOS
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/resourcemanager.projectIamAdmin" gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/iam.serviceAccountCreator" gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/iam.serviceAccountKeyAdmin"
Windows
gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/resourcemanager.projectIamAdmin" gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/iam.serviceAccountCreator" gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/iam.serviceAccountKeyAdmin"
Substitua:
PROJECT_ID: o ID do projeto pai da conta de serviço de acesso a componentesACCOUNT: a conta do SDK
Como criar sua estação de trabalho do administrador
Digite este comando para criar a estação de trabalho de administrador. Se você quiser que
gkeadm crie as contas de serviço
connect-register
e
logging-monitoring
para você, inclua a flag
--auto-create-service-accounts. Se você quiser criar essas contas de serviço
manualmente, omita a flag.
./gkeadm create admin-workstation [--auto-create-service-accounts]
A saída fornece informações detalhadas sobre a criação da estação de trabalho do administrador:
... Getting ... service account... ... ******************************************************************** Admin workstation is ready to use. Admin workstation information saved to /usr/local/google/home/me/my-admin-workstation This file is required for future upgrades SSH into the admin workstation with the following command: ssh -i /usr/local/google/home/me/.ssh/gke-admin-workstation ubuntu@172.16.5.1 ********************************************************************
Como conseguir uma conexão SSH com a estação de trabalho do administrador
Próximo ao final da saída anterior, há um comando que pode ser usado para conseguir uma conexão SSH com a estação de trabalho de administrador. Digite esse comando agora. Por exemplo:
ssh -i /usr/local/google/home/me/.ssh/gke-admin-workstation ubuntu@172.16.5.1
Liste os arquivos na estação de trabalho do administrador:
ls -1
Na saída, é possível ver dois arquivos de configuração do cluster, o arquivo do certificado
de CA e o arquivo de chave JSON para a conta de serviço do acesso a
componentes. Se gkeadm criou contas de serviço para você, também será possível
ver os arquivos de chave JSON dessas contas de serviço. Por exemplo:
admin-cluster.yaml user-cluster.yaml vcenter-ca-cert.pem component-access-key.json
Verifique se gkeadm ativou a conta de serviço de acesso a componentes na
estação de trabalho de administrador:
gcloud config get-value account
Como copiar arquivos de chave JSON para a estação de trabalho de administrador
Antes de criar um cluster, os arquivos de chave JSON das contas de serviço precisam estar na estação de trabalho de administrador no diretório inicial.
A chave da sua conta de serviço de acesso a componentes já está na estação de trabalho do administrador.
Se você incluiu a flag --auto-create-service-accounts ao executar
gkeadm create admin-workstation, as chaves das seguintes contas de serviço
já estão na estação de trabalho de administrador no diretório inicial.
Caso contrário, copie manualmente as chaves para o diretório inicial da estação de trabalho
do administrador:
- Conta de serviço connect-register
- Conta de serviço logging-monitoring
Se você criou uma das contas de serviço a seguir, precisará copiar manualmente as chaves dessas contas de serviço para o diretório inicial da sua estação de trabalho de administrador:
- Conta de serviço de registro de auditoria
- Conta de serviço de autorização binária
Como restaurar a estação de trabalho de administrador de um arquivo de backup
Quando você faz upgrade de uma estação de trabalho de administrador, o comando gkeadm upgrade
salva um arquivo de backup. Se você não tiver mais uma estação de trabalho de administrador ou tiver perdido alguns dos
arquivos que estavam na estação de administrador atualizada, poderá usar esse arquivo de
backup para criar uma estação de trabalho de administrador restaurada para o que existia
imediatamente depois do upgrade.
Para criar uma estação de trabalho de administrador usando um arquivo de backup, execute este comando:
gkeadm create admin-workstation --restore-from-backup ADMIN_WORKSTATION_NAME-backup.tar.gz
Substitua ADMIN_WORKSTATION_NAME pelo nome da estação de trabalho de administrador.
Gerenciado pelo usuário
Escolha um computador para servir como a estação de trabalho do administrador. Você pode usar o Ubuntu ou o Red Hat Enterprise Linux (RHEL). Estes são os requisitos:
Ubuntu 20.04 LTS ou LTS 22.04
- 4 núcleos de CPU
- 8 GiB de RAM
- 100 GiB de armazenamento
RHEL 8.6, 8.7 ou 8.8
- 4 núcleos de CPU
- 12 GB de RAM
- 256 GiB de armazenamento
Acesso ao Google Cloud
A estação de trabalho do administrador precisa ter acesso ao Google Cloud para fazer o download e instalar ferramentas, processar solicitações de autorização, criar contas de serviço e muito mais.
Para informações sobre as diferentes maneiras de se conectar ao Google Cloud, consulte Conectar-se ao Google.
O acesso ao Google Cloud pode ser direto ou por um servidor proxy. Para saber mais sobre regras de firewall e configurar um servidor proxy, consulte Regras de proxy e firewall.
Acesso ao servidor vCenter
Para criar e gerenciar clusters na estação de trabalho do administrador, você precisa acessar sua instância do servidor vCenter. Confira mais informações em:
- Requisitos do vSphere
- Determinar o endereço do servidor vCenter
- Como conseguir o certificado raiz da CA do vCenter
Configurar um servidor NTP
Quando o cluster estiver configurado para usar um servidor NTP, você vai precisar configurar um
serviço de sincronização de horário na estação de trabalho do administrador para garantir que timedatectl
informe o horário sincronizado com o cluster. Isso é necessário para evitar grandes
problemas de deslocamento do relógio, o que pode causar falhas na verificação de certificados devido
a datas de validade sem correspondência.
Ubuntu
Recomendamos que você use o servidor de horário chrony.
Para instalar chrony:
sudo apt-get update sudo apt install chrony
Isso fornece dois binários:
chronyd: o daemon para sincronizar e disponibilizar pelo Network Time Protocolchronyc: a interface de linha de comando do daemonchrony
Para configurar chronyd:
Edite /etc/chrony/chrony.conf para adicionar ou remover linhas de servidor. Em seguida, reinicie
chrony:
sudo systemctl restart chrony.service
RHEL
Recomendamos que você use o servidor de horário chrony.
Para instruções de instalação, consulte Como configurar o chrony.
Sudo sem senha
Se a política de segurança permitir, ative o sudo sem senha para o
usuário atual. Isso permite que gkectl prepare um registro particular (se houver um), configure o proxy para o Docker se a rede estiver atrás de um servidor proxy e exclua o cluster de inicialização usado para operações de ciclo de vida do cluster de administrador caso a exclusão falhe.
Se você optar por não ativar o sudo sem senha e quiser usar um registro particular para o cluster de administrador, faça a seguinte configuração manual antes de criar o cluster de administrador:
Coloque o certificado raiz de AC do registro particular neste diretório:
/etc/docker/certs.d/REGISTRY_ADDRESS/
Substitua REGISTRY_ADDRESS pelo endereço da máquina que executa o registro particular.
Para mais informações, consulte Verificar o cliente do repositório com certificados.
Se a rede estiver protegida por um servidor proxy, especifique o servidor proxy no arquivo de configuração do cluster de administrador e configure o Docker para usar o servidor proxy.
Se você optar por não ativar o sudo sem senha, talvez seja necessário excluir manualmente
o cluster kind depois de criar um cluster de administrador. Para mais
informações, consulte
O cluster do tipo não é excluído
na documentação de solução de problemas.
Instalar o software
Ubuntu
Instale os seguintes softwares:
Docker versão 19.03 ou mais recente: instale o Docker Engine no Ubuntu. Verifique se o usuário não raiz é membro do grupo do Docker. Consulte Gerenciar o Docker como um usuário não raiz.
Versão mais recente da Google Cloud CLI: consulte Instalar a CLI gcloud.
kubectl: execute
gcloud components install kubectlou useapt-get:
sudo apt-get update sudo apt-get -y install kubectl
RHEL
Instale os seguintes softwares:
Docker 19.03 ou mais recente
Remova qualquer versão anterior do Docker:
sudo dnf remove docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \ docker-engine
Remova podman-manpages
sudo dnf remove podman-manpages
Instale o Docker 19.03+:
sudo dnf install -y yum-utils sudo yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo sudo dnf install -y --allowerasing docker-ce docker-ce-cli containerd.io sudo systemctl start docker
Verifique se você está usando a versão 19.03+:
sudo docker version
Compare o resultado com o exemplo a seguir para garantir que as versões do cliente e do servidor sejam 19.03+ :
Client: Docker Engine - Community Version: 19.03.13 ... Server: Docker Engine - Community Engine: Version: 19.03.13
Verifique se o Docker executa:
docker run hello-world
Você verá algo como:
Hello from Docker!
This message shows that your installation appears to be working correctly.
Versão mais recente da CLI do Google Cloud:
Consulte Instalar a CLI gcloud.
kubectl
Execute gcloud components install kubectl.
Fazer login
A Conta do Google definida como a propriedade
do account SDK
é chamada de conta do SDK. A ferramenta de linha de comando gkectl usa sua conta do SDK
para fazer o download de OVAs de nós do cluster, extrair imagens de contêiner e muito mais. Por isso,
é importante definir a propriedade da conta do SDK antes de executar
comandos gkectl.
Faça login com qualquer Conta do Google: Isso define a propriedade account do SDK:
gcloud auth login
Verifique se a propriedade account do SDK está configurada corretamente:
gcloud config list
A saída mostra os valores da propriedade account do SDK.
Por exemplo:
[core] account = my-name@google.com disable_usage_reporting = False Your active configuration is: [default]
Fazer o download do gkectl e do pacote
Navegue até um diretório em que você quer instalar o gkectl.
Faça o download de gkectl:
gcloud storage cp gs://gke-on-prem-release/gkectl/VERSION/gkectl ./ chmod +x gkectl
Substitua VERSION pela versão do Google Distributed Cloud (somente software) para VMware. Por
exemplo: 1.16.0-gke.1.
Faça o download do pacote do Google Distributed Cloud (somente software) para VMware. Verifique se a versão corresponde à
que você usou para fazer o download de gkectl:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/VERSION/gke-onprem-vsphere-VERSION.tgz ./
Contas de serviço e chaves
Confira se você criou as seguintes contas de serviço e arquivos de chave JSON:
Além disso, verifique se você criou todas as contas de serviço opcionais e arquivos de chave JSON necessários:
Coloque todos os arquivos de chave JSON no diretório inicial da estação de trabalho do administrador.
Solução de problemas
A seção a seguir reativa o acesso SSH à estação de trabalho do administrador no caso de perda ou corrupção da chave SSH.
Recuperação de chaves SSH
Use uma VM temporária para realizar as etapas a seguir:
Para gerar um novo conjunto de chaves SSH, siga as instruções em Criar chaves SSH na documentação do Compute Engine.
Verifique se a VM temporária e a estação de trabalho do administrador estão em um estado
Powered Off.No vSphere, anexe o disco de inicialização da estação de trabalho do administrador à VM temporária.
O disco de inicialização tem o rótulo
Hard disk 1.Monte o disco de inicialização dentro da VM executando os seguintes comandos:
sudo mkdir -p /mnt/boot-disk sudo mount DISK_ID /mnt/boot-diskSubstitua
DISK_IDpelo identificador do disco de inicialização, que deve ter um formato semelhante a/dev/sdc1.Edite o arquivo
authorized_keysno disco de inicialização para anexar o conteúdo do arquivo de chave pública gerado na primeira etapa:vi /mnt/boot-disk/.ssh/authorized_keysEncerre a VM temporária.
Ligue a estação de trabalho de administrador.
Use a chave privada recém-gerada para acessar a estação de trabalho de administrador.
ssh -i ~/.ssh/new-admin-ws.key ubuntu@ADMIN_WS_IPSubstitua
ADMIN_WS_IPpelo endereço IP da estação de trabalho de administrador.
Use a chave privada recém-gerada para continuar acessando a estação de trabalho do administrador.