Installazione di Knative serving al di fuori di Google Cloud

Scopri come installare Knative serving nei tuoi cluster GKE al di fuori Google Cloud. Knative serving ora utilizza Cloud Service Mesh e i parchi risorse GKE Enterprise. Scopri le novità e le modifiche apportate alle installazioni di Knative serving della flotta.

Per Knative serving su VMware, consulta la guida all'installazione a livello GA.

Il supporto per i seguenti cluster GKE è disponibile in anteprima:

• GKE su AWS
• GKE su Azure
• Google Distributed Cloud
• Cluster collegati a GKE Enterprise

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

Prima di iniziare

Devi assicurarti di soddisfare i prerequisiti di installazione.

Configura la risorsa personalizzata CloudRun

Devi creare e configurare manualmente la risorsa personalizzata CloudRun per configurare l'installazione.

Per creare manualmente una risorsa personalizzata CloudRunper i cluster GKE al di fuori Google Cloud:

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

   • Per creare un nuovo account di servizio e scaricare la chiave, vedi Utilizzo dei service account.

   • Se hai un account di servizio esistente con le autorizzazioni necessarie, individua la chiave che hai scaricato quando hai creato il account di servizio.

2. Assicurati che Cloud Monitoring sia abilitato nel tuo cluster GKE:

   • GKE su AWS
   • GKE su Azure
   • Google Distributed Cloud
   • Cluster collegati a GKE Enterprise

3. Crea lo spazio dei nomi knative-serving:

   kubectl create namespace knative-serving
   

4. Crea un secret nello spazio dei nomi knative-serving che contenga il account di servizio con le 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 scegli 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 scoprire di più, inclusi i flag facoltativi, consulta il riferimento kubectl create secret.

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 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 il account di servizio dello spazio dei nomi knative-serving. Ad esempio: key.json.

     Per maggiori dettagli sui service account, vedi:

     • Creazione di service account
     • Creazione delle chiavi dell'account di servizio
   Esempio

   In questo esempio di risorsa personalizzata CloudRun, i dettagli di configurazione per Cloud Monitoring sono specificati per 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
    ```
   

Attivare e installare Knative serving

Abilita il componente Knative Serving nel tuo parco risorse GKE Enterprise e poi esegui il deployment della risorsa personalizzata CloudRun:

1. Abilita Knative serving nel tuo parco dispositivi:

   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 il riferimento gcloud container fleet cloudrun enable.

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

   Console

   Controlla se il componente Knative serving è abilitato nella consoleGoogle Cloud :

   Vai a Gestore funzionalità

   Riga di comando

   Visualizza se lo stato di 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 il riferimento all'elenco delle funzionalità di gcloud container fleet.

   Risultato:

   NAME               STATE
   appdevexperience   ACTIVE
   

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

   gcloud

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

   Sostituisci quanto segue:

   • KUBECONFIG con il percorso assoluto del file di configurazione di kubectl.
   • CONTEXT con il nome del contesto nel file di configurazione kubectl da utilizzare per la connessione.
   • CONFIG_FILE con il percorso relativo del nome file alla risorsa personalizzata cloudRun. Esempio cloudrunanthos.yaml.

   Per dettagli e opzioni aggiuntive, consulta il riferimento gcloud container fleet cloudrun apply.

   kubectl

   kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE
   

   Sostituisci quanto segue:

   • KUBECONFIG con il percorso assoluto del file di configurazione di kubectl.
   • CONFIG_FILE con il nome file e il percorso relativo alla tua risorsa personalizzata cloudRun. Esempio cloudrunanthos.yaml.

   Per dettagli e opzioni aggiuntive, consulta il riferimento kubectl apply.

4. Verifica che Knative Serving sia stato abilitato nel 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 visualizzare i dettagli della versione di Knative serving: kubectl get all -n knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
   4. Verifica che tutti i deployment specifici di Knative Serving siano in stato di esecuzione negli spazi dei nomi knative-serving e appdevexperience.

Passaggi successivi

Configura l'installazione di Knative serving.