Deployment dell'esempio Bookinfo
Questa pagina spiega come eseguire il deployment di un'applicazione di esempio per dimostrare Cloud Service Mesh. Se non hai installato Cloud Service Mesh, consulta la guida all'installazione.
L'installazione di Cloud Service Mesh include diverse applicazioni di esempio. Questa
guida illustra la procedura di deployment dell'esempio
BookInfo. Si tratta di una semplice applicazione simulata di una libreria composta da quattro servizi
che forniscono una pagina di prodotto web, dettagli dei libri, recensioni (con diverse versioni del servizio di recensione) e valutazioni, il tutto gestito utilizzando Cloud Service Mesh. Puoi trovare il codice sorgente e tutti gli altri file utilizzati in questo esempio nella directory dell'installazione di Cloud Service Mesh in samples/bookinfo
.
Attivazione dell'iniezione automatica di sidecar
Per attivare l'iniezione automatica dei sidecar, devi etichettare gli spazi dei nomi in modo che il webhook dell'iniettore sidecar associ i sidecar iniettati a una determinata revisione del piano di controllo. Se configuri il tag predefinito, etichetta gli spazi dei nomi con le etichette di inserimento predefinite. In caso contrario, etichetta gli spazi dei nomi con l'etichetta di revisione. Inoltre, l'etichetta che aggiunti dipende anche dal fatto che tu abbia implementato Cloud Service Mesh gestito o installato il control plane in-cluster.
Gestito
Puoi utilizzare l'etichetta di inserimento predefinita o l'etichetta di revisione per lo spazio dei nomi
Etichette di inserimento predefinite
Applica lo spazio dei nomi all'etichetta di inserimento predefinita.
kubectl label namespace NAMESPACE istio-injection=enabled istio.io/rev-
Etichetta revisione
Prima di eseguire il deployment delle applicazioni, rimuovi eventuali etichette
istio-injection
precedenti dai relativi spazi dei nomi e imposta l'etichettaistio.io/rev=REVISION_LABEL
.Per modificarla in un'etichetta di revisione specifica, fai clic su
REVISION_LABEL
e sostituiscila con l'etichetta applicabile:asm-managed-rapid
per il canale Rapido,asm-managed
per il canale Regolare oasm-managed-stable
per il canale Stabile.L'etichetta della revisione corrisponde a un canale di rilascio:
Etichetta revisione Canale asm-managed
Normale asm-managed-rapid
Rapida asm-managed-stable
Stabile kubectl label namespace NAMESPACE istio-injection- istio.io/rev=REVISION_LABEL --overwrite
Se hai implementato anche il piano di dati gestito facoltativo, annota lo spazio dei nomi
NAMESPACE
come segue:kubectl annotate --overwrite namespace NAMESPACE \ mesh.cloud.google.com/proxy='{"managed":"true"}'
All'interno del cluster
Utilizza il seguente comando per individuare l'etichetta su
istiod
:kubectl -n istio-system get pods -l app=istiod --show-labels
L'output è simile al seguente:
NAME READY STATUS RESTARTS AGE LABELS istiod-asm-173-3-5788d57586-bljj4 1/1 Running 0 23h app=istiod,istio.io/rev=asm-1233-2,istio=istiod,pod-template-hash=5788d57586 istiod-asm-173-3-5788d57586-vsklm 1/1 Running 1 23h app=istiod,istio.io/rev=asm-1233-2,istio=istiod,pod-template-hash=5788d57586
Nell'output, nella colonna
LABELS
, prendi nota del valore dell'etichetta di revisioneistiod
, che segue il prefissoistio.io/rev=
. In questo esempio, il valore èasm-1233-2
.Applica l'etichetta di revisione allo spazio dei nomi predefinito. Nel seguente comando,
REVISION
è il valore dell'etichetta di revisioneistiod
che hai annotato nel passaggio precedente.kubectl label namespace default istio-injection- istio.io/rev=REVISION --overwrite
Puoi ignorare il messaggio
"istio-injection not found"
nell'output. Ciò significa che in precedenza lo spazio dei nomi non aveva l'etichettaistio-injection
, che dovresti aspettarti nelle nuove installazioni di Cloud Service Mesh o nei nuovi deployment. Poiché il comportamento di inserimento automatico non è definito quando uno spazio dei nomi ha sia l'etichettaistio-injection
sia l'etichetta di revisione, tutti i comandikubectl label
nella documentazione di Cloud Service Mesh assicurano esplicitamente che ne sia impostato solo uno.
Implementazione dell'applicazione
Ora che l'iniezione automatica è attivata nello spazio dei nomi default
, quando esegui il deployment dei servizi dell'applicazione BookInfo, i proxy sidecar vengono iniettati insieme a ciascun servizio.
Nella riga di comando del computer in cui hai installato Cloud Service Mesh, vai alla directory principale della directory di installazione di Cloud Service Mesh. Se necessario, scarica il file di installazione.
Esegui il deployment dell'applicazione nello spazio dei nomi predefinito utilizzando
kubectl
:kubectl apply -f samples/bookinfo/platform/kube/bookinfo.yaml
Verifica che l'applicazione sia stata dispiata correttamente eseguendo i seguenti comandi:
kubectl get services
Output:
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE details 10.0.0.31 <none> 9080/TCP 6m kubernetes 10.0.0.1 <none> 443/TCP 7d productpage 10.0.0.120 <none> 9080/TCP 6m ratings 10.0.0.15 <none> 9080/TCP 6m reviews 10.0.0.170 <none> 9080/TCP 6m
e
kubectl get pod
Output:
NAME READY STATUS RESTARTS AGE details-v1-1520924117-48z17 2/2 Running 0 6m productpage-v1-560495357-jk1lz 2/2 Running 0 6m ratings-v1-734492171-rnr5l 2/2 Running 0 6m reviews-v1-874083890-f0qf0 2/2 Running 0 6m reviews-v2-1343845940-b34q5 2/2 Running 0 6m reviews-v3-1813607990-8ch52 2/2 Running 0 6m
Infine, definisci il routing del gateway di ingresso per l'applicazione:
kubectl apply -f samples/bookinfo/networking/bookinfo-gateway.yaml
Output:
gateway.networking.istio.io/bookinfo-gateway created virtualservice.networking.istio.io/bookinfo created
Convalida del deployment dell'applicazione
Per verificare se l'applicazione BookInfo funziona, devi inviare traffico al gateway di ingresso.
Se hai installato Cloud Service Mesh su Google Distributed Cloud, ottieni l'indirizzo IP esterno per il gateway di ingresso che hai configurato dopo l'installazione di Cloud Service Mesh
Se hai installato Cloud Service Mesh su GKE, ottieni l'indirizzo IP esterno del gateway di ingresso come segue:
kubectl get service istio-ingressgateway -n istio-system
Output:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE istio-ingressgateway LoadBalancer 10.19.247.233 35.239.7.64 80:31380/TCP,443:31390/TCP,31400:31400/TCP 27m
In questo esempio, l'indirizzo IP del servizio in entrata è
35.239.7.64
.
Prova dell'applicazione
Verifica che l'app BookInfo sia in esecuzione con
curl
:curl -I http://EXTERNAL_IP/productpage
Se la risposta mostra
200
, significa che l'applicazione funziona correttamente con Cloud Service Mesh.Per visualizzare la pagina web di BookInfo, inserisci il seguente indirizzo nel browser:
http://EXTERNAL_IP/productpage
Se aggiorni la pagina più volte, dovresti vedere diverse versioni delle recensioni visualizzate nella pagina del prodotto, presentate in un formato a round robin (stelle rosse, stelle nere, nessuna stella).
Ora che hai un'applicazione che genera traffico, puoi esplorare le pagine di Cloud Service Mesh nella console Google Cloud per visualizzare le metriche e le altre funzionalità di osservabilità.
Pulizia
Al termine della sperimentazione con l'esempio Bookinfo, rimuovilo dal tuo cluster.
Disinstalla Bookinfo utilizzando il seguente script:
samples/bookinfo/platform/kube/cleanup.sh
Conferma l'arresto:
kubectl get virtualservices #-- there should be no virtual services kubectl get destinationrules #-- there should be no destination rules kubectl get gateway #-- there should be no gateway kubectl get pods #-- the Bookinfo pods should be deleted
Passaggi successivi
Scopri di più sull'esempio Bookinfo.