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
ServiceMeshControlPlanesousspec.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.namedans la ressourceServiceMeshControlPlane. 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 denameexiste, 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 listeaccessible_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
| Paramètres | Description | Valeurs | Valeur par défaut |
|---|---|---|---|
spec:
addons:
kiali:
name:
|
Nom de la ressource personnalisée Kiali. S'il existe une CR Kiali correspondant à la valeur de | chaîne de caractères |
|
kiali: enabled: | Ce paramètre permet d'activer ou de désactiver Kiali. Kiali est activé par défaut. |
|
|
kiali: install: |
Installer une ressource Kiali si la ressource Kiali nommée n'est pas présente. La section | ||
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. |
|
|
kiali:
install:
dashboard:
enableGrafana:
|
Point d'extrémité Grafana configuré sur la base de la configuration |
|
|
kiali:
install:
dashboard:
enablePrometheus:
|
Point de terminaison Prometheus configuré sur la base de la configuration |
|
|
kiali:
install:
dashboard:
enableTracing:
| Point final de traçage configuré sur la base de la configuration des ressources personnalisées de Jaeger. |
|
|
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. |
|
|
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 | 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.
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.
