Configurazione di Knative serving

Scopri come impostare e configurare la tua installazione di Knative serving.

Prima di iniziare

Devi aver installato Knative serving sul tuo cluster GKE. Consulta la guida all'installazione per i dettagli sui prerequisiti dei cluster GKE e su come installare Knative serving.

Configurazione dell'autenticazione con Workload Identity

Puoi utilizzare Workload Identity per autenticare i tuoi servizi Knative serving nelle API e nei servizi Google Cloud. Devi configurare Workload Identity prima di eseguire il deployment dei servizi nel cluster, altrimenti è necessario eseguire la migrazione di ogni servizio esistente nel cluster prima dell'abilitazione di Workload Identity. Scopri di più sull'utilizzo di Workload Identity.

Abilitazione delle metriche con Workload Identity in corso...

Per abilitare metriche come il reporting del conteggio delle richieste o della latenza delle richieste a Google Cloud Observability, devi impostare manualmente le autorizzazioni di scrittura per Cloud Monitoring. Per maggiori dettagli, consulta Attivazione delle metriche con Workload Identity.

Configurazione di HTTPS e di domini personalizzati

Per attivare HTTPS e impostare un dominio personalizzato, consulta le seguenti pagine:

Configurazione di Cloud Service Mesh

Per configurare le opzioni di Cloud Service Mesh per Knative serving, consulta la pagina relativa alle opzioni del piano di controllo in-cluster, che include informazioni su come configurare una rete interna privata.

Configurazione di una rete interna privata

Il deployment di servizi su una rete interna è utile per le aziende che forniscono app interne al proprio personale e per i servizi utilizzati dai client che vengono eseguiti al di fuori del cluster Knative serving. Questa configurazione consente ad altre risorse nella tua rete di comunicare con il servizio utilizzando un indirizzo IP interno privato (RFC 1918) non accessibile al pubblico.

Per creare la tua rete interna, configura Cloud Service Mesh in modo che utilizzi il bilanciamento del carico TCP/UDP interno anziché un bilanciatore del carico di rete pubblico esterno. Puoi quindi eseguire il deployment dei servizi Knative serving su un indirizzo IP interno della tua rete VPC.

Prima di iniziare

Per configurare il bilanciatore del carico interno:

  1. Attiva la funzionalità del bilanciatore del carico interno in Cloud Service Mesh.

    Il bilanciatore del carico interno è una funzionalità facoltativa che puoi configurare durante l'installazione di Cloud Service Mesh o aggiornando l'installazione esistente.

    Segui i passaggi descritti in Abilitare funzionalità facoltative sul piano di controllo nel cluster e assicurati di includere l'opzione dello script --option internal-load-balancer.

    Quando specifichi l'opzione --option internal-load-balancer, lo script recupera automaticamente la risorsa personalizzata Abilita un bilanciatore del carico interno da GitHub. Se devi modificare la risorsa personalizzata, segui invece le istruzioni per utilizzare l'opzione --custom_overlay.

  2. Esegui questo comando per osservare gli aggiornamenti al tuo cluster GKE:

    kubectl -n INGRESS_NAMESPACE get svc istio-ingressgateway --watch

    Sostituisci INGRESS_NAMESPACE con lo spazio dei nomi del tuo servizio in entrata Cloud Service Mesh. Specifica istio-system se hai installato Cloud Service Mesh utilizzando la configurazione predefinita.

    1. Osserva l'annotazione cloud.google.com/load-balancer-type: Internal.
    2. Cerca il valore IP nel bilanciatore del carico Ingress per passare a un indirizzo IP privato.
    3. Premi Ctrl+C per interrompere gli aggiornamenti quando vedi un indirizzo IP privato nel campo IP.

  3. Per i cluster privati su Google Cloud, devi aprire le porte. Per maggiori dettagli, consulta l'apertura delle porte sul tuo cluster privato nella documentazione di Cloud Service Mesh.

Per verificare la connettività interna dopo le modifiche:

  1. Esegui il deployment di un servizio denominato sample in Knative serving nello spazio dei nomi default:

    gcloud run deploy sample \
--image gcr.io/knative-samples/helloworld \
--namespace default
--platform gke

  2. Crea una macchina virtuale (VM) Compute Engine nella stessa zona del cluster GKE:

    VM=cloudrun-gke-ilb-tutorial-vm

gcloud compute instances create $VM

  3. Archivia l'indirizzo IP privato del gateway Istio Ingress in una variabile di ambiente denominata EXTERNAL_IP e in un file denominato external-ip.txt:

    export EXTERNAL_IP=$(kubectl -n INGRESS_NAMESPACE get svc istio-ingressgateway \
    -o jsonpath='{.status.loadBalancer.ingress[0].ip}' | tee external-ip.txt)

    Sostituisci INGRESS_NAMESPACE con lo spazio dei nomi del tuo servizio in entrata Cloud Service Mesh. Specifica istio-system se hai installato Cloud Service Mesh utilizzando la configurazione predefinita.

  4. Copia il file contenente l'indirizzo IP sulla VM:

    gcloud compute scp external-ip.txt $VM:~

  5. Connettiti alla VM tramite SSH:

    gcloud compute ssh $VM

  6. Mentre sei nella sessione SSH, prova il servizio di esempio:

    curl -s -w'\n' -H Host:sample.default.nip.io $(cat external-ip.txt)

    L'output è il seguente:

    Hello World!

  7. Esci dalla sessione SSH:

    exit

Configurazione di un ambiente multi-tenant

Nei casi d'uso multi-tenant, dovrai gestire ed eseguire il deployment di servizi Knative serving in un cluster Google Kubernetes Engine all'esterno del tuo progetto attuale. Per ulteriori informazioni sulla multitenancy di GKE, consulta Multitenancy dei cluster.

Per scoprire come configurare l'architettura multi-tenancy per Knative serving, vedi Multitenancy tra progetti.

Passaggi successivi