Rimozione di altre installazioni di Istio da un cluster

Se in precedenza hai installato Istio nel cluster utilizzando il grafico Helm di IBM o tramite un altro metodo, rimuovi tale installazione di Istio prima di abilitare il componente aggiuntivo gestito Istio.

Prima di cominciare: Verificare che Istio sia già installato nel cluster. Eseguite kubectl get namespaces e cercate lo spazio dei nomi istio-system nell'output.

Per rimuovere altre installazioni di Istio:

• Se hai installato Istio seguendo la guida disponibile su IBM Cloud, Istio e Helm,

  1. Disinstalla la distribuzione Istio Helm.

      helm del istio --purge
      ```
  2. Se hai utilizzato Helm 2.9 o precedenti, elimina la risorsa di lavoro supplementare.
  ```sh {: pre}
      kubectl -n istio-system delete job --all
      ```
  3. Il processo di disinstallazione può richiedere fino a 10 minuti. Prima di installare il componente aggiuntivo gestito da Istio nel cluster, esegui `kubectl get namespaces` e verifica che lo spazio dei nomi `istio-system` sia stato rimosso.
  
  

• Se hai installato Istio manualmente o hai utilizzato il grafico " Helm " della community Istio, consulta la documentazione relativa alla disinstallazione disponibile all'indirizzo Istio.

• Se hai precedentemente installato BookInfo nel cluster, ripulisci tali risorse.

  1. Modifica la directory con l'ubicazione del file Istio.

      cd <filepath>/istio-1.29.5
      ```
  2. Elimina tutti i servizi, i pod e le distribuzioni di BookInfo nel cluster.
  ```sh {: pre}
      samples/bookinfo/platform/kube/cleanup.sh
      ```
  3. Il processo di disinstallazione può richiedere fino a 10 minuti. Prima di installare il componente aggiuntivo gestito da Istio nel cluster, esegui `kubectl get namespaces` e verifica che lo spazio dei nomi `istio-system` sia stato rimosso.
  
  
  
  

Installazione del componente aggiuntivo Istio

Al posto della comunità Istio, è possibile installare il componente aggiuntivo gestito Istio.

Prima di iniziare

• Assicurati di disporre del ruolo di accesso al servizio IAM Writer o Manager IBM Cloud per IBM Cloud Kubernetes Service.

• Creare un cluster standard di tipo “ Kubernetes ” con almeno 3 nodi di lavoro, ciascuno dotato di 4 core e 16 GB di memoria(b3c.4x16)o più.

• Non è possibile eseguire contemporaneamente l' Istio Community e il componente aggiuntivo Istio gestito all'interno del proprio cluster. Se utilizzi un cluster esistente e in precedenza hai installato Istio nel cluster utilizzando il grafico Helm IBM o un altro metodo, ripulisci tale installazione di Istio.

• Cluster multizona classici: assicurati di abilitare un VR(Virtual Routing and Forwarding) per il tuo account dell'infrastruttura IBM Cloud. Per abilitare VRF, consultare Abilitazione VRF. Per controllare se una VRF è già abilitata, utilizza il comando ibmcloud account show. Se non puoi o non vuoi abilitare VRF, abilita VLAN spanning. Per eseguire questa operazione, è necessario disporre dell'autorizzazione " Gestione dell'estensione delle VLAN di rete " oppure è possibile richiedere al proprietario dell'account di abilitarla. Per verificare se lo spanning VLAN è già abilitato, utilizzare il comando ibmcloud ks vlan spanning get --region REGION .

Personalizzazione dell'installazione di Istio

È possibile personalizzare un insieme di opzioni di configurazione Istio modificando la risorsa managed-istio-custom ConfigMap. Queste impostazioni includono un controllo supplementare su monitoraggio, registrazione e rete nel tuo piano di controllo e nella tua rete di servizi.

1. Descrivete la risorsa managed-istio-custom ConfigMap per esaminarne il contenuto e la documentazione in linea.

   kubectl describe cm managed-istio-custom -n ibm-operators
   

2. Modifica la risorsa della mappa di configurazione managed-istio-custom.

   kubectl edit cm managed-istio-custom -n ibm-operators
   

3. Nella sezione “ data ”, aggiungere la coppia <key>: "<value>" di una o più delle seguenti opzioni di configurazione.

istio-components-pilot-requests-cpu

Valore predefinito: "500m"

Configurare la richiesta di CPU in " milli " per il pod del componente " istiod ". Prestare attenzione quando si modifica questo valore. L'impostazione di questo valore troppo basso potrebbe impedire il corretto funzionamento del piano di controllo e l'impostazione di questo valore troppo alto potrebbe impedire la pianificazione del pod istiod.

istio-global-logging-level

Valore predefinito: "default:info"

Definire l'ambito dei log e il livello dei messaggi di log per i componenti del piano di controllo. Un ambito rappresenta un'area funzionale all'interno di un componente del piano di controllo e ciascun ambito supporta specifici livelli di informazioni di log. L'ambito di registrazione default, che è per i messaggi di log non categorizzati, viene applicato a tutti i componenti nel piano di controllo al livello info di base.

Per specificare i livelli di log per i singoli ambiti dei componenti, inserire un elenco di ambiti e livelli separati da virgole, ad esempio "<scope>:<level>,<scope>:<level>". Per un elenco degli ambiti di applicazione di ciascun componente del piano di controllo e del livello di dettaglio dei messaggi di log, consultare la documentazione relativa alla registrazione dei componenti dell’ Istio. Per modificare il livello di log del piano dati, utilizzare il comando istioctl proxy-config log --level .

istio-global-outboundTrafficPolicy-mode

Valore predefinito: "ALLOW_ANY"

Per impostazione predefinita, tutto il traffico in uscita dal service mesh è consentito. Per bloccare il traffico in uscita dalla rete di servizi agli host non definiti nel registro di servizio e che non hanno una ServiceEntry nella rete di servizi, esegui l'impostazione su REGISTRY_ONLY.

istio-global-proxy-accessLogFile

Valore predefinito: ""

Envoy I proxy stampano le informazioni di accesso sullo standard output. Questi log sono utili quando esegui il debug di problemi in ingresso o in uscita. Per visualizzare queste informazioni di accesso quando esegui i comandi kubectl logs per i contenitori Envoy, esegui l'impostazione su "/dev/stdout".

istio-monitoring-telemetry

Valore predefinito: "true"

Per impostazione predefinita, le metriche di telemetria e il supporto per l' Prometheus sono abilitati. Per rimuovere eventuali problemi di prestazioni associati alle metriche di telemetria e disabilitare tutto il monitoraggio, esegui l'impostazione su "false".

istio-meshConfig-enableTracing

Valore predefinito: "true"

Per impostazione predefinita, Istio genera segmenti di tracciamento per 1 richiesta su 100. Per disabilitare le tracce, impostare su "false".

istio-pilot-traceSampling

Valore predefinito: "1.0"

Per impostazione predefinita, Istio genera segmenti di tracciamento per 1 richiesta su 100, il che corrisponde a una frequenza di campionamento dell'1%. Per generare più spans di traccia, aumentare il valore percentuale.

istio-components-pilot-hpa-maxReplicas

Valore predefinito: "5"

Per impostazione predefinita, Istio imposta a 5 il numero massimo di pod predefinito per l'HPA (Horizontal Pod Autoscaler) dell' istiod. Non aumentare questo valore a meno che non si disponga di una rete di servizi di grandi dimensioni in cui istiod necessita di maggiori risorse per aggiornare le configurazioni.

Ad esempio, il file ConfigMap potrebbe avere l'aspetto illustrato nell'esempio seguente.

apiVersion: v1
data:
  istio-ingressgateway-zone-1: dal10
  <key: value> # such as istio-egressgateway-public-1-enabled: "false"
kind: ConfigMap
metadata:
  name: managed-istio-custom
  namespace: ibm-operators

Non si vede un'opzione di questa tabella nella tabella ConfigMap? Poiché ConfigMap contiene valori definiti dall'utente, ConfigMap non viene aggiornato con le opzioni che vengono rilasciate nel tempo. Si può invece eseguire il backup di una copia di ConfigMap e cancellare ConfigMap dal cluster. Dopo circa 5 minuti, nel cluster viene creato un ConfigMap predefinito che contiene le nuove opzioni. Quindi, è possibile copiare le impostazioni precedentemente configurate dal backup a questo sito predefinito ConfigMap, configurare le nuove impostazioni e applicare le modifiche.

4. Salva e chiudi il file di configurazione.

5. Se hai modificato le impostazioni istio-global-logging-level o istio-global-proxy-accessLogFile, devi riavviare i tuoi pod del piano di dati per applicare ad essi le modifiche.

   1. Ottieni l'elenco di tutti i pod del piano di dati che non si trovano nello spazio dei nomi istio-system.

       istioctl version --short=false | grep "data plane version" | grep -v istio-system
       ```
       Output di esempio
   
       ```sh {: screen}
       data plane version: version.ProxyInfo{ID:"test-6f86fc4677-vsbsf.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"rerun-xfs-f8958bb94-j6n89.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"test2-5cbc75859c-jh6bx.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"minio-test-78b5d4597d-hkpvt.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"sb-887f89d7d-7s8ts.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"gid-deployment-5dc86db4c4-kdshs.default", IstioVersion:"1.29.5"}
       ```
   2. Riavvia ciascun pod eliminandolo. Nell'output del passaggio precedente, il nome del pod e il namespace sono indicati in ogni voce come `data plane version: version.ProxyInfo{ID:"<pod_name>.<namespace>", IstioVersion:"1.29.5"}`.
   ```sh {: pre}
       kubectl delete pod <pod_name> -n <namespace>
       ```
   

Si desidera modificare un'impostazione ConfigMap ?

Se desideri modificare un'impostazione che hai aggiunto all' ConfigMap,, puoi utilizzare uno script di patch. Ad esempio, se hai aggiunto l'impostazione istio-global-proxy-accessLogFile: "/dev/stdout" e in seguito desideri ripristinare l'impostazione "", puoi eseguire kubectl patch cm managed-istio-custom -n ibm-operators --type='json' -p='[{"op": "add", "path": "/data/istio-global-proxy-accessLogFile", "value":""}]'.

Avete bisogno di eseguire il debug della vostra configurazione di personalizzazione in 1.24 o in una versione successiva?

Controllare i log di helm value.yaml e dei risultati di helm nella configmap managed-istio-istiod-control-plane-values nello spazio dei nomi ibm-operators. Il sito value.yaml mostra se la modifica è stata aggiunta. I risultati del timone mostreranno se ci sono stati errori di sintassi.

kubectl get cm -n ibm-operators managed-istio-istiod-control-plane-values -o json | jq -r .data.\"values.yaml\"
kubectl get cm -n ibm-operators managed-istio-istiod-control-plane-values -o json | jq -r .data.\"values.yaml.helm.result\"

Thu, 23 Oct 2025 19:58:48 GMT HELM_SUCCESS: Release "istiod" has been upgraded. Happy Helming!
NAME: istiod
LAST DEPLOYED: Thu Oct 23 19:58:42 2025
NAMESPACE: istio-system
STATUS: deployed
REVISION: 275
TEST SUITE: None
NOTES:
"istiod" successfully installed!

Avete bisogno di eseguire il debug della vostra configurazione di personalizzazione in 1.23?

Controllare i log per il pod addon-istio-operator ( Istio versione 1.10 a 1.23 ) eseguendo kubectl logs -n ibm-operators -l name=managed-istio-operator. L'operatore Istio convalida e riconcilia le modifiche personalizzate di Istio apportate dall'utente.

Se disabiliti il componente aggiuntivo Istio, la mappa di configurazione managed-istio-custom non viene rimossa durante la disinstallazione. Quando riattivi il componente aggiuntivo " Istio ", la configurazione personalizzata di " ConfigMap " viene applicata durante l'installazione. Se non si vogliono riutilizzare le impostazioni personalizzate in una successiva installazione di Istio, è necessario cancellare ConfigMap dopo aver disattivato il componente aggiuntivo Istio eseguendo kubectl delete cm -n ibm-operators managed-istio-custom. Quando riabiliti il componente aggiuntivo Istio, la mappa di configurazione predefinita viene applicata durante l'installazione.

Migrazione dal componente aggiuntivo Istio alla comunità Istio

Se si utilizza il componente aggiuntivo gestito Istio nelle versioni da 1.21 a 1.23, è possibile migrare a una versione successiva della community Istio.

Prima di cominciare: Se non si ha più bisogno di Istio, è possibile disinstallare il componente aggiuntivo senza installare la comunità Istio invece di completare questi passaggi.

kubectl scale deployment -n ibm-operators addon-istio-operator --replicas=0

kubectl delete cm -n ibm-operators managed-istio-custom

Disinstallazione del componente aggiuntivo " Istio "

Se hai terminato di utilizzare Istio, puoi ripulire le risorse Istio presenti nel tuo cluster e disinstallare i componenti aggiuntivi Istio.

kubectl delete deployment -n ibm-operators addon-istio-operator --ignore-not-found=true
kubectl delete serviceaccount -n ibm-operators addon-istio-operator --ignore-not-found=true
kubectl delete clusterrolebinding addon-istio-operator --ignore-not-found=true
kubectl delete clusterrole addon-istio-operator --ignore-not-found=true