Per eseguire il provisioning e gestire i cluster nel software Google Distributed Cloud solo per VMware, devi disporre di una workstation di amministrazione. Questa macchina fornisce gli strumenti di interfaccia a riga di comando (CLI) e i file di configurazione che utilizzi per eseguire il deployment dei cluster durante l'installazione e per interagire con i cluster in un secondo momento. Puoi creare la workstation di amministrazione come VM vSphere utilizzando gkeadm oppure puoi configurare una workstation gestita dall'utente su un computer di tua scelta. Questo documento fornisce istruzioni complete per entrambi gli approcci. Per un insieme di istruzioni più breve, consulta Crea una workstation di amministrazione nella guida alla creazione di cluster di base.
Scegli come creare la workstation di amministrazione
Esistono due modi per creare una workstation di amministrazione:
- Utilizza
gkeadmper creare una VM della workstation di amministrazione nel tuo ambiente vSphere. - Crea una workstation di amministrazione gestita dall'utente su qualsiasi computer di tua scelta.
Entrambi gli approcci presentano vantaggi e svantaggi.
Quando utilizzi gkeadm per creare la tua workstation di amministrazione, gkeadm esegue le seguenti operazioni, che semplificano la configurazione:
- Crea la VM della workstation di amministrazione.
- Utilizza un template VM che contiene tutto il software necessario per creare e gestire i cluster utilizzando lo strumento a riga di comando
gkectl. - Crea un account utente che tu o altri amministratori utilizzate per accedere alla workstation di amministrazione.
- Fornisce il comando SSH per accedere alla workstation di amministrazione con l'account utente fornito.
Una workstation di amministrazione creata da gkeadm può gestire un solo cluster di amministrazione. Se prevedi di creare più cluster di amministrazione, devi creare una workstation di amministrazione per ogni cluster di amministrazione.
La workstation di amministrazione creata da gkeadm è legata al ciclo di vita del cluster. Quando esegui l'upgrade di un cluster di amministrazione o di uno dei cluster utente gestiti dal cluster di amministrazione, devi prima eseguire l'upgrade della workstation di amministrazione.
Quando configuri la tua workstation di amministrazione, devi installare uno dei
sistemi operativi richiesti e tutto il software necessario. In questo modo, la configurazione iniziale richiede più tempo, perché la creazione di una VM da un template è più rapida rispetto all'installazione del software richiesto su un computer. Tuttavia, una volta configurata, la workstation presenta i seguenti vantaggi rispetto a una workstation di amministrazione creata da gkeadm:
- Puoi configurare la workstation gestita dall'utente per creare e gestire più di un cluster di amministrazione.
- Non è necessario eseguire l'upgrade di una workstation di amministrazione gestita dall'utente quando esegui l'upgrade di un cluster.
- Puoi utilizzare strumenti CI/CD standard per automatizzare la gestione del ciclo di vita dei cluster.
- Puoi utilizzare metodi di autenticazione standard come Active Directory per controllare l'accesso alla workstation di amministrazione.
- Puoi utilizzare i sistemi di autorizzazione standard per controllare a cosa possono accedere gli utenti sulla workstation di amministrazione e per controllare le loro azioni.
- Puoi scegliere il software che vuoi utilizzare per creare snapshot o backup della workstation di amministrazione.
Crea la workstation di amministrazione
Segui i passaggi nella scheda relativa all'approccio che hai scelto: utilizza gkeadm per creare una VM della workstation di amministrazione in vSphere o configura una workstation di amministrazione gestita dall'utente su un computer di tua scelta.
gkeadm
Prima di iniziare
Conosci l'indirizzo del tuo server vCenter.
Conosci il percorso del certificato CA.
Crea uno o più progetti Google Cloud come descritto in Utilizzo di più progetti Google Cloud .
Pianificazione dei service account
Quando utilizzi gkeadm per creare una workstation di amministrazione, hai la possibilità di consentire a gkeadm di creare alcuni dei tuoi service account e delle tue chiavi. In questo caso, gkeadm concede anche i ruoli Identity and Access Management appropriati ai service account.
In alternativa, puoi creare manualmente i service account e le chiavi. In questo caso, devi concedere manualmente i ruoli IAM ai tuoi service account.
La creazione manuale dei service account offre una maggiore flessibilità rispetto alla creazione automatica da parte di gkeadm:
I service account creati automaticamente hanno tutti lo stesso progettoGoogle Cloud padre del account di servizio di accesso ai componenti. Quando crei un account di servizio manualmente, puoi scegliere il progettoGoogle Cloud principale.
Ai service account creati automaticamente vengono concessi tutti i ruoli IAM nel progetto Google Cloud padre del service account di accesso ai componenti. Questo va bene se si tratta dell'unico progetto Google Cloud associato ai tuoi cluster. Tuttavia, se vuoi associare i tuoi cluster a più progetti Google Cloud , devi avere la flessibilità di concedere i ruoli a un account di servizio in un progettoGoogle Cloud di tua scelta.
Se decidi di creare i tuoi service account, segui le istruzioni riportate in Service account e chiavi.
Indipendentemente dal fatto che tu abbia creato automaticamente i service account per gkeadm, esiste un account di servizio che devi creare manualmente: il account di servizio di accesso ai componenti. Per istruzioni su come creare il account di servizio di accesso ai componenti e concedergli i ruoli IAM appropriati, consulta Service account di accesso ai componenti.
C'è un altro account di servizio che potresti dover creare manualmente: il tuo service account di audit logging. Se vuoi utilizzare un client API GKE On-Prem per gestire i cluster utente, devi abilitare l'audit logging nel cluster di amministrazione.
Generazione di modelli per i file di configurazione
Scarica gkeadm nella directory corrente.
Genera modelli:
./gkeadm create config
Il comando precedente ha creato questi file nella directory corrente:
credential.yamladmin-ws-config.yaml
Compilazione di credential.yaml
In credential.yaml, inserisci il nome utente e la password di vCenter. Ad esempio:
kind: CredentialFile items: - name: vCenter username: "my-account-name" password: "AadmpqGPqq!a"
Compilazione di admin-ws-config.yaml
Diversi campi in admin-ws-config.yaml sono già compilati con valori predefiniti o generati. Puoi mantenere i valori compilati o apportare modifiche come preferisci.
Campi da compilare
Compila i seguenti campi obbligatori. Per informazioni su come compilare i campi, consulta File di configurazione della workstation di amministrazione.
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 vuoi creare la tua workstation di amministrazione all'interno di una cartella VM vSphere, compila il campo vCenter.folder:
vCenter: folder: "Fill in"
Se la tua workstation di amministrazione si trova dietro un server proxy, compila il campo proxyURL:
adminWorkstation: proxyURL: "Fill in"
Se vuoi che la tua workstation di amministrazione riceva il proprio indirizzo IP da un server DHCP, imposta ipAllocationMode su "dhcp" e rimuovi la sezione hostconfig:
adminWorkstation: network: ipAllocationMode: "dhcp"
Se vuoi specificare un indirizzo IP statico per la tua workstation di amministrazione, imposta ipAllocationMode su "static" e compila la sezione hostconfig:
adminWorkstation:
network:
ipAllocationMode: "static"
hostconfig:
ip: "Fill in"
gateway: "Fill in"
netmask: "Fill in"
dns:
- "Fill in"
Eseguire l'accesso
L'Account Google impostato come proprietà
SDK account
è chiamato account SDK. Lo strumento a riga di comando gkeadm utilizza il tuo account SDK per scaricare l'OVA della workstation di amministrazione e abilitare i servizi nel tuo progettoGoogle Cloud .
Se scegli di far creare automaticamente i service account da gkeadm,
gkeadm utilizza anche il tuo account SDK per creare service account e chiavi
e per concedere ruoli ai service account.
È quindi importante impostare la proprietà account dell'SDK prima di eseguire gkeadm per creare una workstation di amministrazione.
Accedi con un Account Google. In questo modo viene impostata la proprietà
accountdell'SDK:gcloud auth login
Verifica che la proprietà
accountdell'SDK sia impostata correttamente:gcloud config list
L'output mostra i valori della proprietà
accountdell'SDK. Ad esempio:[core] account = my-name@google.com disable_usage_reporting = False Your active configuration is: [default]
Concedi i ruoli al tuo account SDK
Il tuo account SDK deve avere il seguente
ruolo IAM
nel progetto Google Cloud padre del tuo account di servizio di accesso ai componenti.
In questo modo, gkeadm può attivare i servizi nel progetto Google Cloud .
serviceUsage.serviceUsageAdmin
Se scegli di far creare automaticamente i service account da gkeadm,
il tuo account SDK deve avere anche i seguenti ruoli nel progetto padre
del account di servizio di accesso ai componenti. In questo modo, gkeadm può creare service account e chiavi.
resourcemanager.projectIamAdminiam.serviceAccountCreatoriam.serviceAccountKeyAdmin
Per concedere ruoli in un progetto Google Cloud , devi disporre di determinate autorizzazioni per il progettoGoogle Cloud . Per maggiori dettagli, consulta Concessione, modifica e revoca dell'accesso alle risorse.
Se disponi delle autorizzazioni richieste, puoi concedere i ruoli autonomamente. In caso contrario, un'altra persona della tua organizzazione deve concederti i ruoli.
Per concedere il ruolo richiesto al tuo account 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"
Sostituisci quanto segue:
PROJECT_ID: l'ID del progettoGoogle Cloud padre del tuo account di servizio di accesso ai componentiACCOUNT: il tuo account SDK
Per concedere ruoli aggiuntivi nel caso in cui tu voglia che gkeadm crei automaticamente i service account:
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"
Sostituisci quanto segue:
PROJECT_ID: l'ID del progetto principale del tuo account di servizio di accesso ai componentiACCOUNT: il tuo account SDK
Creazione della workstation di amministrazione
Inserisci questo comando per creare la tua workstation di amministrazione. Se vuoi che gkeadm crei i service account connect-register e logging-monitoring per te, includi il flag --auto-create-service-accounts. Se vuoi creare questi service account manualmente, ometti il flag.
./gkeadm create admin-workstation [--auto-create-service-accounts]
L'output fornisce informazioni dettagliate sulla creazione della workstation di amministrazione:
... 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 ********************************************************************
Connessione SSH alla workstation di amministrazione
Verso la fine dell'output precedente è presente un comando che puoi utilizzare per ottenere una connessione SSH alla tua workstation di amministrazione. Inserisci il comando ora. Ad esempio:
ssh -i /usr/local/google/home/me/.ssh/gke-admin-workstation ubuntu@172.16.5.1
Elenca i file sulla workstation di amministrazione:
ls -1
Nell'output puoi vedere due file di configurazione del cluster, il file del certificato CA e il file della chiave JSON per il service account di accesso ai componenti. Se gkeadm ha creato service account per te, puoi anche visualizzare i file delle chiavi JSON per questi service account. Ad esempio:
admin-cluster.yaml user-cluster.yaml vcenter-ca-cert.pem component-access-key.json
Verifica che gkeadm abbia attivato il account di servizio di accesso ai componenti sulla tua workstation di amministrazione:
gcloud config get-value account
Copia dei file delle chiavi JSON nella workstation di amministrazione
Prima di creare un cluster, i file delle chiavi JSON per i tuoi service account devono trovarsi nella directory home della tua workstation di amministrazione.
La chiave per il account di servizio di accesso ai componenti è già presente sulla tua workstation di amministrazione.
Se hai incluso il flag --auto-create-service-accounts quando hai eseguito gkeadm create admin-workstation, le chiavi per i seguenti service account si trovano già nella workstation di amministrazione nella home directory.
In caso contrario, devi copiare manualmente le chiavi nella home directory della tua workstation di amministrazione:
- Account di servizio Connect-register
- Account di servizio di logging-monitoring
Se hai creato uno dei seguenti service account, devi copiare manualmente le chiavi di questi service account nella home directory della tua workstation di amministrazione:
- Account di servizio di audit logging
- Account di servizio Autorizzazione binaria
Ripristino della workstation di amministrazione da un file di backup
Quando esegui l'upgrade di una workstation di amministrazione, il comando gkeadm upgrade salva un file di backup. In seguito, se non hai più una workstation di amministrazione o se hai perso alcuni dei file presenti nella workstation di amministrazione di cui hai eseguito l'upgrade, puoi utilizzare questo file di backup per creare una workstation di amministrazione ripristinata allo stato immediatamente successivo all'upgrade.
Per creare una workstation di amministrazione da un file di backup, esegui questo comando:
gkeadm create admin-workstation --restore-from-backup ADMIN_WORKSTATION_NAME-backup.tar.gz
Sostituisci ADMIN_WORKSTATION_NAME con il nome della workstation di amministrazione.
Gestito dall'utente
Scegli un computer da utilizzare come workstation di amministrazione. Puoi utilizzare Ubuntu o Red Hat Enterprise Linux (RHEL). Questi sono i requisiti:
Ubuntu 20.04 LTS o 22.04 LTS
- 4 core CPU
- 8 GiB di RAM
- 100 GiB di spazio di archiviazione
RHEL 8.6, 8.7 o 8.8
- 4 core CPU
- 12 GB di RAM
- 256 GiB di spazio di archiviazione
Accesso a Google Cloud
La tua workstation di amministrazione deve avere accesso a Google Cloud per scaricare e installare strumenti, elaborare richieste di autorizzazione, creare service account e altro ancora.
Per informazioni sui diversi modi per connetterti a Google Cloud, consulta Connettiti a Google.
L'accesso a Google Cloud può essere diretto o tramite un server proxy. Per informazioni sulle regole firewall e sulla configurazione di un server proxy, consulta Regole proxy e firewall.
Accesso a vCenter Server
Per creare e gestire i cluster dalla workstation di amministrazione, devi avere accesso alla tua istanza di vCenter Server. Per informazioni, consulta:
- Requisiti di vSphere
- Determina l'indirizzo del server vCenter
- Ottenere il certificato radice della CA vCenter
Configura un server NTP
Quando il cluster è configurato per utilizzare un server NTP, devi configurare un servizio di sincronizzazione dell'ora sulla workstation di amministrazione per assicurarti che timedatectl riporti l'ora sincronizzata con il cluster. Questo è necessario per evitare problemi di deriva dell'orologio di grandi dimensioni, che potrebbero causare errori di verifica del certificato a causa di date di scadenza non corrispondenti.
Ubuntu
Ti consigliamo di utilizzare il server di riferimento ora chrony.
Per installare chrony:
sudo apt-get update sudo apt install chrony
In questo modo vengono forniti due file binari:
chronyd: il daemon per la sincronizzazione e la pubblicazione tramite il protocollo NTP (Network Time Protocol)chronyc: l'interfaccia a riga di comando per il daemonchrony
Per configurare chronyd:
Modifica /etc/chrony/chrony.conf per aggiungere o rimuovere righe del server. Poi riavvia
chrony:
sudo systemctl restart chrony.service
RHEL
Ti consigliamo di utilizzare il server di riferimento ora chrony.
Per le istruzioni di installazione, consulta Come configurare chrony.
Sudo senza password
Se la tua policy di sicurezza lo consente, attiva sudo senza password per l'utente corrente. In questo modo, gkectl può preparare un registry privato, se ne viene fornito uno, configurare un proxy per Docker se la tua rete si trova dietro un server proxy e forzare l'eliminazione del cluster di bootstrap utilizzato per le operazioni del ciclo di vita del cluster di amministrazione nel caso in cui l'eliminazione non vada a buon fine.
Se scegli di non attivare sudo senza password e intendi utilizzare un registry privato per il tuo cluster di amministrazione, esegui la seguente configurazione manuale prima di creare il cluster di amministrazione:
Inserisci il certificato radice CA per il registry privato in questa directory:
/etc/docker/certs.d/REGISTRY_ADDRESS/
Sostituisci REGISTRY_ADDRESS con l'indirizzo della macchina che esegue il registry privato.
Per saperne di più, consulta Verifica il client del repository con i certificati.
Se la tua rete si trova dietro un server proxy, specifica il server proxy nel file di configurazione del cluster di amministrazione e configura Docker per l'utilizzo del server proxy.
Se scegli di non attivare sudo senza password, potresti dover eliminare manualmente il cluster kind dopo aver creato un cluster di amministrazione. Per saperne di più, consulta Il cluster Kind non viene eliminato nella documentazione sulla risoluzione dei problemi.
Installa il software
Ubuntu
Installa il seguente software:
Docker 19.03 o versioni successive: consulta Install Docker Engine on Ubuntu. Assicurati che l'utente non root sia un membro del gruppo docker. Consulta Gestisci Docker come utente non root.
Ultima versione di Google Cloud CLI: consulta Installa gcloud CLI.
kubectl: esegui
gcloud components install kubectlo utilizzaapt-get:
sudo apt-get update sudo apt-get -y install kubectl
RHEL
Installa il seguente software:
Docker 19.03 o versioni successive
Rimuovi qualsiasi versione precedente di Docker:
sudo dnf remove docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \ docker-engine
Rimuovi podman-manpages:
sudo dnf remove podman-manpages
Installa 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
Verifica che sia in esecuzione la versione 19.03 o successive:
sudo docker version
Confronta l'output con l'esempio seguente per assicurarti che le versioni client e server siano 19.03+:
Client: Docker Engine - Community Version: 19.03.13 ... Server: Docker Engine - Community Engine: Version: 19.03.13
Verifica che Docker sia in esecuzione:
docker run hello-world
Dovresti vedere qualcosa di simile:
Hello from Docker!
This message shows that your installation appears to be working correctly.
Ultima versione di Google Cloud CLI:
Vedi Installa gcloud CLI.
kubectl
Esegui gcloud components install kubectl.
Accedi
L'Account Google impostato come proprietà
SDK account
è chiamato account SDK. Lo strumento a riga di comando gkectl utilizza il tuo account SDK per scaricare gli OVA dei nodi del cluster, eseguire il pull delle immagini container e altro ancora. Pertanto, è importante impostare la proprietà dell'account SDK prima di eseguire i comandi gkectl.
Accedi con un Account Google. In questo modo viene impostata la proprietà account dell'SDK:
gcloud auth login
Verifica che la proprietà account dell'SDK sia impostata correttamente:
gcloud config list
L'output mostra i valori della proprietà account dell'SDK.
Ad esempio:
[core] account = my-name@google.com disable_usage_reporting = False Your active configuration is: [default]
Scarica gkectl e il bundle
Vai alla directory in cui vuoi installare gkectl.
Scarica gkectl:
gcloud storage cp gs://gke-on-prem-release/gkectl/VERSION/gkectl ./ chmod +x gkectl
Sostituisci VERSION con la versione del software Google Distributed Cloud solo per VMware. Ad esempio: 1.16.0-gke.1.
Scarica il bundle Google Distributed Cloud (solo software) per VMware. Assicurati che la versione corrisponda a quella che hai utilizzato per scaricare gkectl:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/VERSION/gke-onprem-vsphere-VERSION.tgz ./
Account di servizio e chiavi
Assicurati di aver creato i seguenti service account e file di chiavi JSON richiesti:
Assicurati inoltre di aver creato tutti i service account e i file di chiavi JSON per i servizi opzionali di cui hai bisogno:
Inserisci tutti i file delle chiavi JSON nella home directory della tua workstation di amministrazione.
Risoluzione dei problemi
La sezione seguente riattiva l'accesso SSH alla workstation di amministrazione nel caso in cui la chiave SSH venga persa o danneggiata.
Recupero della chiave SSH
Utilizza una VM temporanea per eseguire i seguenti passaggi:
Per generare un nuovo set di chiavi SSH, segui le istruzioni riportate in Crea chiavi SSH nella documentazione di Compute Engine.
Verifica che la VM temporanea e la workstation di amministrazione siano in stato
Powered Off.In vSphere, collega il disco di avvio della workstation di amministrazione alla VM temporanea.
Il disco di avvio ha l'etichetta
Hard disk 1.Monta il disco di avvio all'interno della VM eseguendo i seguenti comandi:
sudo mkdir -p /mnt/boot-disk sudo mount DISK_ID /mnt/boot-diskSostituisci
DISK_IDcon l'identificatore del disco di avvio, che dovrebbe avere un formato simile a/dev/sdc1.Modifica il file
authorized_keyssul disco di avvio per aggiungere i contenuti del file della chiave pubblica generato nel primo passaggio:vi /mnt/boot-disk/.ssh/authorized_keysArresta la VM temporanea.
Accendi la workstation di amministrazione.
Utilizza la chiave privata appena generata per accedere alla workstation di amministrazione.
ssh -i ~/.ssh/new-admin-ws.key ubuntu@ADMIN_WS_IPSostituisci
ADMIN_WS_IPcon l'indirizzo IP della tua workstation di amministrazione.
Utilizza la chiave privata appena generata per continuare ad accedere alla tua workstation di amministrazione.