Installazione di Knative serving su VMware

Scopri come installare Knative serving nei tuoi cluster GKE all'esterno di Google Cloud. Knative serving ora utilizza i parchi risorse Cloud Service Mesh e GKE Enterprise. Scopri le novità e le modifiche con le installazioni del parco risorse Knative serving.

Avviso: eseguendo i passaggi in questa pagina verrà eseguita una nuova installazione di Knative serving su VMware e verrà sovrascritta in modo irreversibile la precedente installazione non del parco risorse. Non procedere con i passaggi seguenti nei cluster per i quali hai abilitato Knative serving in precedenza.

Per le precedenti installazioni in "prova gratuita" di Knative serving, devi prima eseguire l'upgrade di Knative serving su VMware per utilizzare i parchi risorse GKE Enterprise.

Utilizza i passaggi in questa pagina per configurare una nuova installazione o per aggiornare un'installazione del parco risorse esistente di Knative serving.

Prima di iniziare

Devi assicurarti di soddisfare i prerequisiti di installazione.

Configura la tua risorsa personalizzata CloudRun

Per configurare l'installazione, devi creare e configurare manualmente la risorsa personalizzata CloudRun.

Per creare manualmente una risorsa CloudRun personalizzata per i cluster GKE all'esterno di Google Cloud:

  1. Devi creare o disporre di un account di servizio esistente a cui è stato concesso il ruolo Writer metriche Monitoring richiesto (monitoring.metricWriter).

    • Per creare un nuovo account di servizio e scaricare la chiave, consulta Utilizzo degli account di servizio.

    • Se hai già un account di servizio con le autorizzazioni necessarie, individua la chiave che hai scaricato durante la creazione dell'account.

  2. Assicurati che Cloud Monitoring sia abilitato in GKE su VMware.

  3. Crea lo spazio dei nomi knative-serving:

    kubectl create namespace knative-serving

  4. Crea un secret nello spazio dei nomi knative-serving che contiene l'account di servizio con autorizzazioni monitoring.metricWriter:

    kubectl create secret -n knative-serving generic SECRET_NAME --from-file=PATH_TO_KEY_FILE/SECRET_KEY

    Sostituisci:

    • SECRET_NAME con il nome che hai scelto per il secret.
    • SECRET_KEY con il nome del file che include le tue credenziali. Esempio: key.json
    • PATH_TO_KEY_FILE con il percorso della directory di SECRET_KEY.

    Per saperne di più, consulta la sezione di riferimento di kubectl create secret, inclusi i flag facoltativi.

  5. Crea un file YAML con i seguenti attributi, ad esempio cloudrunanthos.yaml:

    apiVersion: operator.run.cloud.google.com/v1alpha1
kind: CloudRun
metadata:
  name: cloud-run
spec:
  metricscollector:
    stackdriver:
      projectid: PROJECT_ID
      gcpzone: CLUSTER_LOCATION
      clustername: CLUSTER_NAME
      secretname: SECRET_NAME
      secretkey: SECRET_KEY

    Sostituisci quanto segue:

    • PROJECT_ID con l'ID del tuo progetto Google Cloud.
    • CLUSTER_LOCATION con la regione o la zona in cui si trova il cluster.
    • CLUSTER_NAME con l'ID del cluster o l'identificatore completo del cluster.
    • SECRET_NAME con il nome del secret per l'account di servizio dello spazio dei nomi knative-serving.

    • SECRET_KEY con la chiave del secret per l'account di servizio dello spazio dei nomi knative-serving. Ad esempio: key.json

      Per maggiori dettagli sugli account di servizio, vedi:

    Esempio

    In questo esempio di risorsa personalizzata CloudRun, i dettagli di configurazione per Cloud Monitoring sono specificati in modo da utilizzare il secret my-gcp-logging-secret e la chiave key.json:

     apiVersion: operator.run.cloud.google.com/v1alpha1
 kind: CloudRun
 metadata:
   name: cloud-run
 spec:
   metricscollector:
     stackdriver:
       projectid: my-gcp-project-id
       gcpzone: us-central1-c
       clustername: my-anthos-cluster-name
       secretname: my-gcp-logging-secret
       secretkey: key.json
 ```

Abilita e installa Knative serving

Abilita il componente Knative serving nel tuo parco risorse GKE Enterprise, quindi esegui il deployment della tua risorsa personalizzata CloudRun:

  1. Abilita Knative serving nel tuo parco risorse:

    gcloud container fleet cloudrun enable --project=PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

    Per dettagli e opzioni aggiuntive, consulta la documentazione di riferimento gcloud container fleet cloudrun Enable.

  2. (Facoltativo) Verifica che il componente della funzionalità Knative serving sia abilitato:

    Console

    Vedi se il componente Knative serving è abilitato nella console Google Cloud:

    Vai a Gestore funzionalità

    Riga di comando

    Vedi se lo stato appdevexperience è ACTIVE:

    gcloud container fleet features list  --project=PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

    Per dettagli e opzioni aggiuntive, consulta la documentazione di riferimento gcloud container Fleet features list.

    Risultato:

    NAME               STATE
appdevexperience   ACTIVE

  3. Per ogni cluster GKE Enterprise in cui vuoi installare Knative serving, devi eseguire il deployment della tua risorsa personalizzata CloudRun:

    gcloud

    gcloud container fleet cloudrun apply --kubeconfig=KUBECONFIG --context=CONTEXT --config=CONFIG_FILE

    Sostituisci quanto segue:

    • KUBECONFIG con il percorso assoluto al tuo file di configurazione kubectl.
    • CONTEXT con il nome del contesto nel file kubectl di configurazione da usare per la connessione.
    • CONFIG_FILE con il percorso relativo del nome file della tua risorsa personalizzata cloudRun. Esempio: cloudrunanthos.yaml.

    Per dettagli e opzioni aggiuntive, consulta la documentazione di riferimento gcloud container fleet cloudrun apply.

    kubectl

    kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE

    Sostituisci quanto segue:

    • KUBECONFIG con il percorso assoluto al tuo file di configurazione kubectl.
    • CONFIG_FILE con il nome file e il percorso relativo della tua risorsa personalizzata cloudRun. Esempio: cloudrunanthos.yaml.

    Per dettagli e opzioni aggiuntive, consulta la documentazione di riferimento kubectl apply.

  4. Verifica che Knative serving sia stato abilitato nel tuo cluster:
    1. Apri la console Google Cloud:

      Vai ai cluster GKE

    2. Fai clic sul nome del cluster per aprire il riquadro dei dettagli.

    3. Esegui questo comando per verificare se riesci a vedere i dettagli della versione di Knative serving: kubectl get namespace knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. Verifica che tutti i deployment specifici di Knative serving siano in esecuzione negli spazi dei nomi knative-serving e appdevexperience.

Passaggi successivi

Configura la tua installazione di Knative serving.