Questo documento mostra come creare un cluster regionale Standard per aumentare la disponibilità del control plane e dei workload del cluster durante gli upgrade del cluster, la manutenzione automatizzata o un'interruzione a livello di zona.
I cluster GKE Autopilot sono sempre a livello di regione.
Panoramica
Quando crei un cluster regionale anziché un cluster di zona, il control plane del cluster viene replicato in più zone di una determinata regione. Per i node pool in un cluster regionale, puoi specificare manualmente le zone in cui eseguirli o utilizzare la configurazione predefinita, che replica ogni pool di nodi in tre zone della regione del control plane. Tutte le zone devono trovarsi nella stessa regione del control plane del cluster.
I cluster a livello di regione replicano le risorse in più zone e consumano quote aggiuntive.
Per scoprire i diversi tipi di disponibilità dei cluster, consulta Informazioni sulle scelte di configurazione dei cluster.
Le istruzioni nelle sezioni seguenti mostrano come:
- Crea un cluster regionale con un node pool a zona singola.
- Crea un cluster a livello di regione con un node pool multizona.
- Crea un cluster regionale con zero nodi.
Dopo aver creato un cluster a livello di regione, non puoi convertirlo in un cluster a livello di zona.
Le informazioni minime che devi specificare quando crei un nuovo cluster a livello di regione sono un nome, un progetto (di solito il progetto corrente) e una regione (di solito la località predefinita per gli strumenti a riga di comando), utilizzando le impostazioni predefinite per tutti gli altri valori. Tuttavia, esistono altre impostazioni di configurazione possibili, solo alcune delle quali sono descritte in questa guida e alcune non possono essere modificate dopo la creazione del cluster. Assicurati di comprendere quali impostazioni non possono essere modificate dopo la creazione del cluster e di scegliere l'impostazione corretta durante la creazione di un cluster se non vuoi doverlo creare di nuovo.
Puoi visualizzare una panoramica delle opzioni di configurazione del cluster in Informazioni sulle scelte di configurazione del cluster e un elenco completo delle opzioni possibili nelle guide di riferimento di gcloud container clusters create e Terraform google_container_cluster.
Prima di iniziare
Prima di iniziare, assicurati di aver eseguito le seguenti attività:
- Abilita l'API Google Kubernetes Engine. Abilita l'API Google Kubernetes Engine
- Per utilizzare Google Cloud CLI per questa attività,
installala e poi
inizializza
gcloud CLI. Se hai già installato gcloud CLI, scarica l'ultima
versione eseguendo il comando
gcloud components update. Le versioni precedenti di gcloud CLI potrebbero non supportare l'esecuzione dei comandi in questo documento.
- Assicurati di disporre delle autorizzazioni corrette per creare i cluster. Come minimo, devi essere un Amministratore cluster Kubernetes Engine.
- Se vuoi registrare il nuovo cluster in un parco risorse, assicurati di disporre delle API e delle autorizzazioni necessarie.
Configura i service account IAM per GKE
GKE utilizza i service account IAM collegati ai nodi per eseguire attività di sistema come il logging e il monitoraggio. Come minimo, questi service account dei nodi devono avere il ruolo Kubernetes Engine Default Node Service Account (roles/container.defaultNodeServiceAccount) sul tuo progetto. Per impostazione predefinita, GKE utilizza l'account di servizio predefinito di Compute Engine, che viene creato automaticamente nel tuo progetto, come account di servizio del nodo.
Per concedere il ruolo roles/container.defaultNodeServiceAccount al account di servizio predefinito di Compute Engine, completa i seguenti passaggi:
Console
- Vai alla pagina Benvenuto:
- Nel campo Numero progetto, fai clic su Copia negli appunti.
- Vai alla pagina IAM:
- Fai clic su Concedi l'accesso.
- Nel campo Nuove entità, specifica il seguente valore:
SostituisciPROJECT_NUMBER-compute@developer.gserviceaccount.comPROJECT_NUMBERcon il numero di progetto che hai copiato. - Nel menu Seleziona un ruolo, seleziona il ruolo Kubernetes Engine Default Node Service Account.
- Fai clic su Salva.
gcloud
- Trova il numero del tuo progetto Google Cloud :
gcloud projects describe PROJECT_ID \ --format="value(projectNumber)"
Sostituisci
PROJECT_IDcon l'ID progetto.L'output è simile al seguente:
12345678901
- Concedi il ruolo
roles/container.defaultNodeServiceAccountal account di servizio predefinito di Compute Engine:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com" \ --role="roles/container.defaultNodeServiceAccount"
Sostituisci
PROJECT_NUMBERcon il numero di progetto del passaggio precedente.
Crea un cluster a livello di regione con un pool di nodi a zona singola
Le seguenti istruzioni mostrano come creare un cluster a livello di regione con un node pool che opera in un'unica zona all'interno della regione. Il control plane del cluster viene replicato in più zone della regione specificata, ma i nodi si trovano nella singola zona e non vengono replicati in altre zone.
Per creare il cluster, puoi utilizzare gcloud CLI, la console Google Cloud o Terraform.
Se stai sviluppando applicazioni GKE con Cloud Code per VS Code, prova a creare cluster con Cloud Code.
gcloud
Prima di eseguire i comandi gcloud CLI per creare il cluster, imposta il progetto corretto eseguendo questo comando:
gcloud config set project PROJECT_ID
# gcloud config set billing/quota_project PROJECT_ID
Per creare un cluster a livello di regione con gcloud CLI, utilizza uno dei seguenti comandi e sostituisci le seguenti variabili:
CLUSTER_NAME: il nome del nuovo cluster regionale.CONTROL_PLANE_LOCATION: la regione di Compute Engine del control plane del tuo cluster. Fornisci una regione, ad esempious-east4.COMPUTE_ZONE: la zona del tuo pool di nodi, ad esempious-east4-a. La zona deve trovarsi nella stessa regione del control plane del cluster.CHANNEL: il tipo di canale di rilascio, che può essererapid,regular,stableoNone(deprecato). Per impostazione predefinita, il cluster è registrato nel canale di rilascioregular.VERSION: la versione che vuoi specificare per il tuo cluster.
Ti consigliamo vivamente di specificare un account di servizio IAM con privilegi minimi che i nodi possano utilizzare al posto del account di servizio predefinito di Compute Engine. Per scoprire come creare un account di servizio con privilegi minimi, consulta Utilizza un service account con privilegio minimo minimi.
Per specificare un account di servizio personalizzato in gcloud CLI, aggiungi il seguente flag al comando:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.comSostituisci SERVICE_ACCOUNT_NAME con il nome del tuo service account con privilegi minimi.
Utilizzo di un canale di rilascio specifico:
Per creare un nuovo cluster utilizzando un canale di rilascio specifico, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE \
--release-channel CHANNEL
Utilizzo di una versione specifica:
Per creare un nuovo cluster utilizzando una versione specifica del cluster, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE \
--cluster-version VERSION
Esempio
Il comando seguente crea un cluster a livello di regione registrato nel canale di rilascio regular (predefinito), con tre nodi (predefinito) nella zona us-west1-c:
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--node-locations us-west1-c
Esempio
Il comando seguente crea un cluster a livello di regione registrato nel canale di rilascio regular (predefinito), con due nodi situati nella zona us-west1-c:
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--node-locations us-west1-c \
--num-nodes 2
Console
Nella console Google Cloud , vai alla pagina Crea un cluster Kubernetes.
Nella sezione Impostazioni di base del cluster, completa quanto segue:
- Inserisci il nome del cluster.
- Per Tipo di località, seleziona A livello di regione, quindi seleziona la regione per il tuo cluster.
- Se vuoi eseguire l'override delle località dei nodi predefinite (ad esempio, per l'esecuzione in una singola zona), seleziona la casella di controllo Specifica località dei nodi predefinite, quindi scegli le zone in cui vuoi eseguire i node pool.
Scegli un canale di rilascio. Se vuoi, puoi selezionare Nessun canale, ma questa opzione di configurazione è deprecata e verrà rimossa. Per saperne di più, consulta Cluster non registrati in un canale di rilascio.
(Facoltativo) Specifica una versione del control plane dall'elenco a discesa Versione.
(Facoltativo) Configura altre impostazioni per il nuovo cluster.
(Facoltativo) Se vuoi registrare il nuovo cluster in un parco risorse, vai alla sezione Impostazioni avanzate e segui le istruzioni della console Google Cloud per creare e registrare un nuovo cluster per completare la registrazione del cluster.
Per creare e configurare i tuoi pool di nodi, segui questi passaggi:
- Fai clic su Aggiungi pool di nodi.
- Nella finestra di dialogo Modifiche necessarie, fai clic su Apporta modifiche.
Nel menu di navigazione viene visualizzato un pool di nodi denominato
default-pool.(Facoltativo) Per creare un cluster senza pool di nodi, segui questi passaggi:
- Nel menu di navigazione, fai clic su default-pool.
- Fai clic su Rimuovi node pool.
- Configura le restanti impostazioni del cluster e fai clic su Crea.
(Facoltativo) Per aggiungere node pool al cluster, fai clic su Aggiungi node pool. Nel menu di navigazione viene visualizzato un nuovo pool di nodi.
Configura le impostazioni di base per un pool di nodi:
- Nel menu di navigazione, nella sezione Pool di nodi, fai clic sul nome del pool di nodi. Viene visualizzata la pagina Dettagli pool di nodi gestito dall'utente.
- Nel campo Nome, inserisci un nome per il pool di nodi.
- Nella sezione Dimensioni, nel campo Numero di nodi,
specifica il numero di nodi da creare. Devi avere una quota di risorse disponibile per i nodi e le relative risorse (ad esempio le route del firewall). In GKE versione 1.37.1-gke.1153000 e successive, puoi creare un node pool vuoto specificando un valore di
0.
Configura le impostazioni per le istanze VM che eseguono i nodi:
- Nel menu di navigazione, nella sezione espansa del pool di nodi selezionato, fai clic su Nodi.
- Nell'elenco a discesa Tipo di immagine, seleziona l'immagine del nodo.
- Scegli la configurazione macchina predefinita da utilizzare per le istanze. Ogni tipo di macchina viene fatturato in modo diverso. Il tipo di macchina predefinito è
e2-medium. Per informazioni sui prezzi dei tipo di macchina, consulta il listino prezzi dei tipi di macchine. - Nell'elenco a discesa Tipo di disco di avvio, seleziona il tipo di disco.
- Nel campo Dimensione disco di avvio, specifica una dimensione in GB per il disco di avvio.
Configura le impostazioni di sicurezza per il pool di nodi:
- Nel menu di navigazione, nella sezione espansa del pool di nodi selezionato, fai clic su Sicurezza.
- (Facoltativo) Specifica un account di servizio IAM personalizzato per i nodi:
- Nella pagina Impostazioni avanzate, espandi la sezione Sicurezza.
- Nel menu Service account, seleziona il account di servizio che preferisci.
Ti consigliamo vivamente di specificare un account di servizio IAM con privilegi minimi che i nodi possano utilizzare al posto del account di servizio predefinito di Compute Engine. Per scoprire come creare un account di servizio con privilegi minimi, consulta Utilizza un service account con privilegio minimo minimi.
Fai clic su Crea.
Terraform
Per creare un cluster regionale con un pool di nodi a zona singola utilizzando Terraform, consulta l'esempio seguente:
Per scoprire di più sull'utilizzo di Terraform, consulta Supporto di Terraform per GKE.
Interagisci con un cluster utilizzando kubectl
Dopo aver creato un cluster, devi configurare kubectl prima di poter interagire con il cluster dalla riga di comando.
Crea un cluster a livello di regione con un pool di nodi multizona
Le istruzioni riportate di seguito mostrano come creare un cluster a livello di regione con un pool di nodi multi-zona, che è la configurazione predefinita. Il control plane e i nodi del cluster vengono replicati in più zone nella regione specificata.
Puoi utilizzare gcloud CLI, la console Google Cloud o Terraform per creare il cluster.
Se stai sviluppando applicazioni GKE con Visual Studio Code, prova a creare cluster con Cloud Code.
gcloud
Prima di eseguire i comandi gcloud CLI per creare il cluster, imposta il progetto corretto eseguendo questo comando:
gcloud config set project PROJECT_ID
# The project set above is used for quota and billing by default.
# To use a different project for quota and billing, run the following command:
# gcloud config set billing/quota_project PROJECT_ID
Per creare un cluster a livello di regione con gcloud CLI, utilizza uno dei seguenti comandi e sostituisci le seguenti variabili:
CLUSTER_NAME: il nome del nuovo cluster regionale.CONTROL_PLANE_LOCATION: la regione di Compute Engine del control plane del tuo cluster. Fornisci una regione, ad esempious-east4.CHANNEL: il tipo di canale di rilascio, che può essererapid,regular,stableoNone(deprecato). Per impostazione predefinita, il cluster è registrato nel canale di rilascioregular.VERSION: la versione che vuoi specificare per il tuo cluster.- Per le regioni con più di tre zone o nei casi in cui è preferibile un numero inferiore di zone, puoi utilizzare il flag facoltativo
--node-locationsper eseguire l'override delle zone predefinite in cui vengono replicati i nodi.
Ti consigliamo vivamente di specificare un account di servizio IAM con privilegi minimi che i nodi possano utilizzare al posto del account di servizio predefinito di Compute Engine. Per scoprire come creare un account di servizio con privilegi minimi, consulta Utilizza un service account con privilegio minimo minimi.
Per specificare un account di servizio personalizzato in gcloud CLI, aggiungi il seguente flag al comando:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.comSostituisci SERVICE_ACCOUNT_NAME con il nome del tuo service account con privilegi minimi.
Utilizzo di un canale di rilascio specifico:
Per creare un nuovo cluster utilizzando un canale di rilascio specifico, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--release-channel CHANNEL
Utilizzo di una versione specifica:
Per creare un nuovo cluster utilizzando una versione specifica del cluster, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--cluster-version VERSION
Esempio
Il comando seguente crea un cluster a livello di regione registrato nel canale di rilascio regular, con nove nodi in us-west1 (tre zone con tre nodi ciascuna, che è l'impostazione predefinita):
gcloud container clusters create my-regional-cluster --location us-west1
Esempio
Il comando seguente crea un cluster a livello di regione registrato nel canale di rilascio regular, con sei nodi (tre zone con due nodi ciascuna, specificate da --num-nodes):
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--num-nodes 2
Esempio
Il comando seguente crea un cluster a livello di regione registrato nel canale di rilascio regular, con sei nodi in due zone (due zone, specificate da --node-locations, con tre nodi ciascuna):
gcloud container clusters create my-regional-cluster \
--location us-east4 \
--node-locations us-east4-b,us-east4-c
Console
Nella console Google Cloud , vai alla pagina Crea un cluster Kubernetes.
Nella sezione Impostazioni di base del cluster, completa quanto segue:
- Inserisci il nome del cluster.
- Per Tipo di località, seleziona A livello di regione, quindi seleziona la regione per il tuo cluster.
- Se vuoi eseguire l'override delle località dei nodi predefinite (ad esempio, per l'esecuzione in una singola zona), seleziona la casella di controllo Specifica località dei nodi predefinite, quindi scegli le zone in cui vuoi eseguire i node pool.
Scegli un canale di rilascio. Se vuoi, puoi selezionare Nessun canale, ma questa opzione di configurazione è deprecata e verrà rimossa. Per saperne di più, consulta Cluster non registrati in un canale di rilascio.
(Facoltativo) Specifica una versione del control plane dall'elenco a discesa Versione.
(Facoltativo) Configura altre impostazioni per il nuovo cluster.
(Facoltativo) Se vuoi registrare il nuovo cluster in un parco risorse, vai alla sezione Impostazioni avanzate e segui le istruzioni della console Google Cloud per creare e registrare un nuovo cluster per completare la registrazione del cluster.
Per creare e configurare i tuoi pool di nodi, segui questi passaggi:
- Fai clic su Aggiungi pool di nodi.
- Nella finestra di dialogo Modifiche necessarie, fai clic su Apporta modifiche.
Nel menu di navigazione viene visualizzato un pool di nodi denominato
default-pool.(Facoltativo) Per creare un cluster senza pool di nodi, segui questi passaggi:
- Nel menu di navigazione, fai clic su default-pool.
- Fai clic su Rimuovi node pool.
- Configura le restanti impostazioni del cluster e fai clic su Crea.
(Facoltativo) Per aggiungere node pool al cluster, fai clic su Aggiungi node pool. Nel menu di navigazione viene visualizzato un nuovo pool di nodi.
Configura le impostazioni di base per un pool di nodi:
- Nel menu di navigazione, nella sezione Pool di nodi, fai clic sul nome del pool di nodi. Viene visualizzata la pagina Dettagli pool di nodi gestito dall'utente.
- Nel campo Nome, inserisci un nome per il pool di nodi.
- Nella sezione Dimensioni, nel campo Numero di nodi,
specifica il numero di nodi da creare. Devi avere una quota di risorse disponibile per i nodi e le relative risorse (ad esempio le route del firewall). In GKE versione 1.37.1-gke.1153000 e successive, puoi creare un node pool vuoto specificando un valore di
0.
Configura le impostazioni per le istanze VM che eseguono i nodi:
- Nel menu di navigazione, nella sezione espansa del pool di nodi selezionato, fai clic su Nodi.
- Nell'elenco a discesa Tipo di immagine, seleziona l'immagine del nodo.
- Scegli la configurazione macchina predefinita da utilizzare per le istanze. Ogni tipo di macchina viene fatturato in modo diverso. Il tipo di macchina predefinito è
e2-medium. Per informazioni sui prezzi dei tipo di macchina, consulta il listino prezzi dei tipi di macchine. - Nell'elenco a discesa Tipo di disco di avvio, seleziona il tipo di disco.
- Nel campo Dimensione disco di avvio, specifica una dimensione in GB per il disco di avvio.
Configura le impostazioni di sicurezza per il pool di nodi:
- Nel menu di navigazione, nella sezione espansa del pool di nodi selezionato, fai clic su Sicurezza.
- (Facoltativo) Specifica un account di servizio IAM personalizzato per i nodi:
- Nella pagina Impostazioni avanzate, espandi la sezione Sicurezza.
- Nel menu Service account, seleziona il account di servizio che preferisci.
Ti consigliamo vivamente di specificare un account di servizio IAM con privilegi minimi che i nodi possano utilizzare al posto del account di servizio predefinito di Compute Engine. Per scoprire come creare un account di servizio con privilegi minimi, consulta Utilizza un service account con privilegio minimo minimi.
Fai clic su Crea.
Terraform
Per creare un cluster regionale con un pool di nodi multi-zona utilizzando Terraform, consulta l'esempio seguente:
Per scoprire di più sull'utilizzo di Terraform, consulta Supporto di Terraform per GKE.
Interagisci con un cluster utilizzando kubectl
Dopo aver creato un cluster, devi configurare kubectl prima di poter interagire con il cluster dalla riga di comando.
Crea un cluster regionale con zero nodi
In GKE versione 1.37.1-gke.1153000 e successive, puoi creare un cluster a livello di regione con zero nodi in uno dei seguenti modi:
- Salta la creazione del node pool predefinito: GKE non aggiunge node pool al cluster. Se prevedi di eseguire i workload utilizzando classi di computing Autopilot, creazione automatica dei pool di nodi o pool di nodi personalizzati che crei in un secondo momento, utilizza questa opzione.
- Crea un node pool vuoto: GKE crea un node pool senza nodi. Utilizza questa opzione se vuoi personalizzare le impostazioni pool di nodi durante la creazione del cluster senza creare i nodi effettivi.
Quando crei un cluster con zero nodi, i pod di sistema rimangono in uno stato non pianificabile finché nel cluster non esiste almeno un nodo. Per creare un cluster regionale con zero nodi, seleziona una delle seguenti opzioni:
gcloud
Per saltare la creazione del pool di nodi predefinito, utilizza solo il flag
--num-nodes=0nel comandogcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0Sostituisci quanto segue:
CLUSTER_NAME: il nome del nuovo cluster a livello di regione.CONTROL_PLANE_LOCATION: la regione di Compute Engine del control plane del cluster, ad esempious-central1.
Se specifichi altri flag di configurazione del pool di nodi, come i flag
--machine-type,--disk-typeo--disk-size, il comando non va a buon fine perché non esiste un pool di nodi da configurare per GKE.Per creare un cluster con un pool di nodi vuoto, utilizza i flag
--num-nodes=0e--node-pool-namenel comandogcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0 \ --node-pool-name=NODEPOOL_NAMESostituisci
NODEPOOL_NAMEcon un nome per il pool di nodi vuoto. Puoi specificare altri flag di configurazione dei nodi per personalizzare i nodi nel pool di nodi vuoto.
Console
Nella console Google Cloud , vai alla pagina Crea un cluster Kubernetes.
Specifica un nome per il cluster.
Nella sezione Tipo di località, seleziona A livello di regione.
Nell'elenco a discesa Regione, seleziona una regione per il control plane del cluster.
Salta la creazione del pool di nodi predefinito o crea un pool di nodi vuoto:
Per saltare la creazione del pool di nodi predefinito, nella sezione Modalità predefinita, verifica che l'opzione Autopilot sia selezionata. In alternativa, attiva la creazione del pool di nodi predefinito e poi rimuovilo:
- Fai clic su Aggiungi pool di nodi.
- Nella finestra di dialogo Modifiche necessarie, fai clic su Apporta modifiche.
Viene visualizzato un pool di nodi denominato
default-pool. - Nel menu di navigazione, fai clic su default-pool.
- Fai clic su Rimuovi node pool.
Questi passaggi creano un cluster che non ha pool di nodi e utilizza la modalità Autopilot per eseguire i workload che non selezionano una ComputeClass. Puoi anche impedire l'utilizzo della modalità Autopilot selezionando l'opzione Node pool gestito dall'utente nella sezione Modalità predefinita.
Per creare un pool di nodi vuoto, segui questi passaggi:
- Fai clic su Aggiungi pool di nodi.
- Nella finestra di dialogo Modifiche necessarie, fai clic su Apporta modifiche.
Viene visualizzato un pool di nodi denominato
default-pool. - Nel menu di navigazione, fai clic su default-pool.
- Nel campo Numero di nodi (per zona), specifica un valore di
0.
Configura le restanti impostazioni per il cluster, quindi fai clic su Crea.
Terraform
- Per saltare la creazione del pool di nodi predefinito, nella risorsa
google_container_cluster, imposta il campoinitial_node_countsu un valore di0. Per creare un pool di nodi iniziale vuoto:
- Nella risorsa
google_container_cluster, imposta il campoinitial_node_countsu un valore di0. - Aggiungi una risorsa
google_container_node_poole imposta il camponode_countsul valore0.
- Nella risorsa
Dopo aver creato un cluster con zero nodi, puoi eseguire il provisioning dei nodi nei seguenti modi:
- Configura i cluster Standard in modo che utilizzino Autopilot per impostazione predefinita o esegui workload specifici in modalità Autopilot.
- Utilizza ComputeClasses per creare automaticamente nodi per i workload in entrata.
- Aggiungi manualmente un node pool o ridimensiona un node pool vuoto esistente.
Passaggi successivi
- Scopri di più sui tipi di cluster che puoi creare.
- Crea un cluster di zona.