Stai visualizzando la documentazione legacy di Service Mesh della versione 1.19.

Versioni disponibili

Cloud Service Mesh
Archivio 1.22
Archivio 1.21
Archivio 1.20
Archivio 1.19
Archivio 1.18

Questa pagina è stata tradotta dall'API Cloud Translation.

Deployment dell'applicazione di esempio Online Boutique

Questa guida spiega come installare l'applicazione di esempio Online Boutique per di Cloud Service Mesh. Se non hai installato Cloud Service Mesh, consulta la guida all'installazione.

Download e deployment dell'esempio

Per eseguire il deployment dell'applicazione, devi prima scaricare i manifest di Boutique online dal repo anthos-service-mesh-packages utilizzando kpt. L'applicazione di esempio Online Boutique nel anthos-service-mesh-packages repository è stato modificato rispetto all'insieme originale di in microservices-demo un repository. Seguendo le best practice, il deployment di ogni servizio viene eseguito in uno spazio dei nomi separato con un account di servizio univoco.

Se non l'hai ancora fatto, installa kpt:
```
gcloud components install kpt
```

Scarica il sample utilizzando kpt:

kpt pkg get \
  https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/samples/online-boutique \
  online-boutique

Output previsto

Package "online-boutique":
Fetching https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages@main
From https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages
* branch            main       -> FETCH_HEAD
Adding package "samples/online-boutique".
Fetched 1 package(s).

Vai alla directory online-boutique:
```
cd online-boutique
```

Crea gli spazi dei nomi per l'applicazione:

kubectl apply -f kubernetes-manifests/namespaces

Output previsto:

namespace/ad created
namespace/cart created
namespace/checkout created
namespace/currency created
namespace/email created
namespace/frontend created
namespace/loadgenerator created
namespace/payment created
namespace/product-catalog created
namespace/recommendation created
namespace/shipping created

Eseguire il deployment dell'esempio nel cluster.

Crea gli account di servizio e i deployment:

kubectl apply -f kubernetes-manifests/deployments

Output previsto:

serviceaccount/ad created
deployment.apps/adservice created
serviceaccount/cart created
deployment.apps/cartservice created
serviceaccount/checkout created
deployment.apps/checkoutservice created
serviceaccount/currency created
deployment.apps/currencyservice created
serviceaccount/email created
deployment.apps/emailservice created
serviceaccount/frontend created
deployment.apps/frontend created
serviceaccount/loadgenerator created
deployment.apps/loadgenerator created
serviceaccount/payment created
deployment.apps/paymentservice created
serviceaccount/product-catalog created
deployment.apps/productcatalogservice created
serviceaccount/recommendation created
deployment.apps/recommendationservice created
serviceaccount/shipping created
deployment.apps/shippingservice created

Crea i servizi:

kubectl apply -f kubernetes-manifests/services

Risultato previsto:

service/adservice created
service/cartservice created
service/checkoutservice created
service/currencyservice created
service/emailservice created
service/frontend created
service/frontend-external created
service/paymentservice created
service/productcatalogservice created
service/recommendationservice created
service/shippingservice created

Crea le voci del servizio:

kubectl apply -f istio-manifests/allow-egress-googleapis.yaml

Risultato previsto:

serviceentry.networking.istio.io/allow-egress-googleapis created
serviceentry.networking.istio.io/allow-egress-google-metadata created

Attivazione dell'iniezione automatica di sidecar

Per attivare l'iniezione automatica, etichetta gli spazi dei nomi con le etichette di inserimento predefinite se è configurato il tag predefinito o con la etichetta di revisione per lo spazio dei nomi. L'etichetta aggiunta dipende anche dal fatto che tu abbia eseguito o meno il deployment Cloud Service Mesh gestito o ha installato il piano di controllo nel cluster. L'etichetta viene utilizzata dal webhook di iniettori collaterali per associare i file collaterali inseriti con una particolare revisione del piano di controllo.

All'interno del cluster

Utilizza il seguente comando per individuare l'etichetta su istiod:
```
kubectl get deploy -n istio-system -l app=istiod -o \
  jsonpath={.items[*].metadata.labels.'istio\.io\/rev'}'{"\n"}'
```
Il comando restituisce l'etichetta di revisione che corrisponde Versione di Cloud Service Mesh, ad esempio: asm-11910-9

Applica l'etichetta della revisione agli spazi dei nomi dell'applicazione. Nel seguente comando, REVISION è il valore dell'etichetta di revisione istiod che hai annotato nel passaggio precedente.

Nota: puoi sostituire istio.io/rev con l'etichetta istio-injection=enabled se è configurato il tag predefinito. Verifica che il tag predefinito esista eseguendo istioctl tag list con istioctl di OUTPUT_DIR.

for ns in ad cart checkout currency email frontend loadgenerator \
  payment product-catalog recommendation shipping; do
    kubectl label namespace $ns istio.io/rev=REVISION --overwrite
done;

Risultato previsto:

namespace/ad labeled
namespace/cart labeled
namespace/checkout labeled
namespace/currency labeled
namespace/email labeled
namespace/frontend labeled
namespace/loadgenerator labeled
namespace/payment labeled
namespace/product-catalog labeled
namespace/recommendation labeled
namespace/shipping labeled

Riavvia i pod:

for ns in ad cart checkout currency email frontend loadgenerator \
  payment product-catalog recommendation shipping; do
    kubectl rollout restart deployment -n ${ns}
done;

Output previsto:

deployment.apps/adservice restarted
deployment.apps/cartservice restarted
deployment.apps/checkoutservice restarted
deployment.apps/currencyservice restarted
deployment.apps/emailservice restarted
deployment.apps/frontend restarted
deployment.apps/loadgenerator restarted
deployment.apps/paymentservice restarted
deployment.apps/productcatalogservice restarted
deployment.apps/recommendationservice restarted
deployment.apps/shippingservice restarted

Mesh di servizi gestito

Applica l'etichetta di revisione agli spazi dei nomi dell'applicazione. Nel seguente l'etichetta REVISION deve essere il valore del tuo canale di rilascio Cloud Service Mesh gestito: asm-managed per asm-managed-rapid per la modalità rapida o asm-managed-stable per la modalità stabile.

Nota: puoi sostituire istio.io/rev con il metodo istio-injection=enabled se tag predefinito è configurata. Verifica che il tag predefinito esista eseguendo istioctl tag list con il istioctl di OUTPUT_DIR.

for ns in ad cart checkout currency email frontend loadgenerator \
  payment product-catalog recommendation shipping; do
    kubectl label namespace $ns istio.io/rev=REVISION --overwrite
done;

Risultato previsto:

namespace/ad labeled
namespace/cart labeled
namespace/checkout labeled
namespace/currency labeled
namespace/email labeled
namespace/frontend labeled
namespace/loadgenerator labeled
namespace/payment labeled
namespace/product-catalog labeled
namespace/recommendation labeled
namespace/shipping labeled

Se hai eseguito anche il deployment della piano dati gestito, annota gli spazi dei nomi dell'applicazione come segue:

for ns in ad cart checkout currency email frontend loadgenerator \
  payment product-catalog recommendation shipping; do
    kubectl annotate --overwrite namespace $ns mesh.cloud.google.com/proxy='{"managed":"true"}'
done;

Riavvia i pod:

for ns in ad cart checkout currency email frontend loadgenerator \
  payment product-catalog recommendation shipping; do
    kubectl rollout restart deployment -n ${ns}
done;

Output previsto:

deployment.apps/adservice restarted
deployment.apps/cartservice restarted
deployment.apps/checkoutservice restarted
deployment.apps/currencyservice restarted
deployment.apps/emailservice restarted
deployment.apps/frontend restarted
deployment.apps/loadgenerator restarted
deployment.apps/paymentservice restarted
deployment.apps/productcatalogservice restarted
deployment.apps/recommendationservice restarted
deployment.apps/shippingservice restarted

Esposizione e accesso all'applicazione

Il modo in cui esponi l'applicazione all'esterno del mesh dipende dal fatto che tu abbia eseguito il deployment di un gateway in entrata. Puoi scegliere di esporre l'applicazione utilizzando un o un gateway istio in entrata utilizzando un servizio Kubernetes.

Utilizzo del gateway di ingresso

Se hai eseguito il deployment di un gateway di ingresso nel cluster come specificato nel prerequisito, svolgi i seguenti passaggi per esporre l'applicazione utilizzando il gateway.

Esegui il deployment di Gateway e VirtualService per il servizio di frontend

kubectl apply -f istio-manifests/frontend-gateway.yaml

Risultato previsto:

gateway.networking.istio.io/frontend-gateway created
virtualservice.networking.istio.io/frontend-ingress created

Ottieni l'indirizzo IP esterno del gateway di ingresso. Sostituisci i segnaposto con le seguenti informazioni:
- GATEWAY_SERVICE_NAME: il nome del servizio gateway di ingresso. Se hai eseguito il deployment del gateway di esempio senza o se hai eseguito il deployment gateway in entrata predefinito, il nome è istio-ingressgateway.
- GATEWAY_NAMESPACE: lo spazio dei nomi in cui hai eseguito il deployment del gateway di ingresso. Se hai eseguito il deployment del traffico in entrata predefinito gateway, lo spazio dei nomi è istio-system.
```
kubectl get service GATEWAY_SERVICE_NAME  -n GATEWAY_NAMESPACE
```
L'output è simile al seguente:
```
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 gateway in entrata è 35.239.7.64.
Visita l'applicazione sul tuo browser per confermare l'installazione:
```
http://EXTERNAL_IP/
```

Nessun gateway in entrata

Se non hai eseguito il deployment di un gateway in entrata o scegli di esporre l'applicazione utilizzando un servizio Kubernetes, segui questi passaggi:

Esegui il deployment di un servizio di tipo LoadBalancer per esporre il servizio frontend
```
kubectl apply -f frontend-external.yaml
```
Trova l'indirizzo IP esterno del servizio frontend-external:
```
kubectl get service frontend-external -n frontend
```
Visita l'applicazione sul browser per confermare l'installazione:
```
http://EXTERNAL_IP/
```

Puoi esplorare le funzionalità di osservabilità di Cloud Service Mesh nella console Google Cloud. Tieni presente che l'aggiornamento il grafico della topologia per visualizzare i servizi nel mesh.

Esegui la pulizia

Prima di eliminare Online Boutique, ti consigliamo di consultare Cloud Service Mesh tramite esempi: mTLS, che utilizza il sample. Al termine dell'esplorazione, utilizza i seguenti comandi per rimuovi l'esempio di Boutique online:

Elimina gli spazi dei nomi dell'applicazione:

kubectl delete -f kubernetes-manifests/namespaces

Risultato previsto:

namespace "ad" deleted
namespace "cart" deleted
namespace "checkout" deleted
namespace "currency" deleted
namespace "email" deleted
namespace "frontend" deleted
namespace "loadgenerator" deleted
namespace "payment" deleted
namespace "product-catalog" deleted
namespace "recommendation" deleted
namespace "shipping" deleted

Elimina le voci di servizio:

kubectl delete -f istio-manifests/allow-egress-googleapis.yaml

Output previsto:

serviceentry.networking.istio.io "allow-egress-googleapis" deleted
serviceentry.networking.istio.io "allow-egress-google-metadata" deleted

Passaggi successivi

Cloud Service Mesh tramite esempi: mTLS