Configuration du module complémentaire géré Istio

Suppression d'autres installations Istio d'un cluster

Si vous avez précédemment installé Istio dans le cluster à l'aide de la carte IBM Helm ou d'une autre méthode, nettoyez cette installation Istio avant d'activer le module complémentaire Istio géré.

Avant de commencer : Vérifiez qu'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 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.

     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 utilisé le tableau de la communauté Istio Helm, consultez la documentation de désinstallation d'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.24.6
     

  2. Supprimez tous les services, les pods et les déploiements BookInfo dans le cluster.

     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 Istio géré.

Avant de commencer

• Assurez-vous que vous avez le 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 avez besoin de l'autorisation d'infrastructure Gérer le réseau 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 commande ibmcloud 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 managed-istio-custom ConfigMap pour examiner son contenu et la documentation en ligne.

   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 de composants istiod. Cette valeur doit être modifiée avec précaution. Une valeur trop faible peut empêcher le plan de contrôle de fonctionner correctement et une valeur trop élevée peut empêcher la programmation du pod istiod.

   istio-global-logging-level

   Valeur par défaut : "default:info"

   Permet de définir 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 une liste des champs d'application de chaque composant du plan de contrôle et du niveau d'information des messages de journalisation, consultez la documentation sur la journalisation des composants d'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 à partir 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 proxy Envoy impriment des 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 métriques de télémétrie et la prise en charge Prometheus sont activées. 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 traces pour 1 requête sur 100. 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 intervalles de trace pour 1 demande sur 100, soit 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 fixe à 5 le nombre maximum de pods de l'autoscaler horizontal (HPA) pour istiod. N'augmentez pas cette valeur à moins que vous n'ayez un grand maillage de services où istiod a besoin de ressources accrues 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

      data plane version: version.ProxyInfo{ID:"test-6f86fc4677-vsbsf.default", IstioVersion:"1.24.6"}
      data plane version: version.ProxyInfo{ID:"rerun-xfs-f8958bb94-j6n89.default", IstioVersion:"1.24.6"}
      data plane version: version.ProxyInfo{ID:"test2-5cbc75859c-jh6bx.default", IstioVersion:"1.24.6"}
      data plane version: version.ProxyInfo{ID:"minio-test-78b5d4597d-hkpvt.default", IstioVersion:"1.24.6"}
      data plane version: version.ProxyInfo{ID:"sb-887f89d7d-7s8ts.default", IstioVersion:"1.24.6"}
      data plane version: version.ProxyInfo{ID:"gid-deployment-5dc86db4c4-kdshs.default", IstioVersion:"1.24.6"}
      

   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.24.6"}.

      kubectl delete pod <pod_name> -n <namespace>
      

Vous souhaitez modifier un paramètre de 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!

Besoin de déboguer votre configuration de personnalisation dans 1.23?

Vérifiez les journaux pour le pod addon-istio-operator (Istio version 1.10 à 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 le module communautaire Istio

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

Avant de commencer : Si vous n'avez plus besoin d'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 fini de travailler avec Istio, vous pouvez nettoyer les ressources Istio dans 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