Creazione di un cluster di zona

Questa pagina mostra come creare un cluster di zona Standard con le funzionalità predefinite abilitate in Google Kubernetes Engine (GKE). I cluster di zona hanno una singola istanza del control plane in una singola zona. A seconda dei requisiti di disponibilità, puoi scegliere di distribuire i nodi del cluster a livello di zona in una o più zone.

Best practice: utilizza i cluster a livello di regione per eseguire i workload di produzione, in quanto offrono un'affidabilità maggiore rispetto ai cluster di zona. In un cluster regionale, il control plane viene replicato in più zone di una regione.

Questa pagina è rivolta a operatori, Cloud Architect e sviluppatori che devono creare e configurare cluster ed eseguire il deployment dei workload su GKE. Per scoprire di più sui ruoli comuni e sugli esempi di attività a cui facciamo riferimento nei contenuti di Google Cloud, consulta Ruoli e attività comuni degli utenti GKE.

Prima di leggere questa pagina, assicurati di avere familiarità con le scelte di configurazione del 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.

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

  1. Vai alla pagina Benvenuto:

    Vai alla pagina di benvenuto

  2. Nel campo Numero progetto, fai clic su Copia negli appunti.
  3. Vai alla pagina IAM:

    Vai a IAM

  4. Fai clic su Concedi l'accesso.
  5. Nel campo Nuove entità, specifica il seguente valore:
    PROJECT_NUMBER-compute@
    Sostituisci PROJECT_NUMBER con il numero di progetto che hai copiato.
  6. Nel menu Seleziona un ruolo, seleziona il ruolo Kubernetes Engine Default Node Service Account.
  7. Fai clic su Salva.

gcloud

  1. Trova il numero del tuo progetto Google Cloud :
    gcloud projects describe PROJECT_ID \
        --format="value(projectNumber)"

    Sostituisci PROJECT_ID con l'ID progetto.

    L'output è simile al seguente:

    12345678901
    
  2. Concedi il ruolo roles/container.defaultNodeServiceAccount al account di servizio predefinito di Compute Engine:
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:PROJECT_NUMBER-compute@" \
        --role="roles/container.defaultNodeServiceAccount"

    Sostituisci PROJECT_NUMBER con il numero di progetto del passaggio precedente.

Creazione di un cluster di zona

Le informazioni minime che devi specificare quando crei un nuovo cluster a livello di zona sono un nome, un progetto (di solito il progetto corrente) e una zona (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 sezione 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.

Puoi creare un cluster a livello di zona utilizzando gcloud CLI, la consoleGoogle Cloud o Terraform.

Se stai sviluppando applicazioni GKE con Cloud Code per VS Code, prova a creare cluster con Cloud Code.

gcloud

Per creare un cluster di zona con gcloud CLI, utilizza uno dei seguenti comandi.

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del nuovo cluster.
  • CHANNEL: il tipo di canale di rilascio, che può essere rapid, regular, stable o None (deprecato). Per impostazione predefinita, il cluster è registrato nel canale di rilascio regular.
  • CONTROL_PLANE_LOCATION: la zona di Compute Engine del control plane del tuo cluster.
  • VERSION: la versione che vuoi specificare per il tuo cluster.
  • COMPUTE_ZONE,COMPUTE_ZONE1,[...]: le zone in cui vengono creati i nodi. Puoi specificare tutte le zone necessarie per il tuo cluster. Tutte le zone devono trovarsi nella stessa regione del control plane del cluster, specificata dal flag --location. Per i cluster di zona, --node-locations deve contenere la zona principale del 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.

Sostituisci 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 \
    --release-channel CHANNEL \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

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 \
    --cluster-version VERSION \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Esempio

Il comando seguente crea un cluster multizona denominato example-cluster, dove il control plane del cluster si trova nella zona us-east4-a e sono presenti tre località dei nodi. Il cluster è registrato nel canale di rilascio regular.

Se il flag --num-nodes viene omesso, il numero predefinito di nodi per zona creati dal cluster è tre. Poiché sono state specificate tre zone, questo comando crea un cluster di nove nodi con tre nodi ciascuno in us-east4-a, us-east4-b e us-east4-c. In GKE versione 1.37.1-gke.1153000 e successive, puoi impostare il flag --num-nodes su un valore compreso tra 0 e creare un cluster con zero nodi.

gcloud container clusters create example-cluster \
    --location us-east4-a \
    --node-locations us-east4-a,us-east4-b,us-east4-c

Console

Per creare un cluster di zona con la console Google Cloud , esegui queste attività:

  1. Nella console Google Cloud , vai alla pagina Crea un cluster Kubernetes.

    Vai a Crea un cluster Kubernetes

  2. Nella sezione Impostazioni di base del cluster, completa quanto segue:

    1. Inserisci il nome del cluster.
    2. Per Tipo di località, seleziona A livello di zona, quindi seleziona la zona per il tuo cluster.
    3. Se stai creando un cluster multizona, seleziona la casella di controllo Specifica località dei nodi predefinite, quindi scegli altre zone in cui vuoi eseguire i node pool.

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

    5. (Facoltativo) Specifica una versione del control plane dall'elenco a discesa Versione.

  3. (Facoltativo) Configura altre impostazioni per il nuovo cluster.

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

  5. Per creare e configurare i tuoi pool di nodi, segui questi passaggi:

    1. Fai clic su Aggiungi pool di nodi.
    2. Nella finestra di dialogo Modifiche necessarie, fai clic su Apporta modifiche.

    Nel menu di navigazione viene visualizzato un pool di nodi denominato default-pool.

  6. (Facoltativo) Per creare un cluster senza pool di nodi, segui questi passaggi:

    1. Nel menu di navigazione, fai clic su default-pool.
    2. Fai clic su Rimuovi node pool.
    3. Configura le restanti impostazioni del cluster e fai clic su Crea.
  7. (Facoltativo) Per aggiungere node pool al cluster, fai clic su Aggiungi node pool. Nel menu di navigazione viene visualizzato un nuovo pool di nodi.

  8. Configura le impostazioni di base per un pool di nodi:

    1. 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.
    2. Nel campo Nome, inserisci un nome per il pool di nodi.
    3. 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.
  9. Configura le impostazioni per le istanze VM che eseguono i nodi:

    1. Nel menu di navigazione, nella sezione espansa del pool di nodi selezionato, fai clic su Nodi.
    2. Nell'elenco a discesa Tipo di immagine, seleziona l'immagine del nodo.
    3. 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.
    4. Nell'elenco a discesa Tipo di disco di avvio, seleziona il tipo di disco.
    5. Nel campo Dimensione disco di avvio, specifica una dimensione in GB per il disco di avvio.
  10. Configura le impostazioni di sicurezza per il pool di nodi:

    1. Nel menu di navigazione, nella sezione espansa del pool di nodi selezionato, fai clic su Sicurezza.
    2. (Facoltativo) Specifica un account di servizio IAM personalizzato per i nodi:
      1. Nella pagina Impostazioni avanzate, espandi la sezione Sicurezza.
      2. 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.

  11. Fai clic su Crea.

Terraform

Per creare un cluster di zona con un pool di nodi a zona singola utilizzando Terraform, consulta l'esempio seguente:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-single-zone"
  location           = "us-central1-a"
  initial_node_count = 1
}

Per creare un cluster di zona con un pool di nodi multizona utilizzando Terraform, consulta l'esempio seguente:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-multi-zone"
  location           = "us-central1-a"
  node_locations     = ["us-central1-b", "us-central1-c"]
  initial_node_count = 2
}

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 di zona con zero nodi

In GKE versione 1.37.1-gke.1153000 e successive, puoi creare un cluster di zona senza 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 che non contiene 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 a livello di zona con zero nodi, seleziona una delle seguenti opzioni:

gcloud

  • Per saltare la creazione del pool di nodi predefinito, utilizza solo il flag --num-nodes=0 nel comando gcloud container clusters create:

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0
    

    Sostituisci quanto segue:

    • CLUSTER_NAME: il nome del nuovo cluster a livello di zona.
    • CONTROL_PLANE_LOCATION: la zona di Compute Engine del control plane del cluster, ad esempio us-central1-a.

    Se specifichi altri flag di configurazione del pool di nodi, come i flag --machine-type, --disk-type o --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=0 e --node-pool-name nel comando gcloud container clusters create:

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0 \
        --node-pool-name=NODEPOOL_NAME
    

    Sostituisci NODEPOOL_NAME con 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

  1. Nella console Google Cloud , vai alla pagina Crea un cluster Kubernetes.

    Vai a Crea un cluster Kubernetes

  2. Specifica un nome per il cluster.

  3. Nella sezione Tipo di località, seleziona A livello di zona.

  4. Nell'elenco a discesa Zona, seleziona una zona per il control plane del cluster.

  5. 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:

      1. Fai clic su Aggiungi pool di nodi.
      2. Nella finestra di dialogo Modifiche necessarie, fai clic su Apporta modifiche. Viene visualizzato un pool di nodi denominato default-pool.
      3. Nel menu di navigazione, fai clic su default-pool.
      4. 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:

      1. Fai clic su Aggiungi pool di nodi.
      2. Nella finestra di dialogo Modifiche necessarie, fai clic su Apporta modifiche. Viene visualizzato un pool di nodi denominato default-pool.
      3. Nel menu di navigazione, fai clic su default-pool.
      4. Nel campo Numero di nodi, specifica un valore pari a 0.
  6. 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 campo initial_node_count su un valore di 0.
  • Per creare un pool di nodi iniziale vuoto:

    1. Nella risorsa google_container_cluster, imposta il campo initial_node_count su un valore di 0.
    2. Aggiungi una risorsa google_container_node_pool e imposta il campo node_count sul valore 0.

Dopo aver creato un cluster con zero nodi, puoi eseguire il provisioning dei nodi nei seguenti modi:

Modelli di cluster

In precedenza, GKE supportava i template per i cluster. Questi modelli sono stati rimossi dalla console Google Cloud , ma sono ancora accessibili dai seguenti link:

Passaggi successivi