Installazione di Knative serving al di fuori di Google Cloud

Scopri come installare Knative serving nei cluster GKE esterni Google Cloud. Knative serving ora utilizza Cloud Service Mesh e i parchi risorse GKE Enterprise. Scopri le novità e le modifiche apportate alle installazioni del parco risorse Knative serving .

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

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

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

Prima di iniziare

Devi assicurarti di soddisfare i prerequisiti di installazione.

Configurare la risorsa personalizzata CloudRun

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

Per creare manualmente una risorsa personalizzata CloudRun per i cluster GKE esterni Google Cloud:

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

    • Per creare un nuovo account di servizio e scaricare la chiave, consulta Utilizzare i 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 cluster GKE:

  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 saperne 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 Google Cloud progetto.
    • 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 il account di servizio dello spazio dei nomi knative-serving

    • SECRET_KEY con la chiave del secret per il account di servizio de llo spazio dei nomi knative-serving. Esempio: key.json

      Per informazioni dettagliate sui service account, consulta:

    Esempio

    In questa risorsa personalizzata CloudRun, i dettagli di configurazione per Cloud Monitoring vengono 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
 ```

Abilitare e installare Knative serving

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

  1. Abilita Knative serving nel parco risorse:

    gcloud container fleet cloudrun enable --project=PROJECT_ID

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

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

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

    Console

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

    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 Google Cloud progetto.

    Per dettagli e opzioni aggiuntive, consulta il 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 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 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 della 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 kubectl.
    • CONFIG_FILE con il nome file e il percorso relativo della 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 Google Cloud console:

      Vai a 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.