Suppression d'autres installations Istio d'un cluster

Si vous avez précédemment installé Istio dans le cluster à l’aide du graphique IBM ( Helm ) ou par une autre méthode, supprimez cette installation d’ Istio avant d’activer le module complémentaire géré Istio.

Avant de commencer : Vérifiez que Istio est déjà installé dans le cluster. Exécutez kubectl get namespaces et recherchez l'espace de noms istio-system dans le résultat.

Pour supprimer d'autres installations de Istio:

• Si vous avez installé Istio en utilisant la Charte Helm Istio d'IBM Cloud :

  1. Désinstallez le déploiement Helm Istio.

      helm del istio --purge
      ```
  2. Si vous avez utilisé Helm 2.9 ou version antérieure, supprimez la ressource job supplémentaire.
  ```sh {: pre}
      kubectl -n istio-system delete job --all
      ```
  3. Le processus de désinstallation peut prendre jusqu'à 10 minutes. Avant d'installer le module complémentaire Istio géré dans le cluster, exécutez `kubectl get namespaces` et vérifiez que l'espace de noms `istio-system` a été retiré.
  
  

• Si vous avez installé Istio manuellement ou si vous avez utilisé le tableau Helm de la communauté Istio, consultez la documentation relative à la désinstallation de Istio.

• Si vous avez déjà installé BookInfo dans le cluster, nettoyez les ressources correspondantes.

  1. Changez de répertoire pour accéder à l'emplacement du fichier Istio.

      cd <filepath>/istio-1.29.5
      ```
  2. Supprimez tous les services, les pods et les déploiements BookInfo dans le cluster.
  ```sh {: pre}
      samples/bookinfo/platform/kube/cleanup.sh
      ```
  3. Le processus de désinstallation peut prendre jusqu'à 10 minutes. Avant d'installer le module complémentaire Istio géré dans le cluster, exécutez `kubectl get namespaces` et vérifiez que l'espace de noms `istio-system` a été retiré.
  
  
  
  

Installation du module complémentaire Istio

Au lieu de la communauté Istio, vous pouvez installer le module complémentaire géré Istio.

Avant de commencer

• Assurez-vous de disposer du rôle d'accès au service IAM Writer ou Manager IBM Cloud pour IBM Cloud Kubernetes Service.

• Créez un cluster Kubernetes standard avec au moins trois noeuds worker ayant chacun 4 coeurs et 16 Go de mémoire (b3c.4x16) ou plus.

• Vous ne pouvez pas exécuter la communauté Istio en même temps que le module complémentaire Istio géré de votre cluster. Si vous utilisez un cluster existant et que vous avez déjà installé Istio dans le cluster à l'aide de la charte Helm IBM ou via une autre méthode, nettoyez cette installation Istio.

• Clusters à zones multiples classiques: veillez à activer une fonction Virtual Routing and Forwarding(VRF) pour votre compte d'infrastructure IBM Cloud. Pour activer la fonction VRF, voir Activation de VRF. Pour vérifier si la fonction VRF est déjà activée, utilisez la commande ibmcloud account show. Si vous ne pouvez pas ou ne souhaitez pas activer VRF, activez Réseau local virtuel. Pour effectuer cette action, vous devez disposer de l'autorisation Gérer l'infrastructure VLAN Spanning, ou vous pouvez demander au propriétaire du compte de l'activer. Pour vérifier si l'extension de VLAN est déjà activée, utilisez la commandeibmcloud ks vlan spanning get --region REGION.

Personnalisation de l'installation d'Istio

Vous pouvez personnaliser un ensemble d'options de configuration Istio en éditant la ressource de mappe de configuration managed-istio-custom. Ces paramètres incluent un contrôle supplémentaire sur la surveillance, la journalisation et la mise en réseau dans votre plan de contrôle et votre maillage de service.

1. Décrivez la ressource ConfigMapmanaged-istio-custom afin d’en passer en revue le contenu et la documentation intégrée.

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

2. Editez la ressource de mappe de configuration managed-istio-custom.

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

3. Dans la section data, ajoutez la paire <key>: "<value>" d'une ou plusieurs des options de configuration suivantes.

istio-components-pilot-requests-cpu

Valeur par défaut : "500m"

Configurez la demande de CPU dans « milli CPU » pour le pod du composant « istiod ». Cette valeur doit être modifiée avec précaution. Si cette valeur est trop faible, cela peut empêcher le plan de contrôle de fonctionner correctement; si elle est trop élevée, cela peut empêcher la planification du pod istiod.

istio-global-logging-level

Valeur par défaut : "default:info" : Définissez la portée des journaux et le niveau des messages de journal pour les composants de plan de contrôle. Une portée représente une zone fonctionnelle au sein d'un composant de plan de contrôle, et chaque portée prend en charge des niveaux d'informations de journal spécifiques. La portée de journalisation default, qui concerne les messages de journal non catégorisés, est appliquée à tous les composants du plan de contrôle au niveau info.

Pour spécifier les niveaux de journalisation des portées de composants individuels, entrez une liste de portées et de niveaux séparés par une virgule, telle que "<scope>:<level>,<scope>:<level>". Pour obtenir la liste des champs d'application de chaque composant du plan de contrôle et le niveau d'information des messages de journalisation, consultez la documentation relative à la journalisation des composants de l' Istio. Pour modifier le niveau de journalisation du plan de données, utilisez la commande istioctl proxy-config log <pod> --level <level>.

istio-global-outboundTrafficPolicy-mode

Valeur par défaut : "ALLOW_ANY" : Par défaut, tout le trafic sortant du maillage de service est autorisé. Pour bloquer le trafic sortant à partir du maillage de service vers n'importe quel hôte non défini dans le registre de services ou pour lequel il n'existe pas d'entrée ServiceEntry dans le maillage de service, définissez la valeur REGISTRY_ONLY.

istio-global-proxy-accessLogFile

Valeur par défaut : ""Les proxys : Envoy affichent les informations d'accès dans leur sortie standard. Ces journaux sont utiles lorsque vous déboguez des problèmes d'entrée ou de sortie. Pour afficher ces informations d'accès lors de l'exécution des commandes kubectl logs pour les conteneurs Envoy, définissez la valeur "/dev/stdout".

istio-monitoring-telemetry

Valeur par défaut : "true" : Par défaut, les mesures de télémétrie et le support Prometheus sont activés. Pour supprimer les problèmes de performance associés aux métriques de télémétrie et désactiver l'ensemble de la surveillance, affectez la valeur "false".

istio-meshConfig-enableTracing

Valeur par défaut : "true" : Par défaut, Istio génère des étendues de trace pour 1 sur 100 demandes. Pour désactiver les intervalles de trace, définissez la valeur "false".

istio-pilot-traceSampling

Valeur par défaut : "1.0"

Par défaut, Istio génère des segments de trace pour 1 requête sur 100, ce qui correspond à un taux d'échantillonnage de 1 %. Pour générer d'autres étendues de trace, augmentaz le pourcentage.

istio-components-pilot-hpa-maxReplicas

Valeur par défaut : "5" :
Par défaut,Istio définit le nombre maximal de pods pour l'autoscaler horizontal (HPA) à istiod 5. N'augmentez pas cette valeur, sauf si vous disposez d'un service mesh de grande envergure istiod nécessitant davantage de ressources pour mettre à jour les configurations.

Par exemple, votre mappe de configuration peut se présenter comme suit :

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

Vous ne voyez pas d'option de ce tableau dans votre mappe de configuration ? Étant donné que votre mappe de configuration contient des valeurs définies par l'utilisateur, la mappe de configuration n'est pas mise à jour avec les options qui sont publiées dans le temps. Au lieu de cela, vous pouvez sauvegarder une copie de votre mappe de configuration et supprimer la mappe de configuration de votre cluster. Après environ 5 minutes, une mappe de configuration par défaut contenant les nouvelles options est créée dans votre cluster. Vous pouvez alors copier vos paramètres précédemment configurés de votre sauvegarde dans cette mappe de configuration par défaut, configurer les nouveaux paramètres et appliquer les modifications.

4. Sauvegardez et fermez le fichier de configuration.

5. Si vous avez modifié le paramètre istio-global-logging-level ou istio-global-proxy-accessLogFile, vous devez redémarrer vos pods de plan de données pour leur appliquer les modifications.

   1. Obtenez la liste de tous les pods de plan de données qui ne figurent pas dans l'espace de noms istio-system.

       istioctl version --short=false | grep "data plane version" | grep -v istio-system
       ```
       Exemple de sortie
   
       ```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. Redémarrez chaque pod en le supprimant. Dans la sortie de l'étape précédente, le nom de pod et l'espace de nom sont répertoriés dans chaque entrée sous la forme `data plane version: version.ProxyInfo{ID:"<pod_name>.<namespace>", IstioVersion:"1.29.5"}`.
   ```sh {: pre}
       kubectl delete pod <pod_name> -n <namespace>
       ```
   

Vous souhaitez modifier un paramètre d' ConfigMap?

Si vous souhaitez modifier un paramètre que vous avez ajouté à la mappe de configuration, vous pouvez utiliser un script de correction. Par exemple, si vous avez ajouté le paramètre istio-global-proxy-accessLogFile: "/dev/stdout" et souhaitez ensuite remplacer sa valeur par "", vous pouvez exécuter kubectl patch cm managed-istio-custom -n ibm-operators --type='json' -p='[{"op": "add", "path": "/data/istio-global-proxy-accessLogFile", "value":""}]'.

Vous avez besoin de déboguer votre configuration de personnalisation dans 1.24 ou une version ultérieure?

Vérifiez les journaux helm value.yaml et helm results dans le configmap managed-istio-istiod-control-plane-values dans l'espace de noms ibm-operators. Le site value.yaml vous indiquera si votre modification a été ajoutée. Les résultats de la barre vous indiqueront s'il y a eu des erreurs de syntaxe.

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!

Vous avez besoin de déboguer votre configuration personnalisée dans l' 1.23?

Vérifiez les journaux pour le pod addon-istio-operator ( Istio version 1.10 to 1.23 ) en exécutant kubectl logs -n ibm-operators -l name=managed-istio-operator. L'opérateur Istio valide et synchronise les modifications Istio personnalisées que vous avez effectuées.

Si vous désactivez le module complémentaire Istio, la mappe de configuration managed-istio-custom n'est pas retirée durant la désinstallation. Lorsque vous réactivez le module complémentaire Istio, la mappe de configuration personnalisée est appliquée durant l'installation. Si vous ne souhaitez pas réutiliser vos paramètres personnalisés lors d'une installation ultérieure d'Istio, vous devez supprimer la mappe de configuration après avoir désactivé le module complémentaire Istio en exécutant kubectl delete cm -n ibm-operators managed-istio-custom. Lorsque vous réactivez le module complémentaire Istio, la mappe de configuration par défaut est appliquée durant l'installation.

Migration du module complémentaire Istio vers la communauté Istio

Si vous utilisez les versions gérées du module complémentaire Istio 1.21 à 1.23, vous pouvez migrer vers une version ultérieure de la communauté Istio.

Avant de commencer : Si vous n'avez plus besoin de Istio, vous pouvez désinstaller le module complémentaire sans installer la communauté Istio au lieu de suivre ces étapes.

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

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

Désinstallation du module complémentaire Istio

Si vous avez terminé d'utiliser l' Istio, vous pouvez nettoyer les ressources Istio de votre cluster et désinstaller les modules complémentaires 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