Anthos Service Mesh e Traffic Director sono ora Cloud Service Mesh. Per saperne di più, consulta la panoramica di Cloud Service Mesh.

Questa pagina è stata tradotta dall'API Cloud Translation.

Esegui la migrazione da Istio 1.11 o versioni successive a Cloud Service Mesh

Questo tutorial mostra come eseguire la migrazione di un'applicazione da un cluster Google Kubernetes Engine (GKE) che utilizza Istio a un nuovo cluster che utilizza Cloud Service Mesh gestito, mesh di servizi di Google completamente gestito e conforme a Istio.

In questo tutorial:

Crea un nuovo cluster Google Kubernetes Engine e installa Istio e il gateway di ingresso Istio sul cluster. Questo cluster fungerà da cluster esistente da cui vuoi eseguire la migrazione.
Esegui il deployment dell'applicazione di esempio Online Boutique nel cluster con Istio.
Crea un altro cluster Google Kubernetes Engine nello stesso progetto Google Cloud.
Attiva Cloud Service Mesh gestito sul secondo cluster e distribuisci il gateway di ingresso Cloud Service Mesh.
Esegui il deployment di Online Boutique nel cluster con Cloud Service Mesh per replicare il deployment dal cluster con Istio.
Shift il 50% del traffico utente dal cluster con Istio al cluster con Cloud Service Mesh utilizzando le funzionalità di suddivisione del traffico di Istio sul cluster con Istio.
Completa la migrazione da Istio a Cloud Service Mesh indirizzando la voce del sistema di nomi di dominio (DNS) del cluster con Istio al cluster con Cloud Service Mesh.

Il traffico utente viene suddiviso al 50% tra un cluster con Istio e un cluster con Cloud Service Mesh. Ogni cluster contiene il proprio deployment di Online
Boutique.

Deployment canary

Il "deployment Canary" è una tecnica utilizzata nello sviluppo software per testare una nuova versione di un software prima di rilasciarla a tutti gli utenti. Consiste nell'aumentare in modo incrementale la percentuale di traffico inviata alla nuova versione. In questo tutorial, configurerai un nuovo cluster con Cloud Service Mesh gestito e trasferirai gradualmente il traffico degli utenti al cluster. Inizierai indirizzando lo 0% del traffico utente al nuovo cluster, poi il 50% e infine il 100%. In produzione, devi utilizzare incrementi più piccoli e più numerosi. Se in un determinato momento noti che il nuovo cluster non è in grado di gestire una percentuale di traffico, puoi eseguire il rollback riducendo la percentuale allo 0%.

Piano di controllo canary e cluster canary

Esistono due strategie comunemente utilizzate per le migrazioni da Istio a Cloud Service Mesh gestito:

Migrazione del control plane canary: in questa strategia, esegui il provisioning di Cloud Service Mesh gestito nello stesso cluster in cui è installato Istio.
Migrazione del cluster canary: in questa strategia, crei un nuovo cluster e poi esegui il provisioning di Cloud Service Mesh gestito al suo interno.

In questo tutorial viene illustrata la strategia di migrazione del cluster canary.

Costi

Questo tutorial utilizza i seguenti componenti fatturabili di Google Cloud:

Al termine di questo tutorial, puoi evitare costi ricorrenti eliminando le risorse che hai creato. Per ulteriori informazioni, vedi Pulizia.

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the required APIs.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the required APIs.

Enable the APIs

Avvia Cloud Shell

In questo tutorial utilizzerai Cloud Shell, un ambiente shell ospitato su Google Cloud che ti consente di gestire le tue risorse Google Cloud.

Cloud Shell include gli strumenti a riga di comando Google Cloud CLI, kubectl e istioctl. Gcloud CLI fornisce l'interfaccia a riga di comando principale per Google Cloud.

Apri una sessione di Cloud Shell dall'angolo in alto a destra di questa pagina, fai clic su e poi su Acknowledge. Una sessione di Cloud Shell si apre in un frame nella parte inferiore della pagina. Completa i seguenti comandi nella sessione Cloud Shell.

Scarica il codice campione.

Clona i repository Git contenenti le risorse Kubernetes e Istio che utilizzerai:

  git clone https://github.com/GoogleCloudPlatform/anthos-service-mesh-samples.git
  git clone https://github.com/GoogleCloudPlatform/microservices-demo.git

Configura il cluster con Istio

Crea il cluster e installa Istio

In questa sezione crei il cluster che utilizza Istio. In pratica, si tratta dei cluster che stai già utilizzando.

Sostituisci PROJECT_ID con il tuo ID progetto e crea un nuovo cluster:

gcloud container clusters create cluster-with-istio \
  --project=PROJECT_ID \
  --zone=us-central1-a \
  --machine-type=e2-standard-2 --num-nodes=3

Rinomina il contesto del cluster in modo da semplificarne l'utilizzo:

kubectl config rename-context \
  gke_PROJECT_ID_us-central1-a_cluster-with-istio \
  cluster-with-istio

Verifica che il contesto del cluster sia stato rinominato:
```
kubectl config get-contexts --output="name"
```

Installa Istio sul cluster. Per semplicità, installerai il profilo predefinito di Istio e la versione corrispondente all'installazione di istioctl.

istioctl install

Ti verrà chiesto di digitare "y" e di premere Invio.

L'output è simile al seguente:

This will install the Istio X.Y.Z default profile with ["Istio core" "Istiod" "Ingress gateways"] components into the cluster. Proceed? (y/N)
✔ Istio core installed
✔ Istiod installed
✔ Ingress gateways installed
✔ Installation complete
Making this installation the default for injection and validation.

Esegui il deployment di Online Boutique

Eseguirai il deployment di Online Boutique in uno spazio dei nomi separato chiamato onlineboutique. Crea lo spazio dei nomi:
```
kubectl \
  --context cluster-with-istio \
  create namespace onlineboutique
```

Esegui il deployment dei 12 servizi di Online Boutique, tra cui un generatore di carico che simula il traffico degli utenti:

kubectl \
  --namespace=onlineboutique \
  --context=cluster-with-istio \
  apply -f microservices-demo/release/kubernetes-manifests.yaml

Il passaggio precedente ha anche eseguito il deployment di un servizio chiamato frontend-external (di tipo LoadBalancer) a cui viene assegnato un indirizzo IP esterno. Tuttavia, vuoi consentire l'ingresso pubblico solo tramite il deployment del gateway di ingresso Istio. Elimina la risorsa di servizio frontend-external:
```
kubectl \
  --namespace=onlineboutique \
  --context=cluster-with-istio \
  delete service frontend-external
```

Esegui il deployment di una risorsa Istio Gateway e di una risorsa Istio VirtualService per consentire al traffico pubblico di accedere a Online Boutique:

kubectl \
  --namespace=onlineboutique \
  --context=cluster-with-istio \
  apply -f microservices-demo/istio-manifests/frontend-gateway.yaml

Ottieni l'indirizzo IP esterno del gateway di ingresso Istio:

kubectl \
  --namespace istio-system \
  --context=cluster-with-istio \
  get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}'

Copia l'indirizzo IP esterno del servizio istio-ingressgateway, quindi accedi tramite il browser web. Vedrai l'app di esempio Online Boutique.

Configura il nuovo cluster con Cloud Service Mesh gestito

Crea il cluster ed esegui il provisioning di Cloud Service Mesh gestito

In questa sezione, crei il cluster a cui eseguirai la migrazione. Eseguirai il provisioning di Cloud Service Mesh gestito e il deployment di Online Boutique per replicare i deployment dal cluster che utilizza Istio.

Crea un nuovo cluster:

gcloud container clusters create cluster-with-csm \
  --project=PROJECT_ID --zone=us-central1-a \
  --machine-type=e2-standard-4 --num-nodes=2 \
  --workload-pool PROJECT_ID.svc.id.goog

Rinomina il contesto del cluster in modo da semplificarne l'utilizzo:

kubectl config rename-context \
  gke_PROJECT_ID_us-central1-a_cluster-with-csm \
  cluster-with-csm

Verifica che il contesto del cluster sia stato rinominato:
```
kubectl config get-contexts --output="name"
```
Abilita Cloud Service Mesh nel parco risorse del tuo progetto. Un parco risorse è un raggruppamento logico di cluster Kubernetes e altre risorse che possono essere gestiti insieme.
```
gcloud container fleet mesh enable --project PROJECT_ID
```
L'output è simile al seguente:
```
Waiting for Feature Service Mesh to be created...done.
```

Registra il cluster nel parco risorse del progetto:

gcloud container fleet memberships register cluster-with-csm-membership \
  --gke-cluster=us-central1-a/cluster-with-csm \
  --enable-workload-identity \
  --project PROJECT_ID

L'output è simile al seguente:

Waiting for membership to be created...done.
Finished registering to the Fleet.

Attiva Cloud Service Mesh gestito sul cluster:
```
gcloud container fleet mesh update \
  --management automatic \
  --memberships cluster-with-csm-membership \
  --project PROJECT_ID
```
L'output è simile al seguente:
```
Waiting for Feature Service Mesh to be updated...done.
```
Nota: Cloud Service Mesh gestito si occupa di gran parte della manutenzione manuale associata all'upgrade, alla scalabilità e alla protezione del tuo mesh di servizi. Scopri di più su Cloud Service Mesh gestito.

Verifica che sia stato eseguito il provisioning di Cloud Service Mesh gestito per il cluster e che sia pronto per l'uso:

gcloud container fleet mesh describe --project PROJECT_ID

Il provisioning di Cloud Service Mesh e la relativa disponibilità per l'utilizzo sul cluster possono richiedere circa 10 minuti. Se vedi controlPlaneManagement.state: DISABLED o controlPlaneManagement.state: PROVISIONING, dovrai eseguire di nuovo il comando precedente ogni pochi minuti finché non vedi controlPlaneManagement.state: ACTIVE.

L'output è simile al seguente:

createTime: '2022-07-06T01:05:39.110120474Z'
membershipSpecs:
  projects/123456789123/locations/global/memberships/cluster-with-csm-membership:
    mesh:
      management: MANAGEMENT_AUTOMATIC
membershipStates:
  projects/123456789123/locations/global/memberships/cluster-with-csm-membership:
    servicemesh:
      controlPlaneManagement:
        details:
        - code: REVISION_READY
          details: 'Ready: asm-managed'
        state: ACTIVE
      dataPlaneManagement:
        details:
        - code: OK
          details: Service is running.
        state: ACTIVE
    state:
      code: OK
      description: 'Revision(s) ready for use: asm-managed.'
      updateTime: '2022-07-06T01:19:24.243993678Z'
name: projects/your-project-id/locations/global/features/servicemesh
resourceState:
  state: ACTIVE
spec: {}
state:
  state: {}
updateTime: '2022-07-06T01:19:27.475885687Z'

Esegui il deployment del gateway di ingresso di Cloud Service Mesh

Eseguirai il deployment del gateway di ingresso di Cloud Service Mesh in uno spazio dei nomi distinto chiamato asm-ingress. Crea lo spazio dei nomi:
```
kubectl \
  --context cluster-with-csm \
  create namespace asm-ingress
```
Utilizza l'etichetta istio.io/rev=asm-managed per aggiungere lo spazio dei nomi asm-ingress al mesh di servizi e attivare l'iniezione automatica del proxy sidecar.
```
kubectl \
  --context cluster-with-csm \
  label namespace asm-ingress 'istio.io/rev=asm-managed'
```

Esegui il deployment del gateway di ingresso Cloud Service Mesh:

kubectl \
  --context cluster-with-csm \
  --namespace=asm-ingress \
  apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/asm-gateway-deployment-svc.yaml
kubectl \
  --context cluster-with-csm \
  --namespace=asm-ingress \
  apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/gateway.yaml

L'output è simile al seguente:

namespace/asm-ingress configured
serviceaccount/asm-ingressgateway configured
service/asm-ingressgateway configured
deployment.apps/asm-ingressgateway configured
gateway.networking.istio.io/asm-ingressgateway configured

Esegui il deployment di Online Boutique

Eseguirai il deployment di Online Boutique in uno spazio dei nomi separato chiamato onlineboutique. Crea lo spazio dei nomi:
```
kubectl \
  --context cluster-with-csm \
  create namespace onlineboutique
```
Utilizza l'etichetta istio.io/rev=asm-managed per aggiungere lo spazio dei nomi onlineboutique al mesh di servizi e attivare l'iniezione automatica del proxy sidecar.
```
kubectl \
  --context cluster-with-csm \
  label namespace onlineboutique 'istio.io/rev=asm-managed'
```

Esegui il deployment dei 12 servizi di Online Boutique, incluso il generatore di carico che imita il traffico degli utenti:

kubectl \
  --context cluster-with-csm \
  --namespace=onlineboutique \
  apply -f anthos-service-mesh-samples/docs/shared/online-boutique/kubernetes-manifests.yaml
kubectl \
  --context cluster-with-csm \
  --namespace=onlineboutique \
  apply -f anthos-service-mesh-samples/docs/shared/online-boutique/virtual-service.yaml

Recupera l'indirizzo IP esterno del gateway di ingresso Cloud Service Mesh:

kubectl \
  --context cluster-with-csm \
  --namespace asm-ingress \
  get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}'

Copia l'indirizzo IP esterno del servizio asm-ingressgateway e accedi tramite il browser web. Vedrai l'app di esempio Online Boutique. Utilizzerai l'indirizzo IP esterno nella sezione successiva, quindi copialo in una variabile di ambiente:

export INGRESS_IP_OF_CLUSTER_WITH_MANAGED_ASM=$( \
  kubectl \
    --context cluster-with-csm \
    --namespace asm-ingress \
    get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}' \
  )

Testare il cluster con Cloud Service Mesh utilizzando un deployment canary

In questa sezione, configuri il cluster con Istio in modo che il 50% del traffico utente verso Online Boutique venga spostato nell'istanza di Online Boutique nel cluster con Cloud Service Mesh gestito. Per farlo, esegui il deployment di due risorse Istio nel cluster con Istio:

un elemento ServiceEntry per indicare a Istio l'endpoint della boutique online del cluster Cloud Service Mesh gestito
un VirtualService per indicare al gateway di ingresso Istio di suddividere il traffico in parti uguali.

Imposta l'indirizzo IP del gateway in entrata del cluster Cloud Service Mesh gestito all'interno della risorsa ServiceEntry:

sed -i "s/1.2.3.4/${INGRESS_IP_OF_CLUSTER_WITH_MANAGED_ASM}/" anthos-service-mesh-samples/docs/migrate-to-managed-asm/service-entry.yaml

Esegui il deployment di ServiceEntry nel cluster con Istio:

kubectl \
  --context cluster-with-istio \
  --namespace onlineboutique \
  apply -f anthos-service-mesh-samples/docs/migrate-to-managed-asm/service-entry.yaml

Esegui il deployment di VirtualService nel cluster con Istio:

kubectl \
  --context cluster-with-istio \
  --namespace onlineboutique \
  apply -f anthos-service-mesh-samples/docs/migrate-to-managed-asm/virtual-service.yaml

Visita l'indirizzo IP del gateway di ingresso del cluster con Istio nel browser web:
```
kubectl \
  --context cluster-with-istio \
  --namespace istio-system \
  get service
```
Aggiorna la home page della Boutique online più volte e controlla ogni volta il piè di pagina della pagina. Tieni presente che il 50% delle richieste viene gestito da un pod sul cluster con Cloud Service Mesh gestito.

Esegui la migrazione al cluster con Cloud Service Mesh gestito

Questa sezione presuppone che tu possieda un nome di dominio e abbia accesso alle relative impostazioni DNS (Domain Name Server).

Aggiungi un record A alle impostazioni DNS per associare il nome di dominio (ad esempio example.com) all'indirizzo IP del gateway di ingresso in esecuzione nel cluster con Istio.

Nota: il completamento di questa operazione può richiedere alcuni minuti.
Accedi alla boutique online visitando il nome di dominio nel tuo browser web.
Riduci al minimo la durata (TTL) del record DNS per assicurarti di poter ripristinare rapidamente la voce DNS in caso di rollback.
Imposta il record A del tuo nome di dominio sull'indirizzo IP esterno del gateway di ingresso del cluster con Cloud Service Mesh gestito.

Al termine della migrazione, elimina il cluster con Istio:

gcloud container clusters delete cluster-with-istio \
  --zone=us-central1-a \
  --project=PROJECT_ID

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina progetto

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Elimina le risorse

Elimina il cluster con Cloud Service Mesh gestito:

  gcloud container clusters delete cluster-with-managed-asm \
    --zone=us-central1-a \
    --project=PROJECT_ID

Passaggi successivi

Scopri di più su Cloud Service Mesh gestito.
Scopri di più sulle best practice per la sicurezza di Cloud Service Mesh.