Creazione di una workstation di amministrazione

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 gkeadm per 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.

Installa Google Cloud CLI.

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.yaml
  • admin-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.

  1. Accedi con un Account Google. In questo modo viene impostata la proprietà account dell'SDK:

    gcloud auth login
    
  2. 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]
    

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.projectIamAdmin
  • iam.serviceAccountCreator
  • iam.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 componenti

  • ACCOUNT: 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 componenti

  • ACCOUNT: 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:

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 daemon chrony

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:

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:

sudo apt-get update
sudo apt-get -y install kubectl

RHEL

Installa il seguente software:

Docker 19.03 o versioni successive

  1. 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
    
  2. Rimuovi podman-manpages:

    sudo dnf remove podman-manpages
    
  3. 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
    
  4. Verifica che sia in esecuzione la versione 19.03 o successive:

    sudo docker version
    
  5. 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
    
  6. 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:

  1. Per generare un nuovo set di chiavi SSH, segui le istruzioni riportate in Crea chiavi SSH nella documentazione di Compute Engine.

  2. Verifica che la VM temporanea e la workstation di amministrazione siano in stato Powered Off.

  3. In vSphere, collega il disco di avvio della workstation di amministrazione alla VM temporanea.

    Il disco di avvio ha l'etichetta Hard disk 1.

  4. 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-disk
    

    Sostituisci DISK_ID con l'identificatore del disco di avvio, che dovrebbe avere un formato simile a /dev/sdc1.

  5. Modifica il file authorized_keys sul disco di avvio per aggiungere i contenuti del file della chiave pubblica generato nel primo passaggio:

    vi /mnt/boot-disk/.ssh/authorized_keys
    
  6. Arresta la VM temporanea.

  7. Accendi la workstation di amministrazione.

  8. Utilizza la chiave privata appena generata per accedere alla workstation di amministrazione.

    ssh -i ~/.ssh/new-admin-ws.key ubuntu@ADMIN_WS_IP
    

    Sostituisci ADMIN_WS_IP con l'indirizzo IP della tua workstation di amministrazione.

Utilizza la chiave privata appena generata per continuare ad accedere alla tua workstation di amministrazione.

Passaggi successivi

Crea un cluster di amministrazione