Personalizzazione dell'installazione di Google Cloud

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

Utilizza questa pagina per personalizzare una nuova installazione o per configurare un'installazione di Knative serving esistente nel parco risorse. Ad esempio, puoi configurare i cluster privati o impostare le credenziali di Cloud Monitoring.

I passaggi di installazione predefiniti eseguono automaticamente il deployment della seguente CloudRun risorsa personalizzata, che abilita le metriche sui cluster GKE Enterprise su Google Cloud:

  apiVersion: operator.run.cloud.google.com/v1alpha1
  kind: CloudRun
  metadata:
    name: cloud-run

Per scoprire di più sulle risorse personalizzate in generale, consulta Risorse personalizzate.

Prima di iniziare

• Devi assicurarti di soddisfare i prerequisiti di installazione.

• Se Knative serving è installato nel cluster, devi assicurarti che il "componente aggiuntivo GKE" non esista prima di eseguire questi passaggi di installazione del componente del parco risorse. Se hai installato il "componente aggiuntivo", devi invece seguire i passaggi per l'upgrade ai parchi risorse GKE Enterprise fleets.

  Controlla se è installato il "componente aggiuntivo GKE".

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

  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.
  • "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 my-addon-cluster 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

Configura 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 su Google Cloud:

1. Crea un file YAML e includi la configurazione predefinita, ad esempio cloudrunanthos.yaml:

   apiVersion: operator.run.cloud.google.com/v1alpha1
   kind: CloudRun
   metadata:
     name: cloud-run
   

2. In cloudrunanthos.yaml, personalizza l'installazione configurando uno o più dei seguenti attributi in una sezione spec:

   • Cluster privati: devi aggiungere lclusterConfig e lisPrivate insieme di attributi per installare Knative serving su cluster privati su Google Cloud.

     Gli attributi clusterConfig e isPrivate:

     spec:
       clusterConfig:
         isPrivate: true
     

     Tieni presente che questa impostazione disabilita Managed TLS perché i cluster privati non sono in grado di comunicare con l'autorità di certificazione per impostazione predefinita.

   • Metriche: aggiungi l'insieme di attributi metricscollector per configurare Cloud Monitoring. Per impostazione predefinita, le metriche sono abilitate per GKE Enterprise sui cluster Google Cloud.

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

       Per maggiori dettagli sui service account, consulta:

       • Creazione di service account
       • Creazione di account di servizio account

Esempio

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

Abilita e installa 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 maggiori 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 maggiori 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 --gke-cluster=CLUSTER_LOCATION/CLUSTER_NAME --config=CONFIG_FILE
   

   Sostituisci quanto segue:

   • 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.
   • CONFIG_FILE con il percorso relativo del nome file alla risorsa personalizzata cloudRun. Esempio cloudrunanthos.yaml.

   Per maggiori 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 risorsa personalizzata cloudRun. Esempio cloudrunanthos.yaml.

   Per maggiori 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 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.