Questa pagina fornisce una panoramica di come funziona la creazione dei parchi risorse, con dettagli per i diversi tipi di cluster. Per ulteriori informazioni su come registrare manualmente i cluster nel parco risorse e sui prerequisiti per la registrazione manuale, consulta le nostre guide dettagliate alla creazione dei parchi risorse.
Puoi creare un parco risorse in uno dei seguenti modi:
- Registrando un cluster: quando registri un cluster di qualsiasi tipo in un progetto che non dispone già di un parco risorse, viene creato un nuovo parco risorse che diventa un progetto host del parco risorse. Un progetto può avere al massimo un unico parco risorse. A seconda del tipo di cluster e della sua posizione, la registrazione può avvenire automaticamente al momento della creazione del cluster, con i dettagli di registrazione specificati nella configurazione del cluster, oppure potresti dover aggiungere manualmente il cluster al parco risorse.
- Creando un parco risorse denominato: puoi creare un parco risorse vuoto prima di registrare i cluster.
- Con l'upgrade alla versione Google Kubernetes Engine (GKE) Enterprise: quando abiliti GKE Enterprise dalla console Google Cloud, viene creato automaticamente un parco risorse per il progetto e, per impostazione predefinita, tutti i cluster Google Cloud esistenti nel progetto vengono registrati automaticamente nel parco risorse. È anche possibile registrare nuovi cluster in un parco risorse durante la creazione del cluster.
Ogni parco risorse ha un nome che viene visualizzato nella console Google Cloud. Per impostazione predefinita, questo è l'ID progetto del progetto host del parco risorse con l'aggiunta di fleet. Se vuoi un nome più descrittivo per il parco risorse, puoi specificarlo durante la creazione di un parco risorse.
Informazioni sull'abbonamento a un parco risorse
Dopo aver registrato un cluster in un parco risorse, quest'ultimo diventa un membro del parco risorse. Poiché i parchi risorse possono includere cluster di più progetti e ambienti, devi assicurarti che ogni cluster che aggiungi al parco risorse abbia un nome univoco. A volte è indicato nei comandi e nella documentazione come nome membro del parco risorse del cluster. In genere, il nome dell'appartenenza al parco risorse di un cluster è il nome normale del cluster, ma potresti dover creare un nuovo nome al momento della registrazione (ad esempio aggiungendo o anteponendo un qualificatore al nome del cluster originale) se nel parco risorse esiste già un altro cluster con questo nome. Se tenti di registrare un cluster con un nome esistente nel tuo parco risorse, la registrazione non andrà a buon fine.
Località appartenenza del parco risorse
L'appartenenza a ogni cluster del parco risorse è gestita dal servizio del parco risorse. La località di questo servizio può essere globale o regionale, a seconda di come viene registrato il cluster nel parco risorse.
La loro appartenenza ai cluster GKE su Google Cloud registrata mediante Google Cloud CLI viene gestita da un'istanza di servizio del parco risorse eseguita nella stessa regione del cluster stesso. Ciò fornisce una latenza ottimale per la creazione di servizi ad alta disponibilità, compreso l'utilizzo di istanze a livello di regione di alcuni servizi come il gateway Connect. La gestione degli abbonamenti a livello di regione supporta anche situazioni in cui, ad esempio, disponi di dati che non possono lasciare una regione specifica per motivi normativi. Non puoi scegliere di gestire un cluster da un'altra regione.
I cluster GKE su Google Cloud registrati utilizzando Config Connector possono essere gestiti da un servizio del parco risorse globale o a livello di regione.
Tutti gli altri membri del parco risorse sono gestiti utilizzando un servizio del parco risorse globale.
Non puoi modificare la località di appartenenza di un cluster mentre è ancora un membro del parco risorse. Se hai un cluster GKE con appartenenza a un parco risorse globale e vuoi modificarlo in modo che sia gestito dalla rispettiva regione, devi annullare la registrazione del cluster e poi registrarlo di nuovo nello stesso parco risorse utilizzando gcloud o Config Connector.
Per verificare la località di appartenenza di un cluster (ad esempio, da utilizzare come parametro di comando o se stai considerando di passare un cluster all'appartenenza a livello di regione), esegui una delle seguenti operazioni:
Elenca tutti i membri del tuo parco risorse. La località di appartenenza di ogni cluster viene mostrata nella colonna
LOCATIONdell'output.gcloud container fleet memberships list \ --project=PROJECT_IDEsegui questo comando per
describel'appartenenza al cluster, inclusa la località di appartenenza. Sostituisci MEMBERSHIP_NAME con il nome di appartenenza del cluster.gcloud container fleet memberships describe MEMBERSHIP_NAME \ --project=PROJECT_ID
Ambiti dei team
Un cluster membro del parco risorse può essere associato a uno o più ambiti dei team all'interno del suo parco risorse. Gli ambiti dei team sono una struttura a livello di parco risorse per associare sottoinsiemi di cluster di cluster a team di applicazioni specifici e possono essere utilizzati per abilitare una gamma di funzionalità basate sui team, tra cui controllo dell'accesso, osservabilità a livello di team e sequenziamento delle implementazioni degli upgrade dei cluster.
Cluster GKE su Google Cloud
I cluster GKE su Google Cloud devono essere registrati esplicitamente per poter essere aggiunti a un parco risorse. Per registrare i cluster esistenti, puoi scegliere tra la registrazione rapida dalla pagina Cluster della console Google Cloud, la registrazione dalla riga di comando con gcloud CLI o la registrazione dichiarativa utilizzando Terraform o Config Connector. Puoi anche registrare nuovi cluster durante la creazione del cluster utilizzando la console Google Cloud, gcloud CLI o Terraform. Se hai abilitato GKE Enterprise, questo consente di creare cluster con alcune impostazioni e funzionalità a livello di parco risorse già configurate. Scopri di più su queste opzioni in Registrare un cluster su Google Cloud nel tuo parco risorse.
I cluster su Google Cloud possono essere registrati in un parco risorse nel progetto attuale o (con alcune autorizzazioni aggiuntive) in un parco risorse in un progetto diverso.
Cluster esterni a Google Cloud
Se hai abilitato GKE Enterprise, puoi aggiungere al tuo parco cluster esterni a Google Cloud e visualizzare e gestire insieme i cluster in ambienti diversi. I cluster GKE esterni a Google Cloud vengono in gran parte registrati automaticamente nel tuo parco risorse al momento della creazione del cluster, come descritto nel resto di questa sezione. Se vuoi aggiungere cluster Kubernetes di terze parti al tuo parco risorse, devi registrarli manualmente.
La registrazione dei cluster al di fuori di Google Cloud installa l'agente Connect sul cluster per gestire la comunicazione tra il cluster e il tuo progetto Google Cloud. Per saperne di più sul funzionamento di Connect Agent, consulta la panoramica di Connect Agent.
Google Distributed Cloud (on-premise)
I cluster GKE on-premise su VMware e on bare metal vengono registrati automaticamente nel parco risorse scelto al momento della creazione del cluster, con il progetto host del parco risorse e altri dettagli di registrazione specificati nel file di configurazione del cluster pertinente. Se utilizzi Google Distributed Cloud on VMware, tieni presente che a partire dalla versione 1.13, sia i cluster di amministrazione che i cluster utente devono essere registrati. Per le versioni precedenti alla 1.13, puoi aggiungere facoltativamente dettagli di registrazione alle configurazioni del cluster di amministrazione se vuoi gestirle come parte del tuo parco risorse. Puoi registrare cluster di amministrazione non registrati aggiornando il file di configurazione del cluster e utilizzando gkectl per aggiornare il cluster. Non è possibile annullare la registrazione dei cluster GKE on-premise o quelli registrati manualmente (ad eccezione dei cluster di amministrazione non registrati).
GKE su altri cloud pubblici
I cluster GKE su AWS e Azure creati utilizzando l'API GKE Multi-Cloud vengono registrati automaticamente nel parco risorse scelto al momento della creazione del cluster, con il progetto host del parco risorse specificato quando esegui il comando gcloud cluster create pertinente. Poiché ai cluster creati utilizzando GKE Multi-Cloud è già associato un progetto (il progetto in cui l'API è abilitata), devi eseguire una configurazione aggiuntiva durante la creazione del cluster se vuoi registrarli in un parco risorse in un progetto diverso. Non è possibile annullare la registrazione o registrare manualmente i cluster creati con l'API GKE Multi-Cloud.
Cluster Kubernetes di terze parti (cluster collegati)
Se hai cluster Kubernetes di terze parti esistenti (ad esempio EKS, AKS o distribuzioni on-premise) che vuoi gestire come membri del parco risorse, puoi registrarli nel parco risorse insieme a qualsiasi cluster GKE. Puoi collegare al tuo parco qualsiasi cluster Kubernetes conforme che include nodi x86 utilizzando l'API GKE Multi-Cloud. Questi includono Amazon EKS, Azure AKS e altri cluster conformi a CNCF che soddisfano i nostri requisiti. I cluster di terze parti che registri saranno soggetti a un addebito per vCPU come parte dei prezzi di GKE Enterprise.
Per registrare un cluster collegato, consulta le seguenti guide:
- Collega il cluster EKS.
- Collega il cluster AKS.
- Per tutti gli altri tipi di cluster, segui le istruzioni per collegare cluster conformi a CNCF, prestando attenzione ai prerequisiti del cluster.
Sposta un cluster in un parco risorse diverso
Al momento non è consigliato spostare i cluster registrati tra i parchi risorse (annullare la registrazione e poi ripetere la registrazione) perché potrebbe causare comportamenti imprevisti o indesiderati: ad esempio, Workload Identity del parco di carichi di lavoro cambierà, causando potenzialmente il blocco delle richieste e delle interruzioni. L'approccio consigliato è creare un nuovo cluster nel parco risorse in cui devono risiedere i carichi di lavoro, quindi spostare i carichi di lavoro dal cluster precedente a quello nuovo.
(Facoltativo) Crea un parco risorse vuoto
Per impostazione predefinita, la prima volta che registri un cluster in quel progetto viene creato un nuovo parco risorse nel progetto host del parco risorse o se abiliti GKE Enterprise dalla console Google Cloud. Se vuoi creare un nuovo parco risorse denominato prima di registrare qualsiasi cluster (ad esempio, per configurare gli ambiti per l'accesso ai team), esegui questo comando:
gcloud alpha container fleet create --display-name=NAME [--project=FLEET_HOST_PROJECT_ID]
Se non specifichi un valore display-name, il nuovo parco risorse avrà un nome visualizzato predefinito basato sul nome del progetto host del parco risorse.
Visualizza i tuoi parchi risorse
Se la tua organizzazione ha più parchi risorse, puoi visualizzarli e spostarti tra di essi nella console Google Cloud. Per visualizzare i parchi risorse nei progetti all'interno
della tua organizzazione, devi avere almeno il ruolo
roles/gkehub.viewer. Per ulteriori informazioni, consulta i ruoli di Kubernetes Engine e come concederli.
Tutti i parchi risorse
Per visualizzare tutti i parchi risorse:
Nella console Google Cloud, vai alla pagina Google Kubernetes Engine.
Nella parte superiore del menu di navigazione di GKE, fai clic su Tutti i parchi risorse. Viene visualizzato un elenco di tutti i parchi risorse dell'organizzazione.
Puoi fare clic sul nome di un parco risorse per visualizzare i cluster registrati in quel parco risorse. Se selezioni un parco risorse in questo elenco, passerai automaticamente al progetto host del parco risorse nella console Google Cloud.
Elenco a discesa del parco risorse
Per visualizzare i parchi risorse selezionati da un elenco a discesa:
Nella console Google Cloud, vai alla pagina Google Kubernetes Engine.
Nella parte superiore del menu di navigazione di GKE Enterprise, fai clic sull'elenco a discesa Floet che mostra i parchi risorse dei vari progetti.
Seleziona un nome del parco risorse per aprire la dashboard del parco risorse. Se selezioni un parco risorse in questo elenco, passerai automaticamente al progetto host del parco risorse nella console Google Cloud.
Puoi fare clic su Visualizza tutti i cluster nella dashboard per visualizzare i cluster registrati in quel parco risorse.
Che cosa succede dopo?
Prima di iniziare per tutti i tipi di cluster.
Registra un cluster GKE su Google Cloud: