Questo tutorial è destinato agli utenti e agli amministratori di Kubernetes interessati a utilizzare il service mesh Istio per eseguire il deployment sicuro dei servizi Kubernetes e abilitare la comunicazione TLS reciproca (mTLS).
Istio e Cloud Service Mesh
Istio non è un prodotto Google supportato. Ti consigliamo di eseguire Cloud Service Mesh gestito. Per saperne di più, consulta Provisioning di Cloud Service Mesh su un cluster GKE Autopilot.
Cloud Service Mesh offre i seguenti vantaggi:
- Puoi eseguire il provisioning di Cloud Service Mesh gestito utilizzando l'API Fleet senza strumenti lato client come
istioctl
. - Cloud Service Mesh inserisce automaticamente i proxy sidecar nei carichi di lavoro senza concedere privilegi elevati ai tuoi container.
- Puoi visualizzare dashboard avanzate per la mesh e i servizi senza alcuna configurazione aggiuntiva e poi utilizzare queste metriche per configurare gli obiettivi del livello di servizio (SLO) e gli avvisi per monitorare l'integrità delle tue applicazioni.
- L'upgrade del piano di controllo di Cloud Service Mesh gestito viene eseguito automaticamente per garantire che tu riceva le patch e le funzionalità di sicurezza più recenti.
- Il piano dati gestito di Cloud Service Mesh esegue automaticamente l'upgrade dei proxy sidecar nei tuoi carichi di lavoro, in modo che tu non debba riavviare manualmente i servizi quando sono disponibili upgrade del proxy e patch di sicurezza.
- Cloud Service Mesh è un prodotto supportato e può essere configurato utilizzando le API Istio open source standard. Per saperne di più, consulta le funzionalità supportate.
Obiettivi
Questo tutorial include i seguenti passaggi:
- Creare un cluster GKE Autopilot.
- Installa Istio utilizzando lo strumento a riga di comando
istioctl
. - Esegui il deployment di un'applicazione di esempio per testare l'autenticazione TLS reciproca (mTLS).
- Configura Istio per utilizzare l'autenticazione mTLS per la comunicazione tra servizi utilizzando una risorsa personalizzata
PeerAuthentication
. - Verifica l'autenticazione mTLS utilizzando la dashboard Kiali.
Costi
In questo documento, utilizzi i seguenti componenti fatturabili di Google Cloud:
Per generare una stima dei costi in base all'utilizzo previsto,
utilizza il calcolatore prezzi.
Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per ulteriori informazioni, vedi Pulizia.
Prima di iniziare
Cloud Shell è preinstallato con il software necessario per questo tutorial, tra cui
kubectl
, gcloud CLI e Terraform.
Se non utilizzi Cloud Shell, devi installare gcloud CLI.
- 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.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the GKE API:
gcloud services enable container.googleapis.com
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the GKE API:
gcloud services enable container.googleapis.com
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/container.clusterAdmin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
Prepara l'ambiente
Per configurare l'ambiente:
Imposta le variabili di ambiente:
export PROJECT_ID=PROJECT_ID gcloud config set project $PROJECT_ID gcloud config set compute/region us-central1
Sostituisci
PROJECT_ID
con l' Google Cloud ID progetto.Clona il repository GitHub:
git clone https://github.com/GoogleCloudPlatform/kubernetes-engine-samples.git
Passa alla directory di lavoro:
cd kubernetes-engine-samples/service-mesh/istio-tutorial
Crea un cluster GKE
Abilita le funzionalità Linux richieste da Istio: NET_RAW
e NET_ADMIN
.
GKE Autopilot non consente NET_ADMIN
per impostazione predefinita, ma
puoi abilitare NET_ADMIN
utilizzando il comando --workload-policies=allow-net-admin
in GKE 1.27 e versioni successive:
gcloud container clusters create-auto istio-cluster \
--location="us-central1" \
--workload-policies="allow-net-admin"
Per scoprire di più sulla sicurezza di GKE Autopilot, consulta Configurazioni di sicurezza integrate.
Installa Istio
Puoi installare Istio su un cluster GKE utilizzando Istioctl.
In questo tutorial, installi Istio con il profilo di configurazione predefinito consigliato per le implementazioni di produzione.
Installa Istio:
Per installare l'ultima versione di Istio:
curl -L https://istio.io/downloadIstio | sh -
Per installare una versione specifica di Istio:
export ISTIO_VERSION=VERSION_NUMBER curl -L https://istio.io/downloadIstio | TARGET_ARCH=$(uname -m) sh -
Sostituisci VERSION_NUMBER con la versione di Istio che vuoi installare. Per informazioni sulle release di Istio, consulta Annunci delle release.
Aggiungi lo strumento a riga di comando
istioctl
a PATH:cd istio-* export PATH=$PWD/bin:$PATH
Installa Istio sul cluster:
istioctl install --set profile="default" -y
Questo passaggio potrebbe richiedere alcuni minuti.
Attendi che i pod Istio siano pronti:
watch kubectl get pods -n istio-system
L'output è simile al seguente:
NAME READY STATUS RESTARTS AGE istio-ingressgateway-5c47bff876-wjm96 1/1 Running 0 2m54s istiod-5fc7cb65cd-k8cp4 1/1 Running 0 2m57s
Quando i pod Istio sono
Running
, torna alla riga di comando premendoCtrl+C
.
Esegui il deployment dell'applicazione di esempio
In questa sezione utilizzi l'applicazione di esempio Bank of Anthos per creare un mesh di servizi con autenticazione mTLS.
Aggiungi un'etichetta dello spazio dei nomi che indica a Istio di attivare l'inserimento automatico dei proxy sidecar Envoy:
kubectl label namespace default istio-injection=enabled
Esegui il deployment dell'applicazione di esempio:
cd .. git clone https://github.com/GoogleCloudPlatform/bank-of-anthos.git kubectl apply -f bank-of-anthos/extras/jwt/jwt-secret.yaml kubectl apply -f bank-of-anthos/kubernetes-manifests/
Attendi che l'applicazione sia pronta:
watch kubectl get pods
L'output è simile al seguente:
NAME READY STATUS RESTARTS AGE accounts-db-0 2/2 Running 0 2m16s balancereader-5c695f78f5-x4wlz 2/2 Running 0 3m8s contacts-557fc79c5-5d7fg 2/2 Running 0 3m7s frontend-7dd589c5d7-b4cgq 2/2 Running 0 3m7s ledger-db-0 2/2 Running 0 3m6s ledgerwriter-6497f5cf9b-25c6x 2/2 Running 0 3m5s loadgenerator-57f6896fd6-lx5df 2/2 Running 0 3m5s transactionhistory-6c498965f-tl2sk 2/2 Running 0 3m4s userservice-95f44b65b-mlk2p 2/2 Running 0 3m4s
Quando i pod sono
Running
, torna alla riga di comando premendoCtrl+C
.Esamina il seguente manifest:
Questo manifest descrive le risorse Gateway e VirtualService di Istio che espongono l'applicazione e utilizzano Istio come controller Ingress.
Applica il manifest al cluster:
kubectl apply -f bank-of-anthos/extras/istio/frontend-ingress.yaml
Configura mTLS
L'autenticazione TLS reciproca (mTLS) è abilitata per impostazione predefinita in Istio. Ciò significa che Istio monitora i carichi di lavoro del server che sono stati migrati ai proxy Istio e configura automaticamente i proxy client per stabilire connessioni mTLS con questi carichi di lavoro. Istio configura anche i proxy client in modo che non utilizzino mTLS quando si connettono ai workload senza proxy sidecar.
Istio può configurare mTLS per funzionare in tre modalità:
PERMISSIVE
: i workload accettano sia il traffico mTLS che quello di testo normale.STRICT
: i workload accettano solo il traffico mTLS.DISABLE
: mTLS è disattivato. Utilizza questa modalità se vuoi utilizzare la tua soluzione di sicurezza.
Puoi applicare la configurazione mTLS a livello globale, per spazio dei nomi o per carico di lavoro. In
questo tutorial, applichi la configurazione per spazio dei nomi utilizzando la modalità STRICT
mTLS.
Esamina il seguente manifest:
Questo manifest descrive una risorsa personalizzata Istio di autenticazione peer.
Applica il manifest al cluster:
kubectl apply -f peer-authentication.yaml
Per ulteriori informazioni su mTLS in Istio, consulta Autenticazione TLS reciproca.
Verifica che mTLS sia abilitato
Kiali è una dashboard di osservabilità basata sul web per la mesh di servizi Istio che fornisce una visualizzazione grafica dell'ambiente di microservizi, consentendoti di monitorare e risolvere i problemi delle tue applicazioni. Puoi utilizzare Kiali per verificare che l'autenticazione mTLS sia attivata e funzioni correttamente nelmesh di servizih Istio. Kiali richiede Prometheus come origine dati di telemetria. Questo tutorial utilizza Google Cloud Managed Service per Prometheus.
Installare un'interfaccia di query
Crea un account di servizio IAM con il
roles/monitoring.viewer
per consentire all'interfaccia di query di accedere alle metriche:gcloud iam service-accounts create monitoring \ --display-name="Service account for query interface" gcloud projects add-iam-policy-binding PROJECT_ID \ --member "serviceAccount:monitoring@PROJECT_ID.iam.gserviceaccount.com" \ --role roles/monitoring.viewer gcloud iam service-accounts add-iam-policy-binding \ monitoring@PROJECT_ID.iam.gserviceaccount.com \ --role roles/iam.workloadIdentityUser \ --member "serviceAccount:PROJECT_ID.svc.id.goog[monitoring/default]"
Crea uno spazio dei nomi Kubernetes:
kubectl create namespace monitoring
Aggiungi un'annotazione al account di servizio Kubernetes predefinito nello spazio dei nomi per configurare Workload Identity Federation for GKE:
kubectl annotate serviceaccount -n monitoring default \ iam.gke.io/gcp-service-account=monitoring@PROJECT_ID.iam.gserviceaccount.com --overwrite
Esegui il deployment del carico di lavoro dell'interfaccia di query:
kubectl -n monitoring apply -f https://raw.githubusercontent.com/GoogleCloudPlatform/prometheus-engine/v0.7.1/examples/frontend.yaml
Esamina il seguente manifest:
Questo manifest descrive una risorsa
PodMonitoring
che raccoglie le metriche di Istio e Envoy Proxy.Applica il manifest al cluster:
kubectl apply -f pod-monitorings.yaml
Ottieni un link all'applicazione di esempio:
INGRESS_HOST=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}') echo "http://$INGRESS_HOST"
Apri il link per visualizzare l'applicazione di esempio. Accedi con il nome utente e la password predefiniti per generare traffico tra i microservizi.
Installa Kiali
Ti consigliamo di installare Kiali utilizzando l'operatore Kiali.
Installa l'operatore Kiali:
helm repo add kiali https://kiali.org/helm-charts helm repo update helm install \ --namespace kiali-operator \ --create-namespace \ kiali-operator \ kiali/kiali-operator
Esamina il seguente manifest:
Questo manifest descrive una risorsa personalizzata dell'operatore che definisce il server Kiali.
Applica il manifest al cluster:
kubectl apply -f kiali.yaml
Attendi che il server Kiali sia pronto:
watch kubectl get pods -n istio-system
L'output è simile al seguente:
NAME READY STATUS RESTARTS AGE istio-ingressgateway-6845466857-92zp8 1/1 Running 0 9m11s istiod-6b47d84cf-4cqlt 1/1 Running 0 12m
Quando i pod sono
Running
, torna alla riga di comando premendoCtrl+C
.Configura l'inoltro delle porte sul servizio del server Kiali per accedere alla dashboard:
kubectl -n istio-system port-forward svc/kiali 8080:20001
Apri l'anteprima web. In Kiali, vai alla sezione Grafico e seleziona l'opzione Sicurezza nel menu a discesa Visualizza. Questa visualizzazione mostra lo stato di sicurezza di ogni nodo nel grafico. I nodi con un badge mTLS abilitato indicano che mTLS è abilitato per quel servizio, mentre i nodi senza il badge indicano che mTLS non è abilitato.
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 il progetto
Delete a Google Cloud project:
gcloud projects delete PROJECT_ID
Elimina le singole risorse
Se hai utilizzato un progetto esistente e non vuoi eliminarlo, elimina le singole risorse.
Elimina Kiali:
kubectl -n istio-system delete kiali kiali helm uninstall --namespace kiali-operator kiali-operator
Elimina le risorse di monitoraggio:
kubectl -n monitoring delete -f https://raw.githubusercontent.com/GoogleCloudPlatform/prometheus-engine/v0.7.1/examples/frontend.yaml
Elimina l'applicazione di esempio:
kubectl delete -f bank-of-anthos/extras/istio/frontend-ingress.yaml kubectl delete -f bank-of-anthos/kubernetes-manifests
Disinstalla Istio:
istioctl uninstall --purge -y
Elimina il cluster GKE:
gcloud container clusters delete --region us-central1 istio-cluster --quiet
Passaggi successivi
- Esplora architetture di riferimento, diagrammi e best practice su Google Cloud. Consulta il nostro Cloud Architecture Center.