Crea un cluster Autopilot


Questa pagina spiega come creare un cluster Google Kubernetes Engine (GKE) in modalità Autopilot. Autopilot è una modalità operativa di GKE che ti consente di concentrarti sui servizi e sulle applicazioni, mentre GKE gestisce i nodi e l'infrastruttura. Quando esegui il deployment dei carichi di lavoro, GKE esegue il provisioning, configura e gestisce le risorse e l'hardware, anche quando scala.

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
  • Se vuoi utilizzare Google Cloud CLI per questa attività, installa e quindi initialize gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo gcloud components update.

Crea un cluster Autopilot

Puoi creare un cluster Autopilot utilizzando Google Cloud CLI, la console Google Cloud oppure Terraform:

gcloud

Esegui questo comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del nuovo cluster Autopilot.
  • LOCATION: la regione per il cluster.
  • PROJECT_ID: il tuo ID progetto.

Facoltativamente, puoi utilizzare il flag --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com per specificare un account di servizio IAM diverso utilizzato dai nodi al posto dell'account di servizio predefinito di Compute Engine. Ti consigliamo vivamente di creare e utilizzare un account di servizio con privilegi minimi in modo che i nodi non dispongano di privilegi superiori a quelli necessari.

Per un elenco delle altre opzioni che puoi specificare, consulta la documentazione di riferimento di gcloud container clusters create-auto.

Console

Esegui le seguenti attività:

  1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

    Vai a Google Kubernetes Engine

  2. Fai clic su Crea.

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

  4. Inserisci il nome del cluster.

  5. Seleziona una regione per il tuo cluster.

    1. Facoltativo (disponibile con GKE Enterprise): se vuoi registrare il nuovo cluster in un parco risorse, vai alla sezione Registrazione del parco risorse e segui le istruzioni della console Google Cloud per creare e registrare un nuovo cluster per completare la registrazione del cluster.
  6. Nella sezione Networking, scegli una delle seguenti opzioni:

    • Per creare un cluster con un endpoint accessibile pubblicamente, scegli Cluster pubblico.
    • Se la tua organizzazione ha requisiti specifici di isolamento della rete, scegli Cluster privato. Per istruzioni sulla configurazione, consulta Creare un cluster privato.
  7. Facoltativamente, configura altre impostazioni, come periodi di manutenzione e funzionalità di sicurezza avanzate.

  8. Fai clic su Crea.

Terraform

Per creare un cluster Autopilot utilizzando Terraform, fai riferimento all'esempio seguente:

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-basic"
  location = "us-central1"

  enable_autopilot = true

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Per scoprire di più sull'utilizzo di Terraform, consulta Supporto Terraform per GKE.

Imposta la versione e il canale di rilascio di un nuovo cluster Autopilot

Per impostazione predefinita, GKE registra i nuovi cluster Autopilot nel canale di rilascio regolare, con la versione GKE predefinita nel canale. Puoi modificare il canale di rilascio quando crei un cluster Autopilot utilizzando gcloud CLI, la console Google Cloud oppure utilizzando Terraform.

Puoi anche impostare una versione GKE specifica quando crei un cluster utilizzando gcloud CLI. L'impostazione della versione del cluster è utile solo se hai un requisito di versione specifico. Per impostare la versione del cluster, specifica il flag --cluster-version nel comando gcloud container clusters create-auto. La versione specificata deve essere una versione GKE disponibile.

Le seguenti istruzioni per impostare il canale di rilascio e la versione sono facoltative. A meno che tu non abbia bisogno di una versione GKE specifica, consigliamo di mantenere l'impostazione predefinita del canale di rilascio.

gcloud

Esegui questo comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --release-channel=RELEASE_CHANNEL \

Sostituisci RELEASE_CHANNEL con il nome del canale di rilascio per il cluster. Il valore predefinito è Regular.

Facoltativamente, specifica --cluster-version=CLUSTER_VERSION, sostituendo CLUSTER_VERSION con la versione GKE del cluster, ad esempio 1.29.4-gke.1043002. La versione specificata verrà applicata finché una nuova versione non diventerà quella predefinita nel tuo canale di rilascio. GKE esegue quindi l'upgrade automatico del cluster alla nuova versione predefinita. Se ometti questo flag, GKE imposta la versione sulla versione predefinita del canale di rilascio.

Per verificare le versioni disponibili, consulta Quali versioni sono disponibili in un canale?. Puoi eseguire qualsiasi versione secondaria nel canale selezionato o scegliere un sottoinsieme di versioni patch di altri canali.

Console

Per impostare il canale di rilascio quando crei un cluster Autopilot, segui questi passaggi:

  1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

    Vai a Google Kubernetes Engine

  2. Fai clic su Crea.

  3. Per Autopilot, fai clic su Configura.

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

    1. Specifica un Nome.
    2. Seleziona una Regione.
  5. Nella sezione Impostazioni avanzate, scegli un canale di rilascio.

  6. Fai clic su Crea.

Terraform

Per impostare il canale di rilascio e la versione del cluster quando crei un cluster Autopilot utilizzando Terraform, fai riferimento all'esempio seguente:

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-release-channel"
  location = "us-central1"

  enable_autopilot = true

  release_channel {
    channel = "REGULAR"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Per scoprire di più sull'utilizzo di Terraform, consulta Supporto Terraform per GKE.

Puoi anche modificare il canale di rilascio e la versione GKE per i cluster esistenti. Per le istruzioni, consulta Eseguire manualmente l'upgrade di un piano di controllo e Selezionare un nuovo canale di rilascio.

Connettiti al cluster

gcloud

gcloud container clusters get-credentials CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Questo comando configura kubectl in modo che utilizzi il cluster che hai creato.

Console

  1. Nell'elenco dei cluster, accanto al cluster a cui vuoi connetterti, fai clic su Azioni e poi su Connetti.

  2. Quando richiesto, fai clic su Esegui in Cloud Shell. Il comando generato viene copiato in Cloud Shell, ad esempio:

    gcloud container clusters get-credentials autopilot-cluster --location=us-central1 --project=autopilot-test
    
  3. Premi Invio per eseguire il comando.

Verifica la modalità cluster

Puoi verificare che il tuo cluster sia un cluster Autopilot utilizzando gcloud CLI o la console Google Cloud.

gcloud

Per verificare che il cluster sia creato in modalità Autopilot, esegui questo comando:

gcloud container clusters describe CLUSTER_NAME \
    --location=LOCATION

L'output contiene quanto segue:

autopilot:
  enabled: true

Console

Per verificare che il cluster sia creato in modalità Autopilot, segui questi passaggi:

  1. Nell'elenco dei cluster, fai clic sul nome del cluster.
  2. Nella sezione Automazione, controlla se il campo Provisioning automatico dei nodi (modalità Autopilot) è impostato su Abilitato.

Passaggi successivi