1.24. Référence de configuration du plan de contrôle Service Mesh
Vous pouvez personnaliser votre Red Hat OpenShift Service Mesh en modifiant la ressource par défaut ServiceMeshControlPlane (SMCP) ou en créant une ressource SMCP entièrement personnalisée. Cette section de référence documente les options de configuration disponibles pour la ressource SMCP.
1.24.1. Service Mesh Paramètres du plan de contrôle
Le tableau suivant répertorie les paramètres de premier niveau de la ressource ServiceMeshControlPlane.
| Nom | Description | Type |
|---|---|---|
|
|
APIVersion définit le schéma versionné de cette représentation d'un objet. Les serveurs convertissent les schémas reconnus à la dernière valeur interne et peuvent rejeter les valeurs non reconnues. La valeur pour la version 2.0 de |
La valeur pour |
|
| Kind est une chaîne de caractères qui représente la ressource REST que cet objet représente. |
|
|
|
Métadonnées sur cette instance | chaîne de caractères |
|
|
La spécification de l'état souhaité de ce site | Pour plus d'informations, voir le tableau 2. |
|
|
L'état actuel de ce site | Pour plus d'informations, voir le tableau 3. |
Le tableau suivant répertorie les spécifications de la ressource ServiceMeshControlPlane. La modification de ces paramètres configure les composants de Red Hat OpenShift Service Mesh.
| Nom | Description | Paramètres configurables |
|---|---|---|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre |
|
|
|
Le paramètre | N/A |
|
|
Si |
|
|
|
Le paramètre |
|
|
|
Vous utilisez le paramètre | chaîne de caractères |
ControlPlaneStatus représente l'état actuel de votre maillage de services.
| Nom | Description | Type |
|---|---|---|
|
|
Le paramètre | Non configurable |
|
|
Représente les dernières observations disponibles sur l'état actuel de l'objet. | chaîne de caractères |
|
| Indique l'état de chaque composant du plan de contrôle Service Mesh déployé. | chaîne de caractères |
|
| La spécification résultante des options de configuration après l'application de tous les profils. |
|
|
| Le fichier values.yaml utilisé pour générer les graphiques. |
|
|
| La version des graphiques qui a été traitée pour la dernière fois pour cette ressource. | chaîne de caractères |
|
|
Génération observée par le contrôleur lors du dernier rapprochement. Les informations contenues dans le statut se rapportent à cette génération particulière de l'objet. Le site | entier |
|
| La version de l'opérateur qui a traité cette ressource en dernier. | chaîne de caractères |
|
| L'état de préparation des ressources appartenant aux composantes &. | chaîne de caractères |
Cet exemple de définition de ServiceMeshControlPlane contient tous les paramètres pris en charge.
Exemple de ressource ServiceMeshControlPlane
apiVersion: maistra.io/v2
kind: ServiceMeshControlPlane
metadata:
name: basic
spec:
version: v2.3
proxy:
runtime:
container:
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 500m
memory: 128Mi
tracing:
type: Jaeger
gateways:
ingress: # istio-ingressgateway
service:
type: ClusterIP
ports:
- name: status-port
port: 15020
- name: http2
port: 80
targetPort: 8080
- name: https
port: 443
targetPort: 8443
meshExpansionPorts: []
egress: # istio-egressgateway
service:
type: ClusterIP
ports:
- name: status-port
port: 15020
- name: http2
port: 80
targetPort: 8080
- name: https
port: 443
targetPort: 8443
additionalIngress:
some-other-ingress-gateway: {}
additionalEgress:
some-other-egress-gateway: {}
policy:
type: Mixer
mixer: # only applies if policy.type: Mixer
enableChecks: true
failOpen: false
telemetry:
type: Istiod # or Mixer
mixer: # only applies if telemetry.type: Mixer, for v1 telemetry
sessionAffinity: false
batching:
maxEntries: 100
maxTime: 1s
adapters:
kubernetesenv: true
stdio:
enabled: true
outputAsJSON: true
addons:
grafana:
enabled: true
install:
config:
env: {}
envSecrets: {}
persistence:
enabled: true
storageClassName: ""
accessMode: ReadWriteOnce
capacity:
requests:
storage: 5Gi
service:
ingress:
contextPath: /grafana
tls:
termination: reencrypt
kiali:
name: kiali
enabled: true
install: # install kiali CR if not present
dashboard:
viewOnly: false
enableGrafana: true
enableTracing: true
enablePrometheus: true
service:
ingress:
contextPath: /kiali
jaeger:
name: jaeger
install:
storage:
type: Elasticsearch # or Memory
memory:
maxTraces: 100000
elasticsearch:
nodeCount: 3
storage: {}
redundancyPolicy: SingleRedundancy
indexCleaner: {}
ingress: {} # jaeger ingress configuration
runtime:
components:
pilot:
deployment:
replicas: 2
pod:
affinity: {}
container:
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 500m
memory: 128Mi
grafana:
deployment: {}
pod: {}
kiali:
deployment: {}
pod: {}
1.24.2. paramètres du spec
1.24.2.1. paramètres généraux
Voici un exemple qui illustre les paramètres spec.general pour l'objet ServiceMeshControlPlane et une description des paramètres disponibles avec les valeurs appropriées.
Exemple de paramètres généraux
apiVersion: maistra.io/v2
kind: ServiceMeshControlPlane
metadata:
name: basic
spec:
general:
logging:
componentLevels: {}
# misc: error
logAsJSON: false
validationMessages: true
| Paramètres | Description | Valeurs | Valeur par défaut |
|---|---|---|---|
l'exploitation forestière : | Permet de configurer la journalisation pour les composants du plan de contrôle de Service Mesh. | N/A | |
logging: componentLevels: | Permet de spécifier le niveau de journalisation du composant. |
Valeurs possibles : | N/A |
logging: logAsJSON: | Permet d'activer ou de désactiver la journalisation JSON. |
| N/A |
validationMessages : | Permet d'activer ou de désactiver les messages de validation des champs d'état des ressources istio.io. Cela peut être utile pour détecter les erreurs de configuration dans les ressources. |
| N/A |
1.24.2.2. paramètres des profils
Vous pouvez créer des configurations réutilisables avec les profils d'objets ServiceMeshControlPlane. Si vous ne configurez pas le paramètre profile, Red Hat OpenShift Service Mesh utilise le profil par défaut.
Voici un exemple qui illustre le paramètre spec.profiles pour l'objet ServiceMeshControlPlane:
Exemple de paramètres de profils
apiVersion: maistra.io/v2 kind: ServiceMeshControlPlane metadata: name: basic spec: profiles: - YourProfileName
Pour plus d'informations sur la création de profils, voir la section Création de profils de plan de contrôle.
Pour des exemples plus détaillés de configuration de la sécurité, voir Mutual Transport Layer Security (mTLS).
1.24.2.3. paramètres de techPreview
Le paramètre spec.techPreview permet un accès anticipé aux fonctionnalités qui font l'objet d'un aperçu technologique.
Les fonctionnalités de l'aperçu technologique ne sont pas prises en charge par les accords de niveau de service (SLA) de production de Red Hat et peuvent ne pas être complètes sur le plan fonctionnel. Red Hat ne recommande pas de les utiliser en production. Ces fonctionnalités offrent un accès anticipé aux fonctionnalités des produits à venir, ce qui permet aux clients de tester les fonctionnalités et de fournir un retour d'information pendant le processus de développement.
Pour plus d'informations sur la portée de l'assistance des fonctionnalités de l'aperçu technologique de Red Hat, voir Portée de l'assistance des fonctionnalités de l'aperçu technologique.
1.24.2.4. paramètres de traçage
L'exemple suivant illustre les paramètres spec.tracing pour l'objet ServiceMeshControlPlane, ainsi qu'une description des paramètres disponibles avec les valeurs appropriées.
Exemple de paramètres de traçage
apiVersion: maistra.io/v2
kind: ServiceMeshControlPlane
metadata:
name: basic
spec:
version: v2.3
tracing:
sampling: 100
type: Jaeger
| Paramètres | Description | Valeurs | Valeur par défaut |
|---|---|---|---|
tracing: sampling: | Le taux d'échantillonnage détermine la fréquence à laquelle le proxy Envoy génère une trace. Vous utilisez le taux d'échantillonnage pour contrôler le pourcentage de requêtes qui sont signalées à votre système de traçage. |
Valeurs entières entre 0 et 10000 représentant des incréments de 0,01% (0 à 100%). Par exemple, la valeur |
|
tracing: type: |
Actuellement, le seul type de traçage pris en charge est |
|
|
1.24.2.5. paramètre de version
L'Opérateur Red Hat OpenShift Service Mesh prend en charge l'installation de différentes versions de ServiceMeshControlPlane. Vous utilisez le paramètre de version pour spécifier la version du plan de contrôle Service Mesh à installer. Si vous ne spécifiez pas de paramètre de version lors de la création de votre SMCP, l'Opérateur définit la valeur de la dernière version : (2.3). Les objets ServiceMeshControlPlane existants conservent leur paramètre de version lors des mises à niveau de l'opérateur.
1.24.2.6. configuration 3scale
Le tableau suivant explique les paramètres de l'adaptateur Istio 3scale dans la ressource ServiceMeshControlPlane.
Exemple de paramètres 3scale
spec:
addons:
3Scale:
enabled: false
PARAM_THREESCALE_LISTEN_ADDR: 3333
PARAM_THREESCALE_LOG_LEVEL: info
PARAM_THREESCALE_LOG_JSON: true
PARAM_THREESCALE_LOG_GRPC: false
PARAM_THREESCALE_REPORT_METRICS: true
PARAM_THREESCALE_METRICS_PORT: 8080
PARAM_THREESCALE_CACHE_TTL_SECONDS: 300
PARAM_THREESCALE_CACHE_REFRESH_SECONDS: 180
PARAM_THREESCALE_CACHE_ENTRIES_MAX: 1000
PARAM_THREESCALE_CACHE_REFRESH_RETRIES: 1
PARAM_THREESCALE_ALLOW_INSECURE_CONN: false
PARAM_THREESCALE_CLIENT_TIMEOUT_SECONDS: 10
PARAM_THREESCALE_GRPC_CONN_MAX_SECONDS: 60
PARAM_USE_CACHED_BACKEND: false
PARAM_BACKEND_CACHE_FLUSH_INTERVAL_SECONDS: 15
PARAM_BACKEND_CACHE_POLICY_FAIL_CLOSED: true
| Paramètres | Description | Valeurs | Valeur par défaut |
|---|---|---|---|
|
| Utilisation ou non de l'adaptateur 3scale |
|
|
|
| Définit l'adresse d'écoute du serveur gRPC | Numéro de port valide |
|
|
| Définit le niveau minimum de sortie du journal. |
|
|
|
| Contrôle si le journal est formaté en JSON |
|
|
|
| Contrôle si le journal contient des informations gRPC |
|
|
|
| Contrôle si les métriques du système 3scale et du backend sont collectées et rapportées à Prometheus |
|
|
|
|
Définit le port à partir duquel le point d'extrémité 3scale | Numéro de port valide |
|
|
| Délai, en secondes, à attendre avant de purger les éléments expirés de la mémoire cache | Période de temps en secondes |
|
|
| Période de temps avant l'expiration au cours de laquelle les éléments du cache sont tentés d'être rafraîchis | Période de temps en secondes |
|
|
|
Nombre maximal d'éléments pouvant être stockés dans le cache à tout moment. La valeur | Numéro valide |
|
|
| Le nombre de fois où les hôtes inaccessibles sont réessayés pendant une boucle de mise à jour du cache | Numéro valide |
|
|
|
Permet d'ignorer la vérification des certificats lors de l'appel des API |
|
|
|
| Définit le nombre de secondes à attendre avant de terminer les requêtes vers le système 3scale et le backend | Période de temps en secondes |
|
|
| Définit le nombre maximum de secondes ( /-10% de gigue) qu'une connexion peut durer avant d'être fermée | Période de temps en secondes | 60 |
|
| Si true, tentative de création d'un cache d'apisonator en mémoire pour les demandes d'autorisation |
|
|
|
| Si le cache du backend est activé, ceci définit l'intervalle en secondes pour vider le cache par rapport à 3scale | Période de temps en secondes | 15 |
|
| Lorsque le cache du backend ne peut pas récupérer les données d'autorisation, il convient de refuser (fermé) ou d'autoriser (ouvert) les demandes |
|
|
1.24.3. paramètre d'état
Le paramètre status décrit l'état actuel de votre maillage de services. Cette information est générée par l'opérateur et est en lecture seule.
| Nom | Description | Type |
|---|---|---|
|
|
Génération observée par le contrôleur lors du dernier rapprochement. Les informations contenues dans le statut se rapportent à cette génération particulière de l'objet. Le site | entier |
|
|
Le paramètre | Non configurable |
|
| L'état de préparation des composants et des ressources détenues. | chaîne de caractères |
|
| La version de l'opérateur qui a traité cette ressource en dernier. | chaîne de caractères |
|
| Indique l'état de chaque composant du plan de contrôle Service Mesh déployé. | chaîne de caractères |
|
| La spécification résultante des options de configuration après l'application de tous les profils. |
|
|
|
Représente les dernières observations disponibles sur l'état actuel de l'objet. | chaîne de caractères |
|
| La version des graphiques qui a été traitée pour la dernière fois pour cette ressource. | chaîne de caractères |
|
|
Le fichier |
|
1.24.4. Ressources supplémentaires
Pour plus d'informations sur la configuration des fonctionnalités de la ressource
ServiceMeshControlPlane, consultez les liens suivants :
