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 per utilizzare un parco risorse con Cloud Service Mesh.

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

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

Importante: Anthos versione 1.8 richiede che le installazioni precedenti di Le funzionalità Knative serving (chiamate anche "componenti aggiuntivi di GKE") ha eseguito la migrazione ai parchi risorse e Cloud Service Mesh. Prima di eseguire l'upgrade del tuo ambiente GKE Enterprise Versione 1.8 o successiva, devi prima eseguire questo processo di migrazione per eseguire l'upgrade le tue installazioni esistenti di Knative serving.

Sono disponibili due percorsi per la migrazione dell'installazione:

• La procedura consigliata è la migrazione dei carichi di lavoro dal cluster in cui viene installata la versione precedente di Knative serving ("componente aggiuntivo GKE") in un nuovo cluster in cui hai installato e configurato una nuova installazione del parco risorse di Knative serving. Sebbene questa procedura sia relativamente semplice e ideale, se i tuoi carichi di lavoro gestiscono traffico, eseguendo la migrazione a un cluster appena creato causeranno 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 il deployment di una revisione di un servizio esistente scaricare singolarmente un file di configurazione YAML ed eseguire il deployment di ogni file YAML nel nuovo cluster installazione di Knative serving nel parco risorse:

     1. Nella vecchia installazione puoi eseguire il comando seguente per scarica un file di configurazione YAML, ad esempio 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 quanto segue 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 nel nuovo l'installazione di componenti nel parco risorse di Knative serving.

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

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

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

  • Rimuovi il "componente aggiuntivo GKE" precedente e le risorse Istio.
  • 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 la procedura alternativa di upgrade del tuo 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 su cluster Google Kubernetes Engine che Knative serving installato in precedenza come "Componente aggiuntivo GKE".

  Controlla se il "componente aggiuntivo GKE" sono installato.

  Per verificare se la tua installazione di Knative serving è "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 località in cui si trova il cluster.
  • PROJECT_ID con l'ID del tuo progetto Google Cloud.

  Risultati:

  • "Componente aggiuntivo GKE" non installata:
    • 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.
  • "Componente aggiuntivo GKE" è installato: se il componente aggiuntivo è installato in 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 nella my-addon-cluster tramite il "componente aggiuntivo GKE", che è configurata 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 delle autorizzazioni adeguate nel tuo progetto Google Cloud per soddisfare i requisiti per il tuo cluster, parco risorse e Cloud Service Mesh:

  • Se hai il ruolo di Proprietario per il progetto Google Cloud, avrai più autorizzazioni del necessario creare i cluster, installare e configurare Knative serving.

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

  • Utilizzo di altri ruoli e requisiti minimi:

    A seconda della tua organizzazione, puoi anche ottenere l'autorizzazione tramite una combinazione dei seguenti ruoli predefiniti:

    • Autorizzazioni del progetto Google Cloud: ruolo Editor di base

    • Autorizzazioni 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

• Solo Cloud Service Mesh versione 1.18 è supportato.

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

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

  • Se la tua installazione esistente di Knative serving utilizza la classe Per il componente aggiuntivo Istio on GKE, devi eseguire la migrazione Piano di controllo gestito da Cloud Service Mesh. Esegui la migrazione dal componente aggiuntivo Istio su GKE al Piano di controllo nel cluster di Cloud Service Mesh non è attualmente supportato.

Upgrade di Knative serving e migrazione dei carichi di lavoro

Per aiutarti a eseguire l'upgrade dell'installazione esistente di Knative serving e dei carichi di lavoro, esegui uno script che automatizza la maggior parte dei passaggi richiede 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 possibile.

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