Entfernen von anderen Istio Installationen aus einem Cluster

Wenn Sie zuvor Istio im Cluster mithilfe des Diagramms IBM ( Helm ) oder auf andere Weise installiert haben, bereinigen Sie diese Istio-Installation, bevor Sie das Add-on Istio aktivieren.

Vorbereitende Schritte: Überprüfen Sie, ob Istio bereits im Cluster installiert ist. Führen Sie kubectl get namespaces aus und suchen Sie in der Ausgabe nach dem Namespace istio-system.

Um andere Istio Installationen zu entfernen:

• Gehen Sie folgendermaßen vor, wenn Istio mit dem IBM Cloud-Helm-Chart von Istio installiert wurde.

  1. Deinstallieren Sie die Istio-Helm-Bereitstellung.

      helm del istio --purge
      ```
  2. Wenn Helm 2.9 oder früher verwendet wurde, löschen Sie die zusätzliche Jobressource.
  ```sh {: pre}
      kubectl -n istio-system delete job --all
      ```
  3. Der Deinstallationsprozess kann bis zu 10 Minuten dauern. Führen Sie vor der Installation des verwalteten Istio-Add-ons im Cluster `kubectl get namespaces` aus und prüfen Sie, ob der Namensbereich `istio-system` entfernt wurde.
  
  

• Wenn Sie Istio manuell installiert oder das Community- Helm-Diagramm Istio verwendet haben, lesen Sie die Dokumentation zur Deinstallation unter Istio.

• Wenn Sie BookInfo zuvor im Cluster installiert haben, bereinigen Sie diese Ressourcen.

  1. Wechseln Sie in das Verzeichnis der Istio-Dateiposition.

      cd <filepath>/istio-1.29.5
      ```
  2. Löschen Sie alle BookInfo-Services, -Pods und -Bereitstellungen im Cluster.
  ```sh {: pre}
      samples/bookinfo/platform/kube/cleanup.sh
      ```
  3. Der Deinstallationsprozess kann bis zu 10 Minuten dauern. Führen Sie vor der Installation des verwalteten Istio-Add-ons im Cluster `kubectl get namespaces` aus und prüfen Sie, ob der Namensbereich `istio-system` entfernt wurde.
  
  
  
  

Istio-Add-on installieren

Anstelle der Community Istio können Sie das verwaltete Add-on Istio installieren.

Vorbereitende Schritte

• Stellen Sie sicher, dass Sie über die IAM-Zugriffsrolle Writer oder Manager IBM Cloud für IBM Cloud Kubernetes Service verfügen.

• Erstellen Sie einen Kubernetes-Standardcluster mit mindestens drei Workerknoten, die jeweils vier Cores und 16 GB Hauptspeicher (b3c.4x16) oder mehr haben.

• Sie können die Community-Version von Istio nicht gleichzeitig mit dem verwalteten Istio-Add-on in Ihrem Cluster ausführen. Wenn Sie einen vorhandenen Cluster verwenden und Istio zuvor mit dem IBM Helm-Chart oder durch eine andere Methode im Cluster installiert haben, bereinigen Sie diese Istio-Installation.

• Klassische Mehrzonencluster: Stellen Sie sicher, dass Sie Virtual Routing and Forwarding(VRF) für Ihr IBM Cloud-Infrastrukturkonto aktivieren. Informationen zum Aktivieren von VRF finden Sie im Abschnitt VRF aktivieren. Mit dem Befehl ibmcloud account show können Sie überprüfen, ob VRF bereits aktiviert ist. Wenn Sie VRF nicht aktivieren können oder möchten, aktivieren Sie VLAN-Spanning. Um diese Aktion auszuführen, benötigen Sie die Berechtigung Manage Network VLAN Spanning Infrastructure oder können den Kontoinhaber bitten, diese zu aktivieren. Um zu überprüfen, ob VLAN-Spanning bereits aktiviert ist, verwenden Sie den Befehlibmcloud ks vlan spanning get --region REGION.

Installation von Istio anpassen

Sie können eine Reihe von Istio-Konfigurationsoptionen anpassen, indem Sie die Ressource managed-istio-custom in der Konfigurationszuordnung (configmap) entsprechend bearbeiten. Durch diese Einstellungen erhalten Sie zusätzliche Kontrolle über Überwachung, Protokollierung und Netzbetrieb in Ihrer Steuerebene und Ihrem Servicenetz.

1. Beschreiben Sie die Ressource ConfigMapmanaged-istio-custom, um deren Inhalt und die Inline-Dokumentation zu überprüfen.

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

2. Bearbeiten Sie die Ressource managed-istio-custom für die Konfigurationszuordnung (configmap).

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

3. Fügen Sie im Abschnitt data das <key>: "<value>"-Paar mit mindestens einer der folgenden Konfigurationsoptionen hinzu:

istio-components-pilot-requests-cpu

Standardwert: "500m" :
Konfigurieren Sie die CPU-Anforderung unter CPU milli für den istiod Komponenten-Pod. Gehen Sie bei der Änderung dieses Werts mit Vorsicht vor. Wenn Sie diesen Wert zu niedrig festlegen, kann dies die ordnungsgemäße Funktion der Steuerebene verhindern. Wird er zu hoch festgelegt, kann es die Planung des istiod-Pods verhindern.

istio-global-logging-level

Standardwert: "default:info" : Definieren Sie den Protokollbereich und die Stufe der Protokollnachrichten für Komponenten der Steuerebene. Ein Scope stellt einen Funktionsbereich innerhalb einer Komponente der Steuerebene dar und jeder Scope unterstützt bestimmte Protokollinformationsebenen. Der Protokollierungsbereich default gilt für Protokollnachrichten, die keiner Kategorie zugeordnet sind, und wird auf alle Komponenten der Steuerebene angewendet, für die die Basisebene info festgelegt ist.

Wenn Sie Protokollstufen für einzelne Komponentenbereiche angeben möchten, geben Sie eine durch Kommas getrennte Liste der Bereiche und Stufen ein (z. B. "<scope>:<level>,<scope>:<level>"). Eine Auflistung der Anwendungsbereiche der einzelnen Komponenten der Steuerungsebene sowie der Informationsstufen der Protokollmeldungen finden Sie in der Dokumentation zur Protokollierung der Komponenten der Istio. Um die Protokollierungsstufe der Datenebene zu ändern, verwenden Sie den Befehl istioctl proxy-config log <pod> --level <level>.

istio-global-outboundTrafficPolicy-mode

Standardwert: "ALLOW_ANY" : Standardmäßig ist der gesamte abgehende Datenverkehr aus dem Servicenetz zulässig. Wenn Sie den vom Servicenetz abgehenden Datenverkehr zu einem beliebigen Host, der nicht in der Service-Registry definiert ist oder für den innerhalb des Servicenetzes kein Element ServiceEntry definiert ist, blockieren möchten, legen Sie den Wert REGISTRY_ONLY fest.

istio-global-proxy-accessLogFile

Standardwert: "" : Envoy-Proxys geben Zugriffsinformationen über die Standardausgabe aus. Diese Protokolle sind bei der Behebung von Ingress- oder Egress-Problemen hilfreich. Wenn Sie diese Informationen zum Zugriff anzeigen möchten, während Befehlen des Typs kubectl logs für die Envoy-Container ausgeführt werden, legen Sie hier den Wert "/dev/stdout" fest.

istio-monitoring-telemetry

Standardwert: "true" : Telemetriemetriken und Prometheus-Unterstützung werden standardmäßig aktiviert. Um alle Leistungsprobleme im Zusammenhang mit Telemetrie-Metriken auszuschalten und die gesamte Überwachung zu inaktivieren, ändern Sie den Wert in "false".

istio-meshConfig-enableTracing

Standardwert: "true" : Istio generiert standardmäßig Tracebereiche für 1 von 100 Anforderungen. Um die Tracebereiche zu inaktivieren, setzen Sie den Wert auf "false".

istio-pilot-traceSampling

Standardwert: "1.0"

Standardmäßig beträgt der Wert „ Istio erzeugt Trace-Spans für jede 100. Anfrage “, was einer Abtastrate von 1 % entspricht. Wenn Sie mehr Tracebereiche generieren möchten, erhöhen Sie den Prozentwert.

istio-components-pilot-hpa-maxReplicas

Standardwert: "5" :
Standardmäßig legtIstio die maximale Anzahl an Pods für den horizontalen Pod-Autoscaler (HPA) auf istiod 5 fest. Erhöhen Sie diesen Wert nur, wenn Sie über ein großes Service-Mesh verfügen, bei dem erhöhte Ressourcen für die Aktualisierung der Konfigurationen benötigt istiod werden.

Ihre Konfigurationszuordnung kann z. B. der folgenden Beispielkonfigurationszuordnung entsprechen:

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

Wird eine Option aus dieser Tabelle in Ihrer Konfigurationszuordnung nicht angezeigt? Da Ihre Konfigurationszuordnung benutzerdefinierte Werte enthält, wird sie nicht mit Optionen aktualisiert, die im Laufe der Zeit freigegeben werden. Stattdessen können Sie eine Kopie Ihrer Konfigurationszuordnung sichern und die Konfigurationszuordnung aus Ihrem Cluster löschen. Nach etwa 5 Minuten wird in Ihrem Cluster eine Standard-Konfigurationszuordnung erstellt, die die neuen Optionen enthält. Anschließend können Sie Ihre zuvor konfigurierten Einstellungen aus Ihrer Sicherung auf diese Standard-Konfigurationszuordnung kopieren, neue Einstellungen konfigurieren und die Änderungen anwenden.

4. Speichern und schließen Sie die Konfigurationsdatei.

5. Wenn Sie Änderungen an den Einstellungen für istio-global-logging-level oder für istio-global-proxy-accessLogFile vorgenommen haben, müssen Sie die Pods Ihrer Datenebene erneut starten, damit die Änderungen auf sie angewendet werden.

   1. Rufen Sie die Liste aller Pods der Datenebene ab, die sich nicht im Namensbereich istio-system befinden.

       istioctl version --short=false | grep "data plane version" | grep -v istio-system
       ```
       Beispielausgabe
   
       ```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. Führen Sie für jeden Pod einen Neustart durch, indem Sie ihn löschen. In der Ausgabe des vorherigen Schritts werden Pod-Name und Namensbereich in jedem Eintrag als `data plane version: version.ProxyInfo{ID:"<pod_name>.<namespace>", IstioVersion:"1.29.5"}` aufgelistet.
   ```sh {: pre}
       kubectl delete pod <pod_name> -n <namespace>
       ```
   

Möchten Sie eine Einstellung in ConfigMap ändern?

Zum Ändern einer Einstellung, die Sie zur Konfigurationszuordnung hinzugefügt haben, können Sie ein Patch-Script verwenden. Wenn Sie beispielsweise die Einstellung istio-global-proxy-accessLogFile: "/dev/stdout" hinzugefügt haben und diese Einstellung später in "" ändern möchten, können Sie zu diesem Zweck den Befehl kubectl patch cm managed-istio-custom -n ibm-operators --type='json' -p='[{"op": "add", "path": "/data/istio-global-proxy-accessLogFile", "value":""}]' ausführen.

Müssen Sie Ihre Anpassungseinstellungen in 1.24 oder später debuggen?

Überprüfen Sie die helm value.yaml und die helm-Ergebnisprotokolle in der configmap managed-istio-istiod-control-plane-values im Namensraum ibm-operators. Auf value.yaml sehen Sie, ob Ihre Änderung hinzugefügt wurde. Die Steuerergebnisse zeigen Ihnen, ob Syntaxfehler aufgetreten sind.

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!

Möchten Sie Ihre Anpassungskonfiguration in 1.23 debuggen?

Überprüfen Sie die Protokolle für den addon-istio-operator ( Istio Version 1.10 bis 1.23 ) Pod, indem Sie kubectl logs -n ibm-operators -l name=managed-istio-operator ausführen. Der Istio-Operator prüft und gleicht alle benutzerdefinierten Istio-Änderungen ab, die Sie vornehmen.

Wenn Sie das Istio-Add-on inaktivieren, wird die Konfigurationszuordnung (Configmap) managed-istio-custom bei der Deinstallation nicht entfernt. Wenn Sie das Istio-Add-on erneut aktivieren, wird Ihre benutzerdefinierte Konfigurationszuordnung bei der Installation angewendet. Wenn Ihre angepassten Einstellungen in einer späteren Installation von Istio nicht wiederverwendet werden sollen, müssen Sie die Konfigurationszuordnung löschen, nachdem Sie das Istio-Add-on inaktiviert haben, indem Sie kubectl delete cm -n ibm-operators managed-istio-customausführen. Wenn Sie das Istio-Add-on wieder aktivieren, wird bei der Installation dann die standardmäßige Konfigurationszuordnung angewendet.

Umstellung vom Istio Add-on auf die Gemeinschaft Istio

Wenn Sie die verwalteten Istio Add-on-Versionen 1.21 bis 1.23 verwenden, können Sie stattdessen auf eine spätere Version der Community Istio migrieren.

Vorbereitende Schritte: Wenn Sie Istio nicht mehr benötigen, können Sie das Add-on deinstallieren, ohne die Community Istio zu installieren, anstatt diese Schritte auszuführen.

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

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

Deinstallation des Add-ons Istio

Wenn Sie die Arbeit mit Istio abgeschlossen haben, können Sie die Istio-Ressourcen in Ihrem Cluster bereinigen und die Istio-Add-ons deinstallieren.

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