1.25. Référence de configuration de Kiali

Lorsque le Service Mesh Operator crée le site ServiceMeshControlPlane, il traite également la ressource Kiali. L'opérateur Kiali utilise ensuite cet objet lors de la création d'instances Kiali.

1.25.1. Spécifier la configuration de Kiali dans le SMCP

Vous pouvez configurer Kiali dans la section addons de la ressource ServiceMeshControlPlane. Kiali est activé par défaut. Pour désactiver Kiali, définissez spec.addons.kiali.enabled sur false.

Vous pouvez spécifier votre configuration Kiali de deux façons :

  • Spécifier la configuration Kiali dans la ressource ServiceMeshControlPlane sous spec.addons.kiali.install. Cette approche présente certaines limites, car la liste complète des configurations Kiali n'est pas disponible dans le SMCP.
  • Configurez et déployez une instance Kiali et spécifiez le nom de la ressource Kiali comme valeur de spec.addons.kiali.name dans la ressource ServiceMeshControlPlane. Vous devez créer le CR dans le même espace de noms que le plan de contrôle Service Mesh, par exemple, istio-system. Si une ressource Kiali correspondant à la valeur de name existe, le plan de contrôle configurera cette ressource Kiali pour l'utiliser avec le plan de contrôle. Cette approche vous permet de personnaliser entièrement votre configuration Kiali dans la ressource Kiali. Notez qu'avec cette approche, divers champs de la ressource Kiali sont remplacés par l'opérateur Service Mesh, en particulier la liste accessible_namespaces, ainsi que les points de terminaison pour Grafana, Prometheus et le traçage.

Exemple de paramètres SMCP pour Kiali

apiVersion: maistra.io/v2
kind: ServiceMeshControlPlane
metadata:
  name: basic
spec:
  addons:
    kiali:
      name: kiali
      enabled: true
      install:
        dashboard:
          viewOnly: false
          enableGrafana: true
          enableTracing: true
          enablePrometheus: true
        service:
          ingress:
            contextPath: /kiali

Tableau 1.38. ServiceMeshControlPlane Paramètres de Kiali

ParamètresDescriptionValeursValeur par défaut
spec:
  addons:
    kiali:
      name:

Nom de la ressource personnalisée Kiali. S'il existe une CR Kiali correspondant à la valeur de name, l'opérateur du Service Mesh utilisera cette CR pour l'installation. S'il n'existe pas de CR Kiali, l'opérateur en créera une à l'aide de cette adresse name et des options de configuration spécifiées dans le SMCP.

chaîne de caractères

kiali 

kiali:
  enabled:

Ce paramètre permet d'activer ou de désactiver Kiali. Kiali est activé par défaut.

true/false

true 

kiali:
  install:

Installer une ressource Kiali si la ressource Kiali nommée n'est pas présente. La section install est ignorée si addons.kiali.enabled est remplacé par false.

  
kiali:
  install:
    dashboard:

Paramètres de configuration des tableaux de bord livrés avec Kiali.

  
kiali:
  install:
    dashboard:
      viewOnly:

Ce paramètre permet d'activer ou de désactiver le mode vue seule pour la console Kiali. Lorsque ce mode est activé, les utilisateurs ne peuvent pas utiliser la console Kiali pour apporter des modifications au Service Mesh.

true/false

false 

kiali:
  install:
    dashboard:
      enableGrafana:

Point d'extrémité Grafana configuré sur la base de la configuration spec.addons.grafana.

true/false

true 

kiali:
  install:
    dashboard:
      enablePrometheus:

Point de terminaison Prometheus configuré sur la base de la configuration spec.addons.prometheus.

true/false

true 

kiali:
  install:
    dashboard:
      enableTracing:

Point final de traçage configuré sur la base de la configuration des ressources personnalisées de Jaeger.

true/false

true 

kiali:
  install:
    service:

Paramètres de configuration du service Kubernetes associé à l'installation de Kiali.

  
kiali:
  install:
    service:
      metadata:

Permet de spécifier des métadonnées supplémentaires à appliquer aux ressources.

N/A

N/A 

kiali:
  install:
    service:
      metadata:
        annotations:

Permet de spécifier des annotations supplémentaires à appliquer au service du composant.

chaîne de caractères

N/A 

kiali:
  install:
    service:
      metadata:
        labels:

Permet de spécifier des étiquettes supplémentaires à appliquer au service du composant.

chaîne de caractères

N/A 

kiali:
  install:
    service:
      ingress:

À utiliser pour spécifier les détails de l'accès au service du composant via une route OpenShift.

N/A

N/A 

kiali:
  install:
    service:
      ingress:
        metadata:
          annotations:

Permet de spécifier des annotations supplémentaires à appliquer à l'entrée du service du composant.

chaîne de caractères

N/A 

kiali:
  install:
    service:
      ingress:
        metadata:
          labels:

Permet de spécifier des étiquettes supplémentaires à appliquer à l'entrée de service du composant.

chaîne de caractères

N/A 

kiali:
  install:
    service:
      ingress:
        enabled:

Permet de personnaliser une route OpenShift pour le service associé à un composant.

true/false

true 

kiali:
  install:
    service:
      ingress:
        contextPath:

Permet de spécifier le chemin d'accès au contexte du service.

chaîne de caractères

N/A 

install:
  service:
    ingress:
      hosts:

Permet de spécifier un seul nom d'hôte par route OpenShift. Un nom d'hôte vide implique un nom d'hôte par défaut pour la route.

chaîne de caractères

N/A 

install:
  service:
    ingress:
      tls:

Permet de configurer le TLS pour la route OpenShift.

 

N/A 

kiali:
  install:
    service:
      nodePort:

Permet de spécifier le site nodePort pour le service du composant Values.<component>.service.nodePort.port

entier

N/A

1.25.2. Spécifier la configuration de Kiali dans une ressource personnalisée Kiali

Vous pouvez personnaliser entièrement votre déploiement Kiali en configurant Kiali dans la ressource personnalisée Kiali (CR) plutôt que dans la ressource ServiceMeshControlPlane (SMCP). Cette configuration est parfois appelée "Kiali externe" car la configuration est spécifiée en dehors du SMCP.

Note

Vous devez déployer les ressources personnalisées ServiceMeshControlPlane et Kiali dans le même espace de noms. Par exemple, istio-system.

Vous pouvez configurer et déployer une instance Kiali, puis spécifier le site name de la ressource Kiali comme valeur de spec.addons.kiali.name dans la ressource SMCP. S'il existe un CR Kiali correspondant à la valeur de name, le plan de contrôle Service Mesh utilisera l'installation existante. Cette approche vous permet de personnaliser entièrement votre configuration Kiali.