Upgrade di Knative serving su Google Cloud ai parchi risorse

Utilizza questa guida per eseguire la migrazione della tua installazione esistente di Knative serving su Google Cloud in modo da utilizzare un parco risorse con Cloud Service Mesh.

La precedente versione di "prova gratuita" di Knative serving, denominata anche "componente aggiuntivo GKE", include una versione integrata ed essenziale di Istio 1.4, che non è più supportata a partire da Anthos.

L'upgrade dell'installazione di Knative serving per l'utilizzo di parchi risorse e Cloud Service Mesh offre una migliore indipendenza nella gestione e upgrade dei prodotti, nonché una migliore integrazione tra le funzionalità di GKE Enterprise. Scopri di più sulle novità e sulle modifiche.

Importante: Anthos versione 1.8 richiede la migrazione delle installazioni precedenti di Knative serving (chiamato anche "componente aggiuntivo GKE") per utilizzare i parchi risorse e Cloud Service Mesh. Prima di eseguire l'upgrade del tuo ambiente GKE Enterprise alla versione 1.8 o successiva, devi eseguire questo processo di migrazione per eseguire l'upgrade delle installazioni esistenti di Knative serving.

Sono disponibili due percorsi per la migrazione dell'installazione:

• La procedura consigliata consiste nella migrazione dei carichi di lavoro dal cluster in cui è installata la versione precedente di Knative serving ("componente aggiuntivo GKE") a un nuovo cluster in cui hai installato e configurato una nuova installazione del parco risorse di Knative serving. Sebbene questo processo sia relativamente semplice e ideale, se i tuoi carichi di lavoro gestiscono il traffico, la migrazione a un cluster appena creato causerà tempi di inattività. Per eseguire questo percorso di migrazione, nel nuovo cluster devi:

  1. Installa Knative serving come componente del parco risorse.

  2. Esegui il deployment dei servizi nella nuova installazione.

     Ad esempio, puoi utilizzare le istruzioni per eseguire il deployment di una revisione di un servizio esistente per scaricare singolarmente un file di configurazione YAML per ciascuno dei tuoi servizi, quindi eseguire il deployment di ogni file YAML nel nuovo cluster nell'installazione del parco risorse di Knative serving:

     1. Nella precedente installazione, puoi eseguire questo comando per scaricare un file di configurazione YAML, come service.yaml:

        gcloud run services describe SERVICE --format export > service.yaml

        Sostituisci SERVICE con il nome del tuo servizio Knative serving.

     2. Nella nuova installazione dei componenti del parco risorse, puoi eseguire questo comando per eseguire il deployment dello stesso service.yaml:

        gcloud run deploy service.yaml --cluster CLUSTER_NAME --cluster-location CLUSTER_LOCATION --project PROJECT_ID

        Sostituisci:

        • CLUSTER_NAME con il nome del cluster nella nuova installazione dei componenti del parco risorse di Knative serving.

        • CLUSTER_LOCATION con la zona o regione del cluster nella nuova installazione dei componenti del parco risorse di Knative serving.

        • PROJECT_ID con l'ID del progetto Google Cloud in cui risiede l'installazione dei nuovi componenti del parco risorse di Knative serving.

• Alternativa: per gli utenti che non sono in grado di creare un nuovo cluster e devono eseguire la migrazione della loro installazione attiva di Knative serving, puoi seguire i passaggi di questa guida per:

  • Rimuovi le risorse "componente aggiuntivo GKE" e le risorse Istio precedenti.
  • Installa nuove risorse del parco risorse.
  • Esegui la migrazione a Cloud Service Mesh e poi del traffico.
  • Elimina tutte le risorse obsolete e inutilizzate.

La seguente guida illustra il processo alternativo di upgrade dell'installazione esistente e attiva di Knative serving, inclusi tutti i carichi di lavoro, per soddisfare i requisiti di GKE Enterprise 1.8 e versioni successive.

Prima di iniziare

• Questo processo di upgrade deve essere eseguito solo sui cluster Google Kubernetes Engine in cui Knative serving era precedentemente installato come "componente aggiuntivo GKE".

  Controlla se il "componente aggiuntivo GKE" è installato.

  Per verificare se la tua installazione di Knative serving è del "componente aggiuntivo GKE", esegui questo comando:

  gcloud container clusters describe \
  CLUSTER_NAME \
  --region CLUSTER_LOCATION \
  --project PROJECT_ID --format='get(addonsConfig.cloudRunConfig)'
  

  Sostituisci:

  • CLUSTER_NAME con il nome del tuo cluster.
  • CLUSTER_LOCATION con la località in cui si trova il cluster.
  • PROJECT_ID con l'ID del tuo progetto Google Cloud.

  Risultati:

  • "Componente aggiuntivo GKE" non installato:
    • Se il componente aggiuntivo non è mai stato installato, non viene restituito nulla al terminale.
    • Se il componente aggiuntivo è stato disinstallato in precedenza, viene restituito disabled=true.
  • Il"componente aggiuntivo GKE" è installato: se il componente aggiuntivo è installato nel cluster, vengono restituiti i dettagli di configurazione del componente aggiuntivo. Esempio: loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

  Esempio:

  L'esempio seguente mostra che Knative serving è stato installato nel cluster my-addon-cluster tramite il "componente aggiuntivo GKE", configurato per gestire il traffico esterno:

  gcloud container clusters describe my-addon-cluster \
  --region us-central1-c --project my-gcp-project \
  --format='get(addonsConfig.cloudRunConfig)'
  

  Risposta:

  loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL
  

• Devi disporre di autorizzazioni adeguate nel progetto Google Cloud per soddisfare i requisiti per il cluster, il parco risorse e Cloud Service Mesh:

  • Se hai il ruolo Proprietario per il progetto Google Cloud, disponi di autorizzazioni superiori al necessario per creare cluster, installare e configurare Knative serving.

  • Tieni presente che i requisiti delle autorizzazioni di Cloud Service Mesh soddisfano anche tutti i requisiti di autorizzazione per l'installazione e la configurazione di Knative serving.

  • Utilizzo di altri ruoli e requisiti minimi:

    A seconda della tua organizzazione, puoi anche soddisfare i requisiti di autorizzazione tramite una combinazione dei seguenti ruoli predefiniti:

    • Autorizzazioni del progetto Google Cloud: ruolo Editor di base

    • Autorizzazioni del parco risorse: Amministratore GKE Hub o un ruolo che include le seguenti autorizzazioni:

      • gkehub.features.create
      • gkehub.features.update

    • Autorizzazioni cluster: Un ruolo di amministratore di Kubernetes Engine:

      • Amministratore Kubernetes Engine
      • Amministratore cluster Kubernetes Engine

• È supportata solo Cloud Service Mesh versione 1.18.

  • Cloud Service Mesh richiede che il cluster utilizzi un tipo di macchina con almeno 4 vCPU, ad esempio e2-standard-4. Consulta la guida all'installazione di Cloud Service Mesh per i dettagli sui requisiti. Se devi modificare il tipo di macchina del cluster esistente, consulta Migrazione dei carichi di lavoro a tipi di macchine diversi.

  • L'utilizzo di Cloud Shell è consigliato per eseguire i comandi e lo script di migrazione durante questo processo. Tieni presente che lo script di installazione di Cloud Service Mesh supporta solo Linux o Cloud Shell.

  • Se la tua installazione esistente di Knative serving utilizza il componente aggiuntivo Istio su GKE, devi eseguire la migrazione al piano di controllo gestito di Cloud Service Mesh. La migrazione dal componente aggiuntivo Istio su GKE al piano di controllo in-cluster Cloud Service Mesh non è attualmente supportata.

Upgrade di Knative serving e migrazione dei carichi di lavoro

Per facilitare l'upgrade dell'installazione esistente di Knative serving e la migrazione dei carichi di lavoro, esegui uno script che automatizza la maggior parte dei passaggi e richiede l'input durante il processo.

Nota: in ciascuna delle fasi seguenti, sono disponibili opzioni per il rollback. C'è anche un passaggio finale per il quale le risorse vengono eliminate e i rollback non sono più possibili.

Importante: devi seguire ogni passaggio di questa procedura nell'ordine elencato.

1. Prepararsi per l'upgrade e configurare l'ambiente

2. Disinstalla il componente aggiuntivo GKE

3. Eseguire la migrazione a Cloud Service Mesh

   • Disinstalla il componente aggiuntivo Istio per Cloud Service Mesh

   • Eseguire la migrazione da Istio in bundle a Cloud Service Mesh

   • Eseguire la migrazione dal componente aggiuntivo Istio a Cloud Service Mesh

4. Installa il componente del parco risorse

5. Eseguire la migrazione del traffico dei carichi di lavoro in Cloud Service Mesh

6. Finalizza l'upgrade ed esegui attività di pulizia