Crea un cluster Autopilot

Questa pagina spiega come creare un cluster Autopilot Google Kubernetes Engine (GKE) dedicato. Autopilot è una modalità operativa di GKE che ti consente di concentrarti sui tuoi servizi e sulle tue applicazioni, mentre GKE gestisce i nodi e l'infrastruttura. Quando esegui il deployment dei workload, GKE esegue il provisioning, la configurazione e la gestione delle risorse e dell'hardware, anche quando esegui la scalabilità.

Quando crei un cluster Autopilot dedicato, la modalità del cluster è permanente e non puoi disattivare le impostazioni Autopilot preconfigurate. Per un'alternativa più flessibile che ti consenta di modificare o disattivare singole impostazioni di Autopilot, puoi configurare un cluster Standard in modo che utilizzi Autopilot per impostazione predefinita.

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@developer.gserviceaccount.com
    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@developer.gserviceaccount.com" \
        --role="roles/container.defaultNodeServiceAccount"

    Sostituisci PROJECT_NUMBER con il numero di progetto del passaggio precedente.

Crea un cluster Autopilot

Le informazioni minime da specificare durante la creazione di un nuovo cluster Autopilot sono un nome, un progetto (di solito il progetto corrente) e una regione (di solito la regione predefinita per gli strumenti a riga di comando). Tuttavia, esistono molte altre impostazioni di configurazione possibili, alcune delle quali 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-auto e Terraform google_container_cluster.

Puoi creare un cluster Autopilot utilizzando Google Cloud CLI, la console Google Cloud o 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 del tuo cluster.
  • PROJECT_ID: il tuo ID progetto.

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

Sostituisci SERVICE_ACCOUNT_NAME con il nome del tuo service account con privilegi minimi.

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

Console

Esegui le seguenti attività:

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

    Vai a Crea un cluster Autopilot

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

  3. Inserisci il nome del cluster.

  4. Seleziona una regione per il cluster.

    1. (Facoltativo) 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.
  5. Per la sezione Networking, consulta Personalizza l'isolamento della rete per le istruzioni di configurazione.

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

  7. Facoltativamente, configura altre impostazioni, come i periodi di manutenzione e le funzionalità di sicurezza avanzate.

  8. Fai clic su Crea.

Terraform

Per creare un cluster Autopilot minimo utilizzando Terraform, consulta il seguente esempio:

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

  enable_autopilot = true
}

Per creare un cluster Autopilot che utilizza un account di servizio IAM personalizzato, segui questi passaggi:

  1. Crea un account di servizio IAM e concedigli il ruolo roles/container.defaultNodeServiceAccount nel progetto:

    resource "google_service_account" "default" {
      account_id   = "gke-node-service-account"
      display_name = "GKE node service account"
    }
    
    data "google_project" "project" {
    }
    
    resource "google_project_iam_member" "default" {
      project = data.google_project.project.project_id
      role    = "roles/container.defaultNodeServiceAccount"
      member  = "serviceAccount:${google_service_account.default.email}"
    }
  2. Crea un cluster Autopilot che utilizzi il nuovo account di servizio:

    resource "google_container_cluster" "default" {
      name     = "autopilot-custom-account"
      location = "us-central1"
    
      enable_autopilot = true
    
      cluster_autoscaling {
        auto_provisioning_defaults {
          service_account = google_service_account.default.email
        }
      }
    }

L'esempio in questa pagina riguarda il provisioning di un cluster Autopilot di base. Per un esempio end-to-end che configura una rete VPC personalizzata ed esegue il deployment di un workload di esempio, consulta Crea un cluster ed esegui il deployment di un workload utilizzando Terraform. Per ulteriori informazioni sull'utilizzo di Terraform, consulta Esegui il provisioning delle risorse GKE con Terraform.

Crea un cluster Autopilot con un canale di rilascio e una versione specifici

Per impostazione predefinita, GKE registra i nuovi cluster Autopilot nel canale di rilascio Regular, 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 o Terraform.

Puoi anche impostare una versione specifica di GKE 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 l'impostazione del canale di rilascio e della versione sono facoltative. A meno che tu non abbia bisogno di una versione specifica di GKE, ti 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.

Se vuoi, specifica --cluster-version=CLUSTER_VERSION, sostituendo CLUSTER_VERSION con la versione di GKE per il cluster, ad esempio 1.29.4-gke.1043002. La versione specificata viene applicata finché una versione più recente non diventa 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 controllare 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 durante la creazione di un cluster Autopilot, segui questi passaggi:

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

    Vai a Crea un cluster Autopilot

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

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

  4. Facoltativamente, configura altre impostazioni per il nuovo cluster.

  5. 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 al seguente esempio:

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

  enable_autopilot = true

  release_channel {
    channel = "REGULAR"
  }
}

Per scoprire di più sull'utilizzo di Terraform, consulta Esegui il provisioning delle risorse GKE con Terraform.

Puoi anche modificare il canale di rilascio e la versione di GKE per i cluster esistenti. Per istruzioni, consulta Esegui l'upgrade manuale di un control plane e Seleziona 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-east4 --project=autopilot-test
    
  3. Premi Invio per eseguire il comando.

Verifica la modalità del 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 stato 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 stato creato in modalità Autopilot, segui questi passaggi:

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

    Vai a Google Kubernetes Engine

  2. Trova il tuo cluster nell'elenco dei cluster. In Modalità, dovrebbe essere visualizzato Autopilot.

Passaggi successivi