Puoi visualizzare e amministrare i cluster creati con il software Google Distributed Cloud solo per VMware direttamente nella console Google Cloud . Dopo aver configurato l'autenticazione e concesso i ruoli richiesti, gli utenti possono accedere ai cluster e visualizzare i propri workload. Quando la gestione del ciclo di vita del cluster è abilitata, puoi anche eseguire l'upgrade, l'aggiornamento e l'eliminazione dei cluster utente dalla console.
Membri del parco risorse e console
Tutti i cluster Google Distributed Cloud (solo software) per VMware devono essere membri di un parco risorse, un modo unificato per visualizzare e gestire più cluster e i relativi workload. Ogni parco risorse di cluster è associato a un progetto host del parco risorse.
In Google Distributed Cloud (solo software) per VMware, un cluster di amministrazione viene registrato in un parco risorse al momento della creazione specificando il progetto host del parco risorse nella sezione gkeConnect del file di configurazione del cluster. Il software Google Distributed Cloud solo per VMware utilizza queste informazioni per registrare il cluster nel progetto del parco risorse specificato. Se la registrazione non va a buon fine, puoi riprovare eseguendo gkectl update credentials register.
Tieni presente che, quando riprovi a eseguire la registrazione, non è necessario aggiornare la chiave account di servizio connect-register. In altre parole, puoi continuare a utilizzare il tuo service account connect-register originale. Per ulteriori informazioni sul comando, consulta Rotazione account di servizio account.
In Google Distributed Cloud (solo software) per VMware, un cluster utente viene registrato in un parco risorse al momento della creazione:
Quando crei un cluster utente utilizzando
gkectl, specifichi il progetto host del parco risorse nella sezionegkeConnectdel file di configurazione del cluster. Il software Google Distributed Cloud solo per VMware utilizza queste informazioni per registrare il cluster nel progetto del parco risorse specificato.Quando crei un cluster utente utilizzando uno strumento standard (la console, Google Cloud CLI o Terraform), il cluster diventa automaticamente un membro del parco risorse nel progetto specificato.
I membri del parco risorse esterni a Google Cloud , come Google Distributed Cloud (solo software) per VMware, vengono visualizzati nella console nel progetto host del parco risorse, insieme ad altri cluster del parco risorse, come GKE su Google Cloud. La misura in cui puoi gestire il software Google Distributed Cloud solo per VMware dalla console dipende da quanto segue:
Se hai configurato l'autenticazione, puoi accedere ai tuoi cluster e visualizzare i relativi workload e altri dettagli.
Se hai attivato la gestione del ciclo di vita del cluster per il cluster, puoi anche eseguire l'upgrade, aggiornare o eliminare i cluster utente utilizzando la console. Se questa funzionalità non è abilitata, puoi gestire il ciclo di vita del cluster solo utilizzando
gkectlsulla tua workstation di amministrazione.
Visualizza i cluster registrati
Tutti i cluster del tuo parco risorse vengono visualizzati nella pagina Panoramica dei cluster Google Kubernetes Engine nella console. In questo modo, avrai una panoramica dell'intero parco risorse e, per Google Distributed Cloud (solo software) per VMware, potrai vedere quali cluster sono gestiti dall'API GKE On-Prem.
Per visualizzare i cluster del parco risorse:
Nella console, vai alla pagina Panoramica dei cluster Google Kubernetes Engine.
Seleziona il progetto Google Cloud .
Se nella colonna Tipo viene visualizzato vm Google Distributed Cloud, il cluster è gestito dall'API GKE On-Prem.
Se nella colonna Tipo viene visualizzato Esterno, il cluster non è gestito dall'API GKE On-Prem.
Per visualizzare ulteriori dettagli su un cluster, gli utenti devono accedere ed eseguire l'autenticazione al cluster. Per farlo, devi:
- Configura un metodo di autenticazione
- Concedi agli utenti ruoli Identity and Access Management specifici
Configura l'autenticazione
Come descritto in precedenza, tutti i cluster del parco risorse vengono visualizzati negli elenchi dei cluster GKE nella console. Tuttavia, per visualizzare ulteriori dettagli come nodi e workload (e per eseguire attività di gestione del ciclo di vita del cluster se la funzionalità è abilitata), gli utenti devono accedere ed eseguire l'autenticazione nel cluster. Per farlo, i cluster registrati devono essere configurati con uno dei seguenti metodi di autenticazione:
Google Identity: questa opzione consente agli utenti di accedere utilizzando la propria identitàGoogle Cloud , ovvero l'indirizzo email associato al tuo accountGoogle Cloud . Utilizza questa opzione se gli utenti hanno già accesso aGoogle Cloud con la loro Google Identity. Se hai creato il cluster nella console, puoi accedere al cluster utilizzando la tua identità Google, ma dovrai configurare l'autenticazione per gli altri utenti.
L'accesso con l'identità Google è l'approccio più semplice all'autenticazione nella console, in particolare se stai provando il software Google Distributed Cloud solo per VMware con un'installazione minima. Di seguito abbiamo descritto in dettaglio come configurarlo in Configura l'autenticazione dell'identità Google.
OpenID Connect (OIDC): questa opzione consente agli utenti di accedere ai cluster dalla console utilizzando la propria identità di un provider di identità OIDC di terze parti, come Okta o Microsoft AD FS. Ti consigliamo di utilizzare questa opzione se i tuoi utenti hanno già nomi utente, password e appartenenze a gruppi di sicurezza del tuo provider. Per scoprire come configurare l'autenticazione OIDC di terze parti per i tuoi cluster, consulta le seguenti guide:
Configura i cluster per GKE Identity Service con OIDC: questa guida mostra come configurare l'autenticazione OIDC cluster per cluster.
Configura GKE Identity Service per un parco risorse: questa opzione ti consente di configurare OIDC a livello di parco risorse.
Token di connessione: se le soluzioni precedenti fornite da Google non sono adatte alla tua organizzazione, puoi configurare l'autenticazione utilizzando un service account Kubernetes e il relativo token di connessione per accedere. Per maggiori dettagli, consulta Configura utilizzando un token di connessione.
Concedi i ruoli richiesti
L'accesso alla console è controllato da Identity and Access Management (IAM). Questi ruoli IAM sono obbligatori indipendentemente dal metodo di autenticazione scelto. Per gestire il ciclo di vita del cluster nella console, devi concedere alcuni ruoli IAM.
Per consentire agli utenti di accedere alla console, devi concedere almeno i seguenti ruoli:
roles/container.viewer. Questo ruolo consente agli utenti di visualizzare la pagina dei cluster GKE e altre risorse container nella console. Per i dettagli sulle autorizzazioni incluse in questo ruolo o per concedere un ruolo con autorizzazioni di lettura/scrittura, consulta Ruoli di Kubernetes Engine nella documentazione di IAM.roles/gkehub.viewer. Questo ruolo consente agli utenti di visualizzare i cluster esterni aGoogle Cloud nella console. Per i dettagli sulle autorizzazioni incluse in questo ruolo o per concedere un ruolo con autorizzazioni di lettura/scrittura, consulta Ruoli GKE Hub nella documentazione IAM.
Per consentire agli utenti di gestire il ciclo di vita del cluster nella console, concedi il ruolo IAM
roles/gkeonprem.admin. Il ruoloroles/gkeonprem.adminoffre agli utenti l'accesso amministrativo all'API GKE On-Prem, che la console utilizza per gestire il ciclo di vita del cluster. Per i dettagli sulle autorizzazioni incluse in questo ruolo, consulta Ruoli GKE on-prem nella documentazione di IAM.
I comandi seguenti mostrano come concedere i ruoli minimi necessari per gestire il ciclo di vita del cluster nella console:
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member=MEMBER \
--role=roles/container.viewer
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member=MEMBER \
--role=roles/gkehub.viewer
gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
--member=MEMBER \
--role=roles/gkeonprem.admin
dove:
FLEET_HOST_PROJECT_IDè il progetto host del parco risorse. Per i cluster creati utilizzandogkectl, questo è il progetto che hai configurato nella sezionegkeConnectdel file di configurazione del cluster utente. Per i cluster creati nella console, si tratta del progetto che hai scelto al momento della creazione del cluster.MEMBERè l'indirizzo email dell'utente nel formatouser:emailID, ad esempio:user:alice@example.com
Abilita la gestione del ciclo di vita del cluster nella console
I cluster utente creati utilizzando strumenti standard (la console, gcloud CLI o Terraform) vengono registrati automaticamente nell'API GKE On-Prem e ti consentono di eseguire attività di gestione del ciclo di vita dei cluster nella console. Se vuoi attivare questa funzionalità per i cluster utente creati utilizzando gkectl, segui i passaggi descritti in Configura un cluster utente da gestire con l'API GKE On-Prem.
Quando la gestione del ciclo di vita del cluster è abilitata, puoi eseguire le seguenti attività dalla console:
- Esegui l'upgrade dei cluster utente
- Ridimensiona i cluster utente
- Crea e gestisci i node pool
- Elimina i cluster utente
Configura l'autenticazione di Google Identity
Per consentire agli utenti di accedere al cluster utilizzando la loro Google Identity, devi configurare quanto segue:
Gli utenti devono disporre di ruoli Identity and Access Management (IAM) specifici per poter visualizzare e interagire con i cluster nella console nell'elenco dei cluster GKE.
Gli utenti devono essere aggiunti ai criteri di controllo dell'accesso dell'accesso basato su ruoli (RBAC) di Kubernetes di cui il gateway Connect ha bisogno per accedere al server API Kubernetes del cluster tramite l'agente Connect.
Configura l'autorizzazione RBAC
Il server API Kubernetes di ogni cluster deve essere in grado di autorizzare le richieste provenienti dalla console. Per configurare l'autorizzazione, devi configurare i criteri di controllo dell'accesso basato sui ruoli (RBAC) di Kubernetes su ogni cluster.
Se hai utilizzato uno strumento standard per creare il cluster utente, potresti già disporre delle policy RBAC appropriate che ti concedono l'accesso amministrativo completo al cluster. L'API GKE On-Prem aggiunge automaticamente il tuo Account Google come amministratore nei seguenti casi:
Hai creato il cluster utente nella console.
Hai creato il cluster utente utilizzando gcloud CLI e il tuo Account Google è stato specificato nel flag
--admin-usersnel comando di creazione del cluster.Hai creato il cluster utente utilizzando Terraform e il tuo Account Google è stato specificato nel campo
authorization.admin_users.username.
I cluster utente creati utilizzando gkectl non ti concedono le policy RBAC per amministrare il cluster utilizzando la console. Devi aggiungerti dopo la creazione del cluster. Indipendentemente dallo strumento utilizzato per creare il cluster, puoi aggiungere altri utenti come amministratori dopo la creazione del cluster.
Puoi utilizzare uno dei seguenti modi per concedere l'accesso amministrativo al cluster. Vengono forniti due diversi comandi gcloud.
Il comando
gcloud ... generate-gateway-rbacdeve essere eseguito sulla workstation di amministrazione perché richiede l'accesso al kubeconfig e al contesto del cluster (che in genere si trovano solo sulla workstation di amministrazione). Il comandogenerate-gateway-rbacconsente di personalizzare le policy RBAC, ma gli indirizzi email degli utenti non verranno visualizzati come amministratori nella sezione Dettagli cluster della console.Il comando
gcloud ... updatepuò essere eseguito sulla workstation di amministrazione o su qualsiasi computer che abbia accesso all'API GKE On-Prem.
generate-gateway-rbac
Connettiti alla tua workstation di amministrazione.
Esegui questo comando per aggiornare i componenti:
gcloud components updateGenera e applica le policy RBAC al cluster per utenti e service account:
gcloud container fleet memberships generate-gateway-rbac \ --membership=MEMBERSHIP_NAME \ --role=ROLE \ --users=USERS \ --project=FLEET_HOST_PROJECT_ID \ --kubeconfig=KUBECONFIG_PATH \ --context=KUBECONFIG_CONTEXT \ --applySostituisci quanto segue:
- MEMBERSHIP_NAME: il nome utilizzato per rappresentare in modo univoco il cluster nel suo parco risorse. In Google Distributed Cloud (solo software) per VMware, il nome della membership e il nome del cluster sono gli stessi.
- ROLE: il ruolo Kubernetes che vuoi concedere agli utenti nel cluster. Per concedere agli utenti l'accesso completo a ogni risorsa del cluster in tutti gli spazi dei nomi, specifica
clusterrole/cluster-admin. Per fornire l'accesso di sola lettura, specificaclusterrole/view. Puoi anche creare un ruolo personalizzato, ad esempio:role/mynamespace/namespace-reader. Il ruolo personalizzato deve già esistere prima di eseguire il comando. - USERS: gli indirizzi email degli utenti (account utente o service account) a cui vuoi concedere le autorizzazioni, sotto forma di elenco separato da virgole. Ad esempio:
--users=foo@example.com,test-acct@test-project.. - FLEET_HOST_PROJECT_ID: l'ID progetto del progetto host del parco risorse.
- KUBECONFIG_PATH: il percorso locale in cui è archiviato il kubeconfig contenente una voce per il cluster.
KUBECONFIG_CONTEXT: il contesto del cluster così come appare nel file kubeconfig. Puoi ottenere il contesto attuale dalla riga di comando eseguendo
kubectl config current-context. Indipendentemente dal fatto che tu utilizzi o meno il contesto attuale, assicurati che funzioni per accedere al cluster eseguendo un comando semplice come:kubectl get namespaces \ --kubeconfig=KUBECONFIG_PATH \ --context=KUBECONFIG_CONTEXT
Dopo aver eseguito
gcloud container fleet memberships generate-gateway-rbac, visualizzi un messaggio simile al seguente alla fine dell'output, che è troncato per leggibilità:Validating input arguments. Specified Cluster Role is: clusterrole/cluster-admin Generated RBAC policy is: -------------------------------------------- ... Applying the generate RBAC policy to cluster with kubeconfig: /usr/local/google/home/foo/.kube/config, context: kind-kind Writing RBAC policy for user: foo@example.com to cluster. Successfully applied the RBAC policy to cluster.Questo è il contesto per accedere al cluster tramite il gateway Connect.
Per maggiori dettagli sul comando
generate-gateway-rbac, consulta la guida di riferimento di gcloud CLI.
update
Esegui questo comando per aggiornare i componenti:
gcloud components updatePer ogni utente a cui deve essere concesso il ruolo
clusterrole/cluster-admin, includi il flag--admin-usersed esegui il comando seguente. Non puoi specificare più utenti in un unico flag. Assicurati di includere il tuo Account Google nel comando, perché il comando sovrascrive l'elenco di concessione con gli utenti specificati nel comando.gcloud container vmware clusters update USER_CLUSTER_NAME \ --admin-users YOUR_GOOGLE_ACCOUNT \ --admin-users ADMIN_GOOGLE_ACCOUNT_1
Oltre a concedere il ruolo Kubernetes clusterrole/cluster-admin, il comando concede le policy RBAC necessarie agli utenti per accedere al cluster tramite il gateway di Connect.
Console
Per applicare le policy RBAC agli utenti, segui questi passaggi nella console:
Nella console, vai alla pagina Panoramica dei cluster Google Kubernetes Engine.
Seleziona il progetto Google Cloud in cui si trova il cluster utente.
Nell'elenco dei cluster, fai clic sul nome del cluster per visualizzarne i dettagli.
Nella sezione Autorizzazione, fai clic sul pulsante di modifica Utenti amministratori.
Inserisci l'indirizzo email dell'utente che vuoi aggiungere come amministratore del cluster nel riquadro Modifica autorizzazione. Per aggiungere altri utenti amministratori, fai clic su Aggiungi utente amministratore.
Quando hai finito di aggiungere gli utenti, fai clic su Salva modifiche.