Compatibilité des API dans Cloud Service Mesh géré

Présentation

Cette documentation de référence liste les API Istio et Google Cloud compatibles avec Cloud Service Mesh géré avec TRAFFIC_DIRECTOR. Utilisez ce guide pour vérifier votre configuration avant d'activer des fonctionnalités.

  • Canaux de publication : fait référence aux canaux de publication GKE, avec Stable comme niveau le plus élevé et Rapide comme niveau le plus bas.
  • Non compatible : non compatible avec le plan de contrôle géré. Les champs non compatibles sont rejetés ou ignorés lors de la traduction de la configuration, ce qui entraîne un comportement non compatible et non défini.
  • Limites : comportement spécifique à prendre en compte pour le champ de l'API en raison de l'implémentation, qui peut différer de la définition de l'API.

DestinationRule (networking.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources DestinationRule.

Champs racine et de premier niveau

Le tableau suivant liste les champs racine et de premier niveau compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
exportTo Stable Tableau de chaînes Lorsque workloadSelector est défini, exportTo ne peut pas être exporté au-delà de l'espace de noms local (. ou espace de noms actuel uniquement).
host Stable Chaîne Veuillez saisir un nom DNS, un nom de domaine complet ou un préfixe de domaine générique valide. Les noms de domaine vides ne sont pas autorisés.
workloadSelector.matchLabels Stable Mappage clé-valeur Les caractères génériques (*) ne sont pas autorisés dans les clés ou les valeurs d'étiquette. Limite l'applicabilité aux charges de travail clientes dans l'espace de noms local.

Paramètres de l'équilibreur de charge (trafficPolicy.loadBalancer)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.loadBalancer.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
consistentHash.httpCookie.name Stable Chaîne Obligatoire lorsque httpCookie est configuré.
consistentHash.httpCookie.path Stable Chaîne
consistentHash.httpCookie.ttl Stable Durée
consistentHash.httpHeaderName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
consistentHash.httpQueryParameterName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
consistentHash.maglev.tableSize Stable Integer
consistentHash.minimumRingSize Stable Integer Obsolète. Utilisez plutôt ringHash.minimumRingSize. Ne peut pas être combiné avec ringHash ou maglev.
consistentHash.ringHash.minimumRingSize Stable Integer
consistentHash.useSourceIp Stable Booléen Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
localityLbSetting.distribute.from Non compatible Chaîne
localityLbSetting.distribute.to Non compatible Mappage clé-valeur
localityLbSetting.enabled Stable Booléen
localityLbSetting.failover.from Stable Chaîne Nécessite la configuration de outlierDetection sur la règle de trafic et n'est autorisé que syntaxiquement pour déclencher WATERFALL_BY_ZONE. Les chemins de routage spécifiques sont ignorés.
localityLbSetting.failover.to Stable Chaîne Nécessite la configuration de outlierDetection sur la règle de trafic et n'est autorisé que syntaxiquement pour déclencher WATERFALL_BY_ZONE. Les chemins de routage spécifiques sont ignorés.
localityLbSetting.failoverPriority Non compatible Tableau de chaînes
simple Stable Chaîne (ROUND_ROBIN, LEAST_CONN, RANDOM, PASSTHROUGH, LEAST_REQUEST) LEAST_CONN n'est pas compatible.
warmupDurationSecs Non compatible Chaîne

Paramètres du pool de connexions (trafficPolicy.connectionPool)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.connectionPool.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.h2UpgradePolicy Stable Chaîne (DEFAULT, DO_NOT_UPGRADE, UPGRADE) Ne peut pas être défini sur UPGRADE lorsque useClientProtocol est défini sur true.
http.http1MaxPendingRequests Stable Integer Doit être un entier non négatif (>= 0).
http.http2MaxRequests Stable Integer Doit être un entier non négatif (>= 0).
http.idleTimeout Stable Durée
http.maxRequestsPerConnection Stable Integer Doit être un entier non négatif (>= 0).
http.maxRetries Stable Integer Doit être un entier non négatif (>= 0).
http.useClientProtocol Stable Booléen Ne peut pas être true lorsque h2UpgradePolicy est UPGRADE.
tcp.connectTimeout Stable Durée
tcp.maxConnectionDuration Stable Durée S'applique uniquement aux services HTTP/HTTP2/gRPC. Ignoré pour les services de flux d'octets TCP.
tcp.maxConnections Stable Integer Doit être un entier non négatif (>= 0).
tcp.tcpKeepalive.interval Stable Durée
tcp.tcpKeepalive.probes Stable Integer
tcp.tcpKeepalive.time Stable Durée

Détection des anomalies (trafficPolicy.outlierDetection)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.outlierDetection.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
baseEjectionTime Stable Durée
consecutive5xxErrors Stable Integer
consecutiveErrors Non compatible Integer
consecutiveGatewayErrors Stable Integer
consecutiveLocalOriginFailures Stable Integer
interval Stable Durée
maxEjectionPercent Stable Integer
minHealthPercent Stable Integer
splitExternalLocalOriginErrors Stable Booléen

Paramètres TLS (trafficPolicy.tls)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.tls.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
caCertificates Stable Chaîne
clientCertificate Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
credentialName Non compatible Chaîne
insecureSkipVerify Stable Booléen Lorsque true, caCertificates et subjectAltNames doivent être vides.
mode Stable Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL) Le mode MUTUAL nécessite clientCertificate et privateKey.
privateKey Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
sni Stable Chaîne
subjectAltNames Stable Tableau de chaînes

Paramètres des tunnels (trafficPolicy.tunnel)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.tunnel.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
tunnel.protocol Non compatible Chaîne (CONNECT, POST)
tunnel.targetHost Non compatible Chaîne
tunnel.targetPort Non compatible Integer

Paramètres de port et d'équilibreur de charge (trafficPolicy.portLevelSettings.loadBalancer)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.portLevelSettings.loadBalancer.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
loadBalancer.consistentHash.httpCookie.name Stable Chaîne Obligatoire lorsque httpCookie est configuré.
loadBalancer.consistentHash.httpCookie.path Stable Chaîne
loadBalancer.consistentHash.httpCookie.ttl Stable Durée
loadBalancer.consistentHash.httpHeaderName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
loadBalancer.consistentHash.httpQueryParameterName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
loadBalancer.consistentHash.maglev.tableSize Stable Integer
loadBalancer.consistentHash.minimumRingSize Stable Integer Obsolète. Utilisez plutôt ringHash.minimumRingSize. Ne peut pas être combiné avec ringHash ou maglev.
loadBalancer.consistentHash.ringHash.minimumRingSize Stable Integer
loadBalancer.consistentHash.useSourceIp Stable Booléen Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
loadBalancer.localityLbSetting.distribute.from Non compatible Chaîne
loadBalancer.localityLbSetting.distribute.to Non compatible Mappage clé-valeur
loadBalancer.localityLbSetting.enabled Non compatible Booléen
loadBalancer.localityLbSetting.failover.from Non compatible Chaîne
loadBalancer.localityLbSetting.failover.to Non compatible Chaîne
loadBalancer.localityLbSetting.failoverPriority Non compatible Tableau de chaînes
loadBalancer.simple Stable Chaîne (ROUND_ROBIN, LEAST_CONN, RANDOM, PASSTHROUGH, LEAST_REQUEST) LEAST_CONN n'est pas compatible.
loadBalancer.warmupDurationSecs Non compatible Chaîne
port.number Stable Integer Obligatoire. Spécifie le numéro de port auquel ces règles de trafic s'appliquent.

Paramètres du pool de connexions (trafficPolicy.portLevelSettings.connectionPool)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.portLevelSettings.connectionPool.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.h2UpgradePolicy Stable Chaîne (DEFAULT, DO_NOT_UPGRADE, UPGRADE) Ne peut pas être défini sur UPGRADE lorsque useClientProtocol est défini sur true.
http.http1MaxPendingRequests Stable Integer Doit être un entier non négatif (>= 0).
http.http2MaxRequests Stable Integer Doit être un entier non négatif (>= 0).
http.idleTimeout Stable Durée
http.maxRequestsPerConnection Stable Integer Doit être un entier non négatif (>= 0).
http.maxRetries Stable Integer Doit être un entier non négatif (>= 0).
http.useClientProtocol Stable Booléen Ne peut pas être true lorsque h2UpgradePolicy est UPGRADE.
tcp.connectTimeout Stable Durée
tcp.maxConnectionDuration Stable Durée S'applique uniquement aux services HTTP/HTTP2/gRPC. Ignoré pour les services de flux d'octets TCP.
tcp.maxConnections Stable Integer Doit être un entier non négatif (>= 0).
tcp.tcpKeepalive.interval Stable Durée
tcp.tcpKeepalive.probes Stable Integer
tcp.tcpKeepalive.time Stable Durée

Paramètres de détection des anomalies (trafficPolicy.portLevelSettings.outlierDetection)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.portLevelSettings.outlierDetection.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
baseEjectionTime Non compatible Durée
consecutive5xxErrors Non compatible Integer
consecutiveErrors Non compatible Integer
consecutiveGatewayErrors Non compatible Integer
consecutiveLocalOriginFailures Non compatible Integer
interval Non compatible Durée
maxEjectionPercent Non compatible Integer
minHealthPercent Non compatible Integer
splitExternalLocalOriginErrors Non compatible Booléen

Paramètres TLS (trafficPolicy.portLevelSettings.tls)

Le tableau suivant liste la compatibilité au niveau des champs pour trafficPolicy.portLevelSettings.tls.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
tls.caCertificates Stable Chaîne
tls.clientCertificate Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
tls.credentialName Non compatible Chaîne
tls.insecureSkipVerify Stable Booléen Lorsque true, caCertificates et subjectAltNames doivent être vides.
tls.mode Stable Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL) Le mode MUTUAL nécessite clientCertificate et privateKey.
tls.privateKey Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
tls.sni Stable Chaîne
tls.subjectAltNames Stable Tableau de chaînes

Paramètres de racine et d'étiquette de sous-ensemble (sous-ensembles)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
labels Stable Mappage clé-valeur Doit respecter les règles de syntaxe des étiquettes Kubernetes pour sélectionner les points de terminaison cibles.
name Stable Chaîne Obligatoire. Doit être un libellé DNS 1123 valide.

Paramètres de l'équilibreur de charge de sous-ensemble (subsets.trafficPolicy.loadBalancer)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.loadBalancer.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
consistentHash.httpCookie.name Stable Chaîne Obligatoire lorsque httpCookie est configuré.
consistentHash.httpCookie.path Stable Chaîne
consistentHash.httpCookie.ttl Stable Durée
consistentHash.httpHeaderName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
consistentHash.httpQueryParameterName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
consistentHash.maglev.tableSize Stable Integer
consistentHash.minimumRingSize Stable Integer Obsolète. Utilisez plutôt ringHash.minimumRingSize. Ne peut pas être combiné avec ringHash ou maglev.
consistentHash.ringHash.minimumRingSize Stable Integer
consistentHash.useSourceIp Stable Booléen Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
localityLbSetting.distribute.from Non compatible Chaîne
localityLbSetting.distribute.to Non compatible Mappage clé-valeur
localityLbSetting.enabled Non compatible Booléen
localityLbSetting.failover.from Non compatible Chaîne
localityLbSetting.failover.to Non compatible Chaîne
localityLbSetting.failoverPriority Non compatible Tableau de chaînes
simple Stable Chaîne (ROUND_ROBIN, LEAST_CONN, RANDOM, PASSTHROUGH, LEAST_REQUEST) LEAST_CONN n'est pas compatible.
warmupDurationSecs Non compatible Chaîne

Paramètres du pool de connexions de sous-ensemble (subsets.trafficPolicy.connectionPool)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.connectionPool.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.h2UpgradePolicy Stable Chaîne (DEFAULT, DO_NOT_UPGRADE, UPGRADE) Ne peut pas être défini sur UPGRADE lorsque useClientProtocol est défini sur true.
http.http1MaxPendingRequests Stable Integer Doit être un entier non négatif (>= 0).
http.http2MaxRequests Stable Integer Doit être un entier non négatif (>= 0).
http.idleTimeout Stable Durée
http.maxRequestsPerConnection Stable Integer Doit être un entier non négatif (>= 0).
http.maxRetries Stable Integer Doit être un entier non négatif (>= 0).
http.useClientProtocol Stable Booléen Ne peut pas être true lorsque h2UpgradePolicy est UPGRADE.
tcp.connectTimeout Stable Durée
tcp.maxConnectionDuration Stable Durée S'applique uniquement aux services HTTP/HTTP2/gRPC. Ignoré pour les services de flux d'octets TCP.
tcp.maxConnections Stable Integer Doit être un entier non négatif (>= 0).
tcp.tcpKeepalive.interval Stable Durée
tcp.tcpKeepalive.probes Stable Integer
tcp.tcpKeepalive.time Stable Durée

Paramètres de détection des anomalies de sous-ensemble (subsets.trafficPolicy.outlierDetection)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.outlierDetection.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
baseEjectionTime Non compatible Durée
consecutive5xxErrors Non compatible Integer
consecutiveErrors Non compatible Integer
consecutiveGatewayErrors Non compatible Integer
consecutiveLocalOriginFailures Non compatible Integer
interval Non compatible Durée
maxEjectionPercent Non compatible Integer
minHealthPercent Non compatible Integer
splitExternalLocalOriginErrors Non compatible Booléen

Paramètres TLS et de tunnel du sous-ensemble (subsets.trafficPolicy.tls, tunnel)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.tls et tunnel.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
tls.caCertificates Stable Chaîne
tls.clientCertificate Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
tls.credentialName Non compatible Chaîne
tls.insecureSkipVerify Stable Booléen Lorsque true, caCertificates et subjectAltNames doivent être vides.
tls.mode Stable Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL) Le mode MUTUAL nécessite clientCertificate et privateKey.
tls.privateKey Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
tls.sni Stable Chaîne
tls.subjectAltNames Stable Tableau de chaînes
tunnel.protocol Non compatible Chaîne (CONNECT, POST)
tunnel.targetHost Non compatible Chaîne
tunnel.targetPort Non compatible Integer

Paramètres de port et d'équilibreur de charge du sous-ensemble (subsets.trafficPolicy.portLevelSettings.loadBalancer)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.portLevelSettings.loadBalancer.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
loadBalancer.consistentHash.httpCookie.name Stable Chaîne Obligatoire lorsque httpCookie est configuré.
loadBalancer.consistentHash.httpCookie.path Stable Chaîne
loadBalancer.consistentHash.httpCookie.ttl Stable Durée
loadBalancer.consistentHash.httpHeaderName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
loadBalancer.consistentHash.httpQueryParameterName Stable Chaîne Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
loadBalancer.consistentHash.maglev.tableSize Stable Integer
loadBalancer.consistentHash.minimumRingSize Stable Integer Obsolète. Utilisez plutôt ringHash.minimumRingSize. Ne peut pas être combiné avec ringHash ou maglev.
loadBalancer.consistentHash.ringHash.minimumRingSize Stable Integer
loadBalancer.consistentHash.useSourceIp Stable Booléen Vous ne pouvez spécifier qu'une seule stratégie de clé consistentHash.
loadBalancer.localityLbSetting.distribute.from Non compatible Chaîne
loadBalancer.localityLbSetting.distribute.to Non compatible Mappage clé-valeur
loadBalancer.localityLbSetting.enabled Non compatible Booléen
loadBalancer.localityLbSetting.failover.from Non compatible Chaîne
loadBalancer.localityLbSetting.failover.to Non compatible Chaîne
loadBalancer.localityLbSetting.failoverPriority Non compatible Tableau de chaînes
loadBalancer.simple Stable Chaîne (ROUND_ROBIN, LEAST_CONN, RANDOM, PASSTHROUGH, LEAST_REQUEST) LEAST_CONN n'est pas compatible.
loadBalancer.warmupDurationSecs Non compatible Chaîne
port.number Stable Integer Obligatoire. Spécifie le numéro de port auquel ces règles de trafic s'appliquent.

Paramètres du pool de connexions de sous-ensemble (subsets.trafficPolicy.portLevelSettings.connectionPool)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.portLevelSettings.connectionPool.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.h2UpgradePolicy Stable Chaîne (DEFAULT, DO_NOT_UPGRADE, UPGRADE) Ne peut pas être défini sur UPGRADE lorsque useClientProtocol est défini sur true.
http.http1MaxPendingRequests Stable Integer Doit être un entier non négatif (>= 0).
http.http2MaxRequests Stable Integer Doit être un entier non négatif (>= 0).
http.idleTimeout Stable Durée
http.maxRequestsPerConnection Stable Integer Doit être un entier non négatif (>= 0).
http.maxRetries Stable Integer Doit être un entier non négatif (>= 0).
http.useClientProtocol Stable Booléen Ne peut pas être true lorsque h2UpgradePolicy est UPGRADE.
tcp.connectTimeout Stable Durée
tcp.maxConnectionDuration Stable Durée S'applique uniquement aux services HTTP/HTTP2/gRPC. Ignoré pour les services de flux d'octets TCP.
tcp.maxConnections Stable Integer Doit être un entier non négatif (>= 0).
tcp.tcpKeepalive.interval Stable Durée
tcp.tcpKeepalive.probes Stable Integer
tcp.tcpKeepalive.time Stable Durée

Paramètres de détection des anomalies de sous-ensemble (subsets.trafficPolicy.portLevelSettings.outlierDetection)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.portLevelSettings.outlierDetection.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
baseEjectionTime Non compatible Durée
consecutive5xxErrors Non compatible Integer
consecutiveErrors Non compatible Integer
consecutiveGatewayErrors Non compatible Integer
consecutiveLocalOriginFailures Non compatible Integer
interval Non compatible Durée
maxEjectionPercent Non compatible Integer
minHealthPercent Non compatible Integer
splitExternalLocalOriginErrors Non compatible Booléen

Paramètres TLS du sous-ensemble (subsets.trafficPolicy.portLevelSettings.tls)

Le tableau suivant liste la compatibilité au niveau des champs pour subsets.trafficPolicy.portLevelSettings.tls.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
tls.caCertificates Stable Chaîne
tls.clientCertificate Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
tls.credentialName Non compatible Chaîne
tls.insecureSkipVerify Stable Booléen Lorsque true, caCertificates et subjectAltNames doivent être vides.
tls.mode Stable Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL) Le mode MUTUAL nécessite clientCertificate et privateKey.
tls.privateKey Stable Chaîne Obligatoire lorsque le mode est MUTUAL.
tls.sni Stable Chaîne
tls.subjectAltNames Stable Tableau de chaînes

EnvoyFilter (networking.istio.io/v1alpha3)

Les sections suivantes décrivent les champs compatibles avec les ressources EnvoyFilter.

Champs racine et de spécification

Le tableau suivant liste la compatibilité au niveau des champs.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
configPatches Stable Tableau d'objets
priority Stable Integer
workloadSelector Stable Mappage clé-valeur
workloadSelector.labels Stable Mappage clé-valeur

Correctifs de configuration (configPatches)

Le tableau suivant liste la compatibilité au niveau des champs pour configPatches.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
applyTo Stable Chaîne (HTTP_FILTER) Seule l'option HTTP_FILTER est acceptée.
match.cluster.name Non compatible Chaîne
match.cluster.portNumber Non compatible Integer
match.cluster.service Non compatible Chaîne
match.cluster.subset Non compatible Chaîne
match.context Stable Chaîne (ANY, SIDECAR_INBOUND, SIDECAR_OUTBOUND, GATEWAY)
match.listener.filterChain.applicationProtocols Non compatible Chaîne
match.listener.filterChain.destinationPort Non compatible Integer
match.listener.filterChain.filter.name Stable Chaîne Doit être envoy.filters.network.http_connection_manager lorsqu'il est utilisé avec INSERT_BEFORE.
match.listener.filterChain.filter.subFilter.name Stable Chaîne Doit être envoy.filters.http.router lorsqu'il est utilisé avec INSERT_BEFORE.
match.listener.filterChain.name Non compatible Chaîne
match.listener.filterChain.sni Non compatible Chaîne
match.listener.filterChain.transportProtocol Non compatible Chaîne
match.listener.listenerFilter Non compatible Chaîne
match.listener.name Non compatible Chaîne
match.listener.portName Non compatible Chaîne
match.listener.portNumber Non compatible Integer
match.proxy.metadata Non compatible Chaîne
match.proxy.proxyVersion Non compatible Chaîne
match.routeConfiguration.gateway Non compatible Chaîne
match.routeConfiguration.name Non compatible Chaîne
match.routeConfiguration.portName Non compatible Chaîne
match.routeConfiguration.portNumber Non compatible Integer
match.routeConfiguration.vhost.name Non compatible Chaîne
match.routeConfiguration.vhost.route.action Non compatible Chaîne (ANY, ROUTE, REDIRECT, DIRECT_RESPONSE)
match.routeConfiguration.vhost.route.name Non compatible Chaîne
patch.filterClass Non compatible Chaîne (UNSPECIFIED, AUTHN, AUTHZ, STATS)
patch.operation Stable Chaîne (INSERT_FIRST, INSERT_BEFORE) Seuls INSERT_FIRST et INSERT_BEFORE sont acceptés.
patch.value Stable Chaîne

Gateway (networking.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources Gateway.

Champs racines

Le tableau suivant liste les champs racine compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
selector Stable Mappage clé-valeur
servers Stable Tableau d'objets

Paramètres du serveur (serveurs)

Le tableau suivant liste la compatibilité au niveau des champs pour servers.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
bind Stable Chaîne Les adresses IP sont acceptées. Les sockets de domaine Unix (UDS) ne sont pas compatibles.
defaultEndpoint Non compatible Chaîne
hosts Stable Tableau de chaînes Veuillez indiquer au moins un hôte. Compatible avec le format <namespace>/<hostname>.
name Non compatible Chaîne
port.name Stable Chaîne Obligatoire. Les noms de port doivent être uniques sur tous les serveurs de la passerelle.
port.number Stable Integer Obligatoire. Doit être un numéro de port valide compris entre 1 et 65535.
port.protocol Stable Chaîne (HTTP, HTTPS, GRPC, GRPC-WEB, HTTP2, MONGO, MYSQL, REDIS, TCP, TLS) Les protocoles MONGO, MYSQL et REDIS sont traités comme du trafic TCP brut. Les filtres Envoy spécifiques au protocole (comme mongo_proxy) ne sont pas acceptés.
port.targetPort Non compatible Integer

Paramètres TLS du serveur (servers.tls)

Le tableau suivant liste la compatibilité au niveau des champs pour servers.tls.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
caCertificates Stable Chaîne Obligatoire pour le mode MUTUAL, sauf si credentialName est défini.
cipherSuites Stable Tableau de chaînes Doit être spécifié lorsque minProtocolVersion est défini sur TLSV1_0 ou TLSV1_1.
credentialName Stable Chaîne Uniquement compatible lorsque mode est défini sur SIMPLE ou MUTUAL (le préfixe builtin:// n'est compatible que lorsque mode est défini sur MUTUAL).
httpsRedirect Stable Booléen Uniquement compatible lorsque port.protocol est défini sur HTTP, HTTP2 ou GRPC.
maxProtocolVersion Stable Chaîne (TLS_AUTO, TLSV1_0, TLSV1_1, TLSV1_2, TLSV1_3)
minProtocolVersion Stable Chaîne (TLS_AUTO, TLSV1_0, TLSV1_1, TLSV1_2, TLSV1_3)
mode Stable Chaîne (PASSTHROUGH, SIMPLE, MUTUAL, ISTIO_MUTUAL) AUTO_PASSTHROUGH et OPTIONAL_MUTUAL ne sont pas compatibles. ISTIO_MUTUAL gère les certificats automatiquement.
privateKey Stable Chaîne Obligatoire pour les modes SIMPLE et MUTUAL, sauf si credentialName est défini.
serverCertificate Stable Chaîne Obligatoire pour les modes SIMPLE et MUTUAL, sauf si credentialName est défini.
subjectAltNames Stable Tableau de chaînes 8 entrées SAN maximum par serveur (les entrées au-delà de 8 sont tronquées). Uniquement compatible lorsque mode est MUTUAL ou ISTIO_MUTUAL. Seules les correspondances exactes et de préfixe (*) sont acceptées.
verifyCertificateHash Non compatible Tableau de chaînes
verifyCertificateSpki Non compatible Tableau de chaînes

ProxyConfig (networking.istio.io/v1beta1)

La ressource personnalisée (CR) ProxyConfig n'est pas compatible.

ServiceEntry (networking.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources ServiceEntry.

Configuration racine et générale

Le tableau suivant liste les champs de configuration racine et généraux compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
addresses Stable Tableau de chaînes Les sous-réseaux CIDR ne sont compatibles qu'avec une résolution STATIC ou NONE. Obligatoire pour les ports TCP.
exportTo Stable Tableau de chaînes
hosts Stable Tableau de chaînes Veuillez indiquer au moins un hôte. * seul n'est pas autorisé. Plusieurs hôtes nécessitent les ports HTTP/HTTPS/TLS.
location Stable Chaîne (MESH_EXTERNAL, MESH_INTERNAL) MESH_INTERNAL n'est pas compatible.
resolution Stable Chaîne (NONE, STATIC, DNS, DNS_ROUND_ROBIN) DNS_ROUND_ROBIN n'est pas compatible. NONE nécessite des points de terminaison vides ; STATIC nécessite des points de terminaison.
subjectAltNames Non compatible Tableau de chaînes
workloadSelector.labels Non compatible Mappage clé-valeur

Paramètres des ports (ports)

Le tableau suivant liste la compatibilité au niveau des champs pour ports.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
name Stable Chaîne Obligatoire. Les noms de ports doivent être uniques dans l'ensemble de l'objet ServiceEntry.
number Stable Integer Obligatoire (1-65535). Les numéros de port doivent être uniques dans l'ensemble de l'objet ServiceEntry.
protocol Stable Chaîne (HTTP, HTTPS, GRPC, HTTP2, MONGO, TCP, TLS)
targetPort Stable Integer S'il est spécifié, il doit s'agir d'un numéro de port valide (compris entre 1 et 65 535).

Paramètres des points de terminaison (endpoints)

Le tableau suivant liste la compatibilité au niveau des champs pour endpoints.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
address Stable Chaîne Obligatoire. Doit être une adresse IP valide pour la résolution STATIC, ou un nom de domaine complet ou une adresse IP pour la résolution DNS.
labels Stable Mappage clé-valeur Doit respecter les règles de syntaxe des étiquettes Kubernetes.
locality Non compatible Chaîne
network Non compatible Chaîne
ports Stable Mappage clé-valeur Les noms de ports dans le mappage doivent correspondre aux noms de ports définis dans spec.ports.
serviceAccount Non compatible Chaîne
weight Non compatible Integer

Sidecar (networking.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources Sidecar.

Configuration racine et générale

Le tableau suivant liste les champs de configuration racine et généraux compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
workloadSelector Stable Objet Sous réserve des limites d'évolutivité des ressources Istio Sidecar : 150 ressources Sidecar au maximum par cluster et 20 avec workloadSelector par cluster (les ressources Sidecar avec workloadSelector sont comptabilisées dans les deux limites).
workloadSelector.labels Stable Mappage clé-valeur Sous réserve des limites d'évolutivité des ressources Istio Sidecar (maximum 20 ressources Sidecar avec workloadSelector par cluster, qui sont également comptabilisées dans la limite totale de 150).

Écouteurs de sortie (egress)

Le tableau suivant liste la compatibilité au niveau des champs pour egress.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
bind Non compatible Chaîne
captureMode Non compatible Chaîne (DEFAULT, IPTABLES, NONE)
hosts Stable Tableau de chaînes Seule la première entrée d'écouteur egress correspondante sans spécification de port est traitée. Si plusieurs écouteurs egress sont déclarés dans une même ressource Sidecar, tous les écouteurs après le premier sont ignorés sans avertissement. Le qualificatif d'espace de noms ~ (qui ne représente aucun espace de noms dans Istio) n'est pas accepté. Pour ne faire correspondre aucun hôte, définissez explicitement hosts: [] (liste vide) dans une entrée d'écouteur egress.
port.name Non compatible Chaîne
port.number Non compatible Integer
port.protocol Non compatible Chaîne (HTTP, HTTPS, GRPC, HTTP2, MONGO, TCP, TLS)
port.targetPort Non compatible Integer

Écouteurs d'entrée : port et liaison (entrée)

Le tableau suivant liste la compatibilité au niveau des champs pour ingress.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
bind Non compatible Chaîne
captureMode Non compatible Chaîne (DEFAULT, IPTABLES, NONE)
defaultEndpoint Non compatible Chaîne
port.name Non compatible Chaîne
port.number Non compatible Integer
port.protocol Non compatible Chaîne (HTTP, HTTPS, GRPC, HTTP2, MONGO, TCP, TLS)
port.targetPort Non compatible Integer

Écouteurs d'entrée : paramètres TLS (ingress.tls)

Le tableau suivant liste la compatibilité au niveau des champs pour ingress.tls.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
caCertificates Non compatible Chaîne
cipherSuites Non compatible Tableau de chaînes
credentialName Non compatible Chaîne
httpsRedirect Non compatible Booléen
maxProtocolVersion Non compatible Chaîne (TLS_AUTO, TLSV1_0, TLSV1_1, TLSV1_2, TLSV1_3)
minProtocolVersion Non compatible Chaîne (TLS_AUTO, TLSV1_0, TLSV1_1, TLSV1_2, TLSV1_3)
mode Non compatible Chaîne (PASSTHROUGH, SIMPLE, MUTUAL, AUTO_PASSTHROUGH, ISTIO_MUTUAL, OPTIONAL_MUTUAL)
privateKey Non compatible Chaîne
serverCertificate Non compatible Chaîne
subjectAltNames Non compatible Tableau de chaînes
verifyCertificateHash Non compatible Tableau de chaînes
verifyCertificateSpki Non compatible Tableau de chaînes

Règle de trafic sortant (outboundTrafficPolicy)

Le tableau suivant liste la compatibilité au niveau des champs pour outboundTrafficPolicy.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
egressProxy.host Non compatible Chaîne
egressProxy.port.number Non compatible Integer
egressProxy.subset Non compatible Chaîne
mode Stable Chaîne (REGISTRY_ONLY, ALLOW_ANY) S'il est omis sur une charge de travail ou un espace de noms Sidecar, MeshConfig.outboundTrafficPolicy prévaut sur la racine (istio-system) Sidecar.

VirtualService (networking.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources VirtualService.

Configuration racine et générale

Le tableau suivant liste les champs de configuration racine et généraux compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
exportTo Stable Tableau de chaînes
gateways Stable Tableau de chaînes La valeur par défaut est mesh si elle est omise. Doit correspondre à un nom de passerelle ou à mesh. Impossible d'effectuer une liaison à la fois avec mesh et d'autres passerelles.
hosts Stable Tableau de chaînes Veuillez indiquer au moins un hôte, sauf s'il est configuré en tant que délégué. Le caractère générique * n'est pas autorisé lorsqu'il est lié à un maillage.

Paramètres de routage HTTP (http)

Le tableau suivant liste la compatibilité au niveau des champs pour http.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
delegate.name Stable Chaîne Obligatoire pour la route déléguée. Doit être un libellé DNS valide.
delegate.namespace Stable Chaîne
name Stable Chaîne
timeout Stable Durée

Conditions de correspondance HTTP (http.match)

Le tableau suivant liste la compatibilité au niveau des champs pour http.match.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
authority.exact Stable Chaîne
authority.prefix Stable Chaîne
authority.regex Stable Chaîne Doit être une expression régulière RE2 valide (< 1 024 caractères).
gateways Stable Tableau de chaînes La valeur par défaut est mesh si elle est omise. Doit correspondre à un nom de passerelle ou à mesh. Impossible d'effectuer une liaison à la fois avec mesh et d'autres passerelles.
headers.exact Stable Mappage clé-valeur
headers.prefix Stable Mappage clé-valeur
headers.regex Stable Mappage clé-valeur Doit être une expression régulière RE2 valide (< 1 024 caractères).
ignoreUriCase Stable Booléen
method.exact Stable Chaîne
method.prefix Stable Chaîne
method.regex Stable Chaîne Doit être une expression régulière RE2 valide (< 1 024 caractères).
name Stable Chaîne
port Stable Integer Doit être un numéro de port valide (compris entre 1 et 65535).
queryParams.exact Stable Mappage clé-valeur
queryParams.prefix Stable Mappage clé-valeur
queryParams.regex Stable Mappage clé-valeur Doit être une expression régulière RE2 valide (< 1 024 caractères).
scheme.exact Stable Chaîne
scheme.prefix Stable Chaîne
scheme.regex Stable Chaîne Doit être une expression régulière RE2 valide (< 1 024 caractères).
sourceLabels Stable Mappage clé-valeur Doit respecter les règles de syntaxe des étiquettes Kubernetes.
sourceNamespace Stable Chaîne Doit être un libellé DNS valide.
statPrefix Non compatible Chaîne
uri.exact Stable Chaîne
uri.prefix Stable Chaîne
uri.regex Stable Chaîne Doit être une expression régulière RE2 valide (< 1 024 caractères).
withoutHeaders.exact Stable Mappage clé-valeur
withoutHeaders.prefix Stable Mappage clé-valeur
withoutHeaders.regex Stable Mappage clé-valeur Doit être une expression régulière RE2 valide (< 1 024 caractères).

Destinations de routage HTTP (http.route)

Le tableau suivant liste la compatibilité au niveau des champs pour http.route.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
destination.host Stable Chaîne Obligatoire. Veuillez saisir un hôte de service valide.
destination.port.number Stable Integer Doit être un numéro de port valide (compris entre 1 et 65535).
destination.subset Stable Chaîne
headers.request.add Stable Mappage clé-valeur Les pseudo-en-têtes internes commençant par : (à l'exception de :authority) ne peuvent pas être modifiés.
headers.request.remove Stable Tableau de chaînes Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
headers.request.set Stable Mappage clé-valeur Les pseudo-en-têtes internes commençant par : (à l'exception de :authority) ne peuvent pas être modifiés.
headers.response.add Stable Mappage clé-valeur Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
headers.response.remove Stable Tableau de chaînes Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
headers.response.set Stable Mappage clé-valeur Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
weight Stable Integer Entier non négatif. La pondération totale doit être supérieure à 0 lorsque plusieurs destinations sont spécifiées.

Redirection HTTP et réponse directe (http.redirect, directResponse)

Le tableau suivant liste la compatibilité au niveau des champs pour http.redirect et directResponse.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.directResponse.body.bytes Stable Chaîne La taille maximale du corps de la réponse est de 1 Mo.
http.directResponse.body.string Stable Chaîne La taille maximale du corps de la réponse est de 1 Mo.
http.directResponse.status Stable Integer Le code d'état doit être compris entre 200 et 600.
http.redirect.authority Stable Chaîne
http.redirect.derivePort Stable Chaîne (FROM_PROTOCOL_DEFAULT, FROM_REQUEST_PORT)
http.redirect.port Stable Integer Doit être un numéro de port valide (compris entre 1 et 65535).
http.redirect.redirectCode Stable Integer Le code de redirection doit être de type 3xx (300-399).
http.redirect.scheme Stable Chaîne Doit être http ou https.
http.redirect.uri Stable Chaîne

Réécriture HTTP et règle CORS (http.rewrite, corsPolicy)

Le tableau suivant liste la compatibilité au niveau des champs pour http.rewrite et corsPolicy.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.corsPolicy.allowCredentials Stable Booléen
http.corsPolicy.allowHeaders Stable Tableau de chaînes
http.corsPolicy.allowMethods Stable Tableau de chaînes Méthodes compatibles : GET, HEAD, POST, PUT, PATCH, DELETE, CONNECT, OPTIONS, TRACE.
http.corsPolicy.allowOrigin Non compatible Tableau de chaînes
http.corsPolicy.allowOrigins.exact Stable Chaîne
http.corsPolicy.allowOrigins.prefix Stable Chaîne
http.corsPolicy.allowOrigins.regex Stable Chaîne Doit être une expression régulière RE2 valide (< 1 024 caractères).
http.corsPolicy.exposeHeaders Stable Tableau de chaînes
http.corsPolicy.maxAge Stable Durée
http.rewrite.authority Stable Chaîne
http.rewrite.uri Stable Chaîne Ne peut pas être défini en même temps que uriRegexRewrite.
http.rewrite.uriRegexRewrite.match Stable Chaîne Ne peut pas être défini simultanément avec la réécriture uri.
http.rewrite.uriRegexRewrite.rewrite Stable Chaîne Ne peut pas être défini simultanément avec la réécriture uri.

Nouvelles tentatives HTTP et opérations d'en-tête (http.retries, headers)

Le tableau suivant liste la compatibilité au niveau des champs pour http.retries et headers.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.headers.request.add Stable Mappage clé-valeur Les pseudo-en-têtes internes commençant par : (à l'exception de :authority) ne peuvent pas être modifiés.
http.headers.request.remove Stable Tableau de chaînes Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
http.headers.request.set Stable Mappage clé-valeur Les pseudo-en-têtes internes commençant par : (à l'exception de :authority) ne peuvent pas être modifiés.
http.headers.response.add Stable Mappage clé-valeur Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
http.headers.response.remove Stable Tableau de chaînes Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
http.headers.response.set Stable Mappage clé-valeur Host et les pseudo-en-têtes internes commençant par : ne peuvent pas être modifiés.
http.retries.attempts Stable Integer Entier non négatif. Doit être supérieur à 0 si retryOn ou perTryTimeout est configuré.
http.retries.perTryTimeout Stable Durée
http.retries.retryOn Stable Chaîne
http.retries.retryRemoteLocalities Stable Booléen

Injection de défaillance HTTP (http.fault)

Le tableau suivant liste la compatibilité au niveau des champs pour http.fault.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
abort.grpcStatus Non compatible Chaîne
abort.http2Error Non compatible Chaîne
abort.httpStatus Stable Integer Le code d'état HTTP d'abandon doit être compris entre 200 et 599.
abort.percentage.value Stable Double Le pourcentage doit être compris entre 0 et 100.
delay.exponentialDelay Non compatible Durée
delay.fixedDelay Stable Durée La durée de délai fixe est acceptée. Le délai exponentiel n'est pas pris en charge.
delay.percent Non compatible Integer La valeur de pourcentage entière est obsolète. Utilisez plutôt le champ "Pourcentage double".
delay.percentage.value Stable Double Le pourcentage doit être compris entre 0 et 100.

Mise en miroir du trafic HTTP (http.mirror, mirrors)

Le tableau suivant liste la compatibilité au niveau des champs pour http.mirror et mirrors.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
http.mirror.host Stable Chaîne Destination de mise en miroir unique. Ne peut pas être combiné avec mirrors.
http.mirror.port.number Stable Integer
http.mirror.subset Stable Chaîne
http.mirrorPercent Non compatible Integer
http.mirrorPercentage.value Stable Double Le pourcentage doit être compris entre 0 et 100.
http.mirrors.destination.host Non compatible Chaîne Seul le champ singulier http.mirror est accepté. Les miroirs multiples configurés à l'aide de http.mirrors sont ignorés.
http.mirrors.destination.port.number Non compatible Integer Seul le champ singulier http.mirror est accepté. Les miroirs multiples configurés à l'aide de http.mirrors sont ignorés.
http.mirrors.destination.subset Non compatible Chaîne Seul le champ singulier http.mirror est accepté. Les miroirs multiples configurés à l'aide de http.mirrors sont ignorés.
http.mirrors.percentage.value Non compatible Double Seul le champ singulier http.mirror est accepté. Les miroirs multiples configurés à l'aide de http.mirrors sont ignorés.

Routage TLS (tls)

Le tableau suivant liste la compatibilité au niveau des champs pour tls.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
match.destinationSubnets Stable Tableau de chaînes Doit être une chaîne de sous-réseau IP CIDR valide.
match.gateways Stable Tableau de chaînes
match.port Stable Integer Doit être un numéro de port valide (compris entre 1 et 65535).
match.sniHosts Stable Tableau de chaînes Veuillez indiquer au moins un hôte SNI. Les caractères génériques complets (*) et partiels (par exemple, *example.com) ne sont pas acceptés. Seuls les caractères génériques de sous-domaine (par exemple, *.example.com) sont autorisés.
match.sourceLabels Non compatible Mappage clé-valeur
match.sourceNamespace Non compatible Chaîne
route.destination.host Stable Chaîne Obligatoire. Veuillez saisir un hôte de service valide.
route.destination.port.number Stable Integer Doit être un numéro de port valide (compris entre 1 et 65535).
route.destination.subset Stable Chaîne
route.weight Stable Integer Entier non négatif. La pondération totale doit être supérieure à 0 lorsque plusieurs destinations sont spécifiées.

Routage TCP (tcp)

Le tableau suivant liste la compatibilité au niveau des champs pour tcp.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
match.destinationSubnets Stable Tableau de chaînes Doit être une chaîne de sous-réseau IP CIDR valide.
match.gateways Stable Tableau de chaînes
match.port Stable Integer Doit être un numéro de port valide (compris entre 1 et 65535).
match.sourceLabels Non compatible Mappage clé-valeur
match.sourceNamespace Non compatible Chaîne
match.sourceSubnet Non compatible Chaîne
route.destination.host Stable Chaîne Obligatoire. Veuillez saisir un hôte de service valide.
route.destination.port.number Stable Integer Doit être un numéro de port valide (compris entre 1 et 65535).
route.destination.subset Stable Chaîne
route.weight Stable Integer Entier non négatif. La pondération totale doit être supérieure à 0 lorsque plusieurs destinations sont spécifiées.

WorkloadEntry (networking.istio.io/v1beta1)

La ressource personnalisée (CR) WorkloadEntry n'est pas compatible.

WorkloadGroup (networking.istio.io/v1beta1)

La ressource personnalisée (CR) WorkloadGroup n'est pas compatible.

AuthorizationPolicy (security.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources AuthorizationPolicy.

Champs racine et de spécification

Le tableau suivant liste la compatibilité au niveau des champs.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
action Stable Chaîne (ALLOW, DENY, AUDIT, CUSTOM)
provider.name Stable Chaîne Uniquement compatible lorsque action: CUSTOM.
selector.matchLabels Stable Mappage clé-valeur En cas d'omission, s'applique à toutes les charges de travail de l'espace de noms.

À partir des sources (rules.from.source)

Le tableau suivant liste la compatibilité au niveau des champs pour rules.from.source.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
ipBlocks Stable Tableau de chaînes
notIpBlocks Stable Tableau de chaînes
namespaces Stable Tableau de chaînes
notNamespaces Stable Tableau de chaînes
principals Stable Tableau de chaînes
notPrincipals Stable Tableau de chaînes
remoteIpBlocks Stable Tableau de chaînes
notRemoteIpBlocks Stable Tableau de chaînes
requestPrincipals Stable Tableau de chaînes
notRequestPrincipals Stable Tableau de chaînes

Vers des opérations (rules.to.operation)

Le tableau suivant liste la compatibilité au niveau des champs pour rules.to.operation.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
hosts Stable Tableau de chaînes
methods Stable Tableau de chaînes
notHosts Stable Tableau de chaînes
notMethods Stable Tableau de chaînes
notPaths Stable Tableau de chaînes Seule la correspondance de caractères génériques de préfixe et de suffixe est acceptée.
notPorts Stable Tableau d'objets Doit être un numéro de port valide (compris entre 1 et 65535).
paths Stable Tableau de chaînes Seule la correspondance de caractères génériques de préfixe et de suffixe est acceptée.
ports Stable Tableau d'objets Doit être un numéro de port valide (compris entre 1 et 65535).

Conditions "When" (rules.when)

Le tableau suivant liste la compatibilité au niveau des champs pour rules.when.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
key Stable Chaîne Clés compatibles : request.headers, request.auth.claims, adresses IP, ports, comptes principaux. Lorsque action est défini sur CUSTOM, les clés source.namespace, source.principal et request.auth.* ne sont pas acceptées. destination.namespace/labels non compatible.
notValues Stable Tableau de chaînes Vous devez spécifier au moins values ou notValues.
values Stable Tableau de chaînes Vous devez spécifier au moins values ou notValues.

PeerAuthentication (security.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources PeerAuthentication.

Champs racine et de spécification

Le tableau suivant liste la compatibilité au niveau des champs.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
mtls.mode Stable Chaîne (UNSET, DISABLE, PERMISSIVE, STRICT) Le mode DISABLE n'est pas pris en charge.
portLevelMtls.mode Stable Chaîne (UNSET, DISABLE, PERMISSIVE, STRICT) Le mode DISABLE n'est pas pris en charge.
selector.matchLabels Stable Mappage clé-valeur La règle de l'espace de noms racine n'est pas autorisée à comporter un sélecteur d'étiquettes.

RequestAuthentication (security.istio.io/v1beta1)

Les sections suivantes décrivent les champs compatibles avec les ressources RequestAuthentication.

Champs racines

Le tableau suivant liste les champs racine compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
selector.matchLabels Stable Mappage clé-valeur En cas d'omission, s'applique à toutes les charges de travail de l'espace de noms. Les caractères génériques (*) ne sont pas autorisés.

Règles JWT (jwtRules)

Le tableau suivant liste la compatibilité au niveau des champs pour jwtRules.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
audiences Stable Tableau de chaînes
forwardOriginalToken Stable Booléen
fromHeaders.name Stable Chaîne
fromHeaders.prefix Stable Chaîne
fromParams Stable Tableau de chaînes
issuer Stable Chaîne
jwks Stable Chaîne Seul l'un des champs jwksUri et jwks doit être utilisé.
jwksUri Stable Chaîne Seul l'un des champs jwksUri et jwks doit être utilisé.
outputClaimToHeaders.claim Non compatible Chaîne
outputClaimToHeaders.header Non compatible Chaîne
outputPayloadToHeader Stable Chaîne

Telemetry (telemetry.istio.io/v1alpha1)

Les sections suivantes décrivent les champs compatibles avec les ressources Telemetry.

Configuration racine et générale

Le tableau suivant liste les champs de configuration racine et généraux compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
selector.matchLabels Standard Mappage clé-valeur Dans la version stable, seule la télémétrie à l'échelle du maillage dans l'espace de noms racine est compatible.

Journalisation des accès (accessLogging)

Le tableau suivant liste la compatibilité au niveau des champs pour accessLogging.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
disabled Stable Booléen Désactive la journalisation des accès pour le fournisseur.
filter.expression Non compatible Chaîne
match.mode Non compatible Chaîne (CLIENT_AND_SERVER, CLIENT, SERVER)
providers.name Stable Chaîne Envoy ou Stackdriver uniquement.

Traçage (tracing)

Le tableau suivant liste la compatibilité au niveau des champs pour tracing.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
customTags.environment.defaultValue Non compatible Chaîne
customTags.environment.name Non compatible Chaîne
customTags.header.defaultValue Non compatible Chaîne
customTags.header.name Non compatible Chaîne
customTags.literal.value Non compatible Chaîne
disableSpanReporting Stable Booléen Désactive la création de rapports sur les segments dans Cloud Trace.
match.mode Non compatible Chaîne (CLIENT_AND_SERVER, CLIENT, SERVER)
providers.name Stable Chaîne Stackdriver exclusivement.
randomSamplingPercentage Standard Double La valeur par défaut est 0.0. Plage de valeurs acceptée : 0,0 à 100,0.
useRequestIdForTraceSampling Non compatible Booléen

Métriques (metrics)

Le tableau suivant liste la compatibilité au niveau des champs pour metrics.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
overrides.disabled Non compatible Booléen
overrides.match.customMatch Non compatible Tableau d'objets
overrides.match.customMetric Non compatible Chaîne
overrides.match.metric Non compatible Chaîne (ALL_METRICS, REQUEST_COUNT, REQUEST_DURATION, REQUEST_SIZE, RESPONSE_SIZE, TCP_OPENED_CONNECTIONS, TCP_CLOSED_CONNECTIONS, TCP_SENT_BYTES, TCP_RECEIVED_BYTES, GRPC_REQUEST_MESSAGES, GRPC_RESPONSE_MESSAGES)
overrides.match.mode Non compatible Chaîne (CLIENT_AND_SERVER, CLIENT, SERVER)
overrides.tagOverrides.operation Non compatible Chaîne (UPSERT, REMOVE)
overrides.tagOverrides.value Non compatible Chaîne
providers.name Non compatible Chaîne
reportingInterval Non compatible Durée

WasmPlugin (extensions.istio.io/v1alpha1)

La ressource personnalisée (CR) WasmPlugin n'est pas compatible.

MeshConfig (mesh.istio.io/v1alpha1)

Les sections suivantes décrivent les champs compatibles avec les ressources MeshConfig.

Configuration racine et générale

Le tableau suivant liste les champs de configuration racine et généraux compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
accessLogEncoding Rapide Chaîne (TEXT, JSON) Formats d'encodage compatibles : TEXT ou JSON.
accessLogFile Stable Chaîne Chemin de destination pour la journalisation des accès Envoy (par exemple, /dev/stdout).
accessLogFormat Rapide Chaîne
connectTimeout Non compatible Durée
defaultDestinationRuleExportTo Stable Tableau de chaînes Champ d'application d'exportation par défaut pour DestinationRules (par défaut : *).
defaultHttpRetryPolicy.attempts Non compatible Integer
defaultHttpRetryPolicy.perTryTimeout Non compatible Durée
defaultHttpRetryPolicy.retryOn Non compatible Chaîne
defaultHttpRetryPolicy.retryRemoteLocalities Non compatible Chaîne
defaultServiceExportTo Stable Tableau de chaînes Champ d'application d'exportation par défaut pour les services (par défaut : *).
defaultVirtualServiceExportTo Stable Tableau de chaînes Champ d'exportation par défaut pour les VirtualServices (* par défaut).
disableEnvoyListenerLog Non compatible Chaîne
dnsRefreshRate Non compatible Chaîne
enableAutoMtls Non compatible Booléen
enableEnvoyAccessLogService Non compatible Chaîne
enablePrometheusMerge Non compatible Chaîne
enableTracing Non compatible Chaîne
h2UpgradePolicy Non compatible Chaîne (DO_NOT_UPGRADE, UPGRADE)
inboundClusterStatName Non compatible Chaîne
inboundTrafficPolicy.mode Non compatible Chaîne (PASSTHROUGH, LOCALHOST)
ingressClass Non compatible Chaîne
ingressControllerMode Non compatible Chaîne (UNSPECIFIED, OFF, DEFAULT, STRICT)
ingressSelector Non compatible Mappage clé-valeur
ingressService Non compatible Chaîne
outboundClusterStatName Non compatible Chaîne
pathNormalization.normalization Non compatible Chaîne
pathNormalization.normalizationType Non compatible Chaîne (DEFAULT, NONE, BASE, MERGE_SLASHES, DECODE_AND_MERGE_SLASHES)
protocolDetectionTimeout Non compatible Durée
proxyHttpPort Non compatible Integer
proxyInboundListenPort Non compatible Integer
proxyListenPort Non compatible Integer
rootNamespace Non compatible Chaîne
trustDomain Non compatible Chaîne
trustDomainAliases Non compatible Tableau de chaînes
verifyCertificateAtClient Non compatible Chaîne

Paramètres d'autorité de certification et de certificat (ca, caCertificates, certificates)

Le tableau suivant liste la compatibilité au niveau des champs pour ca, caCertificates et certificates.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
ca.address Non compatible Chaîne
ca.istiodSide Non compatible Booléen
ca.requestTimeout Non compatible Durée
ca.tlsSettings.caCertificates Non compatible Chaîne
ca.tlsSettings.clientCertificate Non compatible Chaîne
ca.tlsSettings.clientCertificates Non compatible Chaîne
ca.tlsSettings.credentialName Non compatible Chaîne
ca.tlsSettings.insecureSkipVerify Non compatible Booléen
ca.tlsSettings.mode Non compatible Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL)
ca.tlsSettings.privateKey Non compatible Chaîne
ca.tlsSettings.sni Non compatible Chaîne
ca.tlsSettings.subjectAltNames Non compatible Tableau de chaînes
caCertificates.certSigners Non compatible Chaîne
caCertificates.pem Non compatible Chaîne
caCertificates.spiffeBundleUrl Non compatible Chaîne
caCertificates.trustDomains Non compatible Chaîne
certificates.dnsNames Non compatible Tableau de chaînes
certificates.secretName Non compatible Chaîne

Sources de configuration (configSources)

Le tableau suivant liste la compatibilité au niveau des champs pour configSources.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
address Non compatible Chaîne
subscribedResources Non compatible Tableau de chaînes (SERVICE_REGISTRY)
tlsSettings.caCertificates Non compatible Chaîne
tlsSettings.clientCertificate Non compatible Chaîne
tlsSettings.credentialName Non compatible Chaîne
tlsSettings.insecureSkipVerify Non compatible Booléen
tlsSettings.mode Non compatible Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL)
tlsSettings.privateKey Non compatible Chaîne
tlsSettings.sni Non compatible Chaîne
tlsSettings.subjectAltNames Non compatible Tableau de chaînes

Fournisseurs par défaut (defaultProviders)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultProviders.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
accessLogging Stable Tableau de chaînes (envoy)
metrics Non compatible Tableau de chaînes
tracing Stable Tableau de chaînes (stackdriver)

Sélecteurs de découverte (discoverySelectors)

Le tableau suivant liste la compatibilité au niveau des champs pour discoverySelectors.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
matchExpressions.key Stable Chaîne
matchExpressions.operator Stable Chaîne
matchExpressions.values Stable Tableau de chaînes
matchLabels Stable Mappage clé-valeur

Autorisation externe HTTP (extensionProviders.envoyExtAuthzHttp)

Le tableau suivant liste la compatibilité au niveau des champs pour extensionProviders.envoyExtAuthzHttp.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
failOpen Stable Booléen
headersToDownstreamOnAllow Stable Chaîne Le caractère générique * seul n'est pas accepté.
headersToDownstreamOnDeny Stable Chaîne Le caractère générique * seul n'est pas accepté.
headersToUpstreamOnAllow Stable Chaîne Le caractère générique * seul n'est pas accepté.
includeAdditionalHeadersInCheck Non compatible Mappage clé-valeur
includeHeadersInCheck Non compatible Chaîne
includeRequestBodyInCheck.allowPartialMessage Non compatible Booléen
includeRequestBodyInCheck.maxRequestBytes Non compatible Integer
includeRequestBodyInCheck.packAsBytes Non compatible Booléen
includeRequestHeadersInCheck Stable Chaîne Le caractère générique * seul n'est pas accepté.
pathPrefix Stable Chaîne Doit commencer par / (par exemple, /check).
port Stable Integer Numéro de port obligatoire (1-65535).
service Stable Chaîne Obligatoire. Doit être un nom de domaine complet valide ou <namespace>/<hostname>.
statusOnError Stable Chaîne S'il est configuré, il doit s'agir d'un code d'état Envoy valide.
timeout Stable Durée

gRPC d'autorisation externe (extensionProviders.envoyExtAuthzGrpc)

Le tableau suivant liste la compatibilité au niveau des champs pour extensionProviders.envoyExtAuthzGrpc.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
failOpen Stable Booléen
includeRequestBodyInCheck.allowPartialMessage Stable Booléen
includeRequestBodyInCheck.maxRequestBytes Stable Integer
includeRequestBodyInCheck.packAsBytes Stable Booléen
port Stable Integer Numéro de port obligatoire (1-65535).
service Stable Chaîne Obligatoire. Doit être un nom de domaine complet valide ou <namespace>/<hostname>.
statusOnError Stable Chaîne S'il est configuré, il doit s'agir d'un code d'état Envoy valide.
timeout Stable Durée

OpenTelemetry (extensionProviders.opentelemetry)

Le tableau suivant liste la compatibilité au niveau des champs pour extensionProviders.opentelemetry.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
dynatraceSampler.clusterId Non compatible Integer
dynatraceSampler.httpService.http.headers.name Non compatible Chaîne
dynatraceSampler.httpService.http.headers.value Non compatible Chaîne
dynatraceSampler.httpService.http.path Non compatible Chaîne
dynatraceSampler.httpService.http.timeout Non compatible Durée
dynatraceSampler.httpService.port Non compatible Integer
dynatraceSampler.httpService.service Non compatible Chaîne
dynatraceSampler.rootSpansPerMinute Non compatible Integer
dynatraceSampler.tenant Non compatible Chaîne
http.headers.name Non compatible Chaîne
http.headers.value Non compatible Chaîne
http.path Non compatible Chaîne
http.timeout Non compatible Durée
maxTagLength Non compatible Chaîne
port Non compatible Integer
resourceDetectors.dynatrace Non compatible Chaîne
resourceDetectors.environment Non compatible Chaîne
service Non compatible Chaîne

Zipkin et Lightstep (extensionProviders.zipkin, lightstep)

Le tableau suivant liste la compatibilité au niveau des champs pour extensionProviders.zipkin et lightstep.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
lightstep.accessToken Non compatible Chaîne
lightstep.maxTagLength Non compatible Chaîne
lightstep.port Non compatible Integer
lightstep.service Non compatible Chaîne
zipkin.enable64bitTraceId Non compatible Booléen
zipkin.maxTagLength Non compatible Chaîne
zipkin.port Non compatible Integer
zipkin.service Non compatible Chaîne

Datadog, Stackdriver, SkyWalking et OpenCensus (extensionProviders.datadog, stackdriver, skywalking, opencensus)

Le tableau suivant liste la compatibilité au niveau des champs pour extensionProviders.datadog, stackdriver, skywalking et opencensus.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
datadog.maxTagLength Non compatible Chaîne
datadog.port Non compatible Integer
datadog.service Non compatible Chaîne
opencensus.context Non compatible Tableau de chaînes (UNSPECIFIED, W3C_TRACE_CONTEXT, GRPC_BIN, CLOUD_TRACE_CONTEXT, B3)
opencensus.maxTagLength Non compatible Chaîne
opencensus.port Non compatible Integer
opencensus.service Non compatible Chaîne
skywalking.accessToken Non compatible Chaîne
skywalking.port Non compatible Integer
skywalking.service Non compatible Chaîne
stackdriver.debug Non compatible Chaîne
stackdriver.logging Non compatible Booléen
stackdriver.logging.labels Non compatible Mappage clé-valeur
stackdriver.maxNumberOfAnnotations Non compatible Mappage clé-valeur
stackdriver.maxNumberOfAttributes Non compatible Chaîne
stackdriver.maxNumberOfMessageEvents Non compatible Chaîne
stackdriver.maxTagLength Non compatible Chaîne

Paramètres de journalisation des accès (extensionProviders.envoyFileAccessLog, envoyHttpAls, envoyTcpAls, envoyOtelAls, prometheus)

Le tableau suivant liste la compatibilité au niveau des champs pour extensionProviders.envoyFileAccessLog, envoyHttpAls, envoyTcpAls, envoyOtelAls et prometheus.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
envoyFileAccessLog.logFormat.labels Non compatible Mappage clé-valeur
envoyFileAccessLog.logFormat.text Non compatible Chaîne
envoyFileAccessLog.path Non compatible Chaîne
envoyHttpAls.additionalRequestHeadersToLog Non compatible Chaîne
envoyHttpAls.additionalResponseHeadersToLog Non compatible Chaîne
envoyHttpAls.additionalResponseTrailersToLog Non compatible Chaîne
envoyHttpAls.filterStateObjectsToLog Non compatible Chaîne
envoyHttpAls.logName Non compatible Chaîne
envoyHttpAls.port Non compatible Integer
envoyHttpAls.service Non compatible Chaîne
envoyOtelAls.logFormat.labels Non compatible Mappage clé-valeur
envoyOtelAls.logFormat.text Non compatible Chaîne
envoyOtelAls.logName Non compatible Chaîne
envoyOtelAls.port Non compatible Integer
envoyOtelAls.service Non compatible Chaîne
envoyTcpAls.filterStateObjectsToLog Non compatible Chaîne
envoyTcpAls.logName Non compatible Chaîne
envoyTcpAls.port Non compatible Integer
envoyTcpAls.service Non compatible Chaîne
prometheus Non compatible Objet

Nom du fournisseur (extensionProviders.name)

Le tableau suivant liste la compatibilité au niveau des champs pour extensionProviders.name.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
name Stable Chaîne Obligatoire. Doit être unique pour tous les fournisseurs d'extensions.

Équilibrage de charge de la localité (localityLbSetting)

Le tableau suivant liste la compatibilité au niveau des champs pour localityLbSetting.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
distribute.from Non compatible Chaîne
distribute.to Non compatible Mappage clé-valeur
enabled Stable Booléen
failover.from Stable Chaîne Nécessite la configuration de outlierDetection sur la règle de trafic et n'est autorisé que syntaxiquement pour déclencher WATERFALL_BY_ZONE. Les chemins de routage spécifiques sont ignorés.
failover.to Stable Chaîne Nécessite la configuration de outlierDetection sur la règle de trafic et n'est autorisé que syntaxiquement pour déclencher WATERFALL_BY_ZONE. Les chemins de routage spécifiques sont ignorés.
failoverPriority Non compatible Tableau de chaînes

Paramètres par défaut du maillage et de TLS (meshMTLS, tlsDefaults)

Le tableau suivant liste la compatibilité au niveau des champs pour meshMTLS et tlsDefaults.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
meshMTLS.cipherSuites Non compatible Tableau de chaînes
meshMTLS.ecdhCurves Non compatible Tableau de chaînes
meshMTLS.minProtocolVersion Non compatible Chaîne (TLS_AUTO, TLSV1_2, TLSV1_3)
tlsDefaults.cipherSuites Non compatible Tableau de chaînes
tlsDefaults.ecdhCurves Non compatible Tableau de chaînes
tlsDefaults.minProtocolVersion Non compatible Chaîne (TLS_AUTO, TLSV1_2, TLSV1_3)

Réseaux maillés (réseaux)

Le tableau suivant liste la compatibilité au niveau des champs pour networks.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
endpoints.fromCidr Stable Chaîne
endpoints.fromRegistry Stable Chaîne
gateways.address Stable Chaîne
gateways.locality Stable Chaîne
gateways.port Stable Integer
gateways.registryServiceName Stable Chaîne

Règle de trafic sortant et paramètres de service (outboundTrafficPolicy, serviceSettings)

Le tableau suivant liste la compatibilité au niveau des champs pour outboundTrafficPolicy et serviceSettings.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
outboundTrafficPolicy.mode Stable Chaîne (REGISTRY_ONLY, ALLOW_ANY) Configure la gestion du trafic sortant à l'échelle du maillage pour les destinations inconnues.
serviceSettings.hosts Stable Tableau de chaînes
serviceSettings.settings.clusterLocal Stable Booléen

TCP Keepalive (tcpKeepalive)

Le tableau suivant liste la compatibilité au niveau des champs pour tcpKeepalive.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
interval Non compatible Durée
probes Non compatible Integer
time Non compatible Durée

Paramètres généraux du proxy (defaultConfig)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultConfig.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
availabilityZone Non compatible Chaîne
binaryPath Non compatible Chaîne
caCertificatesPem Non compatible Tableau de chaînes
concurrency Stable Integer
configPath Non compatible Chaîne
controlPlaneAuthPolicy Non compatible Chaîne (NONE, MUTUAL_TLS, INHERIT)
customConfigFile Non compatible Chaîne
discoveryAddress Non compatible Chaîne
discoveryRefreshDelay Non compatible Chaîne
drainDuration Stable Durée La précision doit être exprimée en secondes. Maximum : 1 heure (3 600 s).
envoyMetricsServiceAddress Non compatible Chaîne
extraStatTags Non compatible Tableau de chaînes
holdApplicationUntilProxyStarts Stable Booléen Retarde le démarrage du pod d'application jusqu'à ce que le proxy Envoy soit prêt.
interceptionMode Stable Chaîne (REDIRECT, TPROXY, NONE) Mode d'interception du trafic pour les side-cars de proxy.
meshId Non compatible Chaîne
proxyAdminPort Non compatible Integer
proxyBootstrapTemplatePath Non compatible Chaîne
proxyMetadata Stable Mappage clé-valeur Paires clé/valeur de métadonnées compatibles pour la configuration du proxy.
serviceCluster Non compatible Chaîne
statNameLength Non compatible Integer
statsdUdpAddress Non compatible Chaîne
statusPort Non compatible Integer
terminationDrainDuration Stable Durée Délai de grâce maximal pour le drainage de connexion lors de l'arrêt du proxy.
tracingServiceName Non compatible Chaîne (APP_LABEL_AND_NAMESPACE, CANONICAL_NAME_ONLY, CANONICAL_NAME_AND_NAMESPACE)
zipkinAddress Non compatible Chaîne

Paramètres de traçage (defaultConfig.tracing)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultConfig.tracing.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
customTags Non compatible Mappage clé-valeur
datadog.address Non compatible Chaîne
lightstep.accessToken Non compatible Chaîne
lightstep.address Non compatible Chaîne
maxPathTagLength Non compatible Integer
openCensusAgent.address Non compatible Chaîne
openCensusAgent.context Non compatible Tableau de chaînes (UNSPECIFIED, W3C_TRACE_CONTEXT, GRPC_BIN, CLOUD_TRACE_CONTEXT, B3)
sampling Non compatible Chaîne
stackdriver.debug Non compatible Chaîne
stackdriver.maxNumberOfAnnotations Non compatible Mappage clé-valeur
stackdriver.maxNumberOfAttributes Non compatible Chaîne
stackdriver.maxNumberOfMessageEvents Non compatible Chaîne
tlsSettings.caCertificates Non compatible Chaîne
tlsSettings.clientCertificate Non compatible Chaîne
tlsSettings.credentialName Non compatible Chaîne
tlsSettings.insecureSkipVerify Non compatible Booléen
tlsSettings.mode Non compatible Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL)
tlsSettings.privateKey Non compatible Chaîne
tlsSettings.sni Non compatible Chaîne
tlsSettings.subjectAltNames Non compatible Tableau de chaînes
zipkin.address Non compatible Chaîne

Service de métriques et de journal d'accès Envoy (defaultConfig.envoyAccessLogService, envoyMetricsService)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultConfig.envoyAccessLogService et envoyMetricsService.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
envoyAccessLogService.address Non compatible Chaîne
envoyAccessLogService.tcpKeepalive.interval Non compatible Durée
envoyAccessLogService.tcpKeepalive.probes Non compatible Integer
envoyAccessLogService.tcpKeepalive.time Non compatible Durée
envoyAccessLogService.tlsSettings.caCertificates Non compatible Chaîne
envoyAccessLogService.tlsSettings.clientCertificate Non compatible Chaîne
envoyAccessLogService.tlsSettings.credentialName Non compatible Chaîne
envoyAccessLogService.tlsSettings.insecureSkipVerify Non compatible Booléen
envoyAccessLogService.tlsSettings.mode Non compatible Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL)
envoyAccessLogService.tlsSettings.privateKey Non compatible Chaîne
envoyAccessLogService.tlsSettings.sni Non compatible Chaîne
envoyAccessLogService.tlsSettings.subjectAltNames Non compatible Tableau de chaînes
envoyMetricsService.address Non compatible Chaîne
envoyMetricsService.tcpKeepalive.interval Non compatible Durée
envoyMetricsService.tcpKeepalive.probes Non compatible Integer
envoyMetricsService.tcpKeepalive.time Non compatible Durée
envoyMetricsService.tlsSettings.caCertificates Non compatible Chaîne
envoyMetricsService.tlsSettings.clientCertificate Non compatible Chaîne
envoyMetricsService.tlsSettings.credentialName Non compatible Chaîne
envoyMetricsService.tlsSettings.insecureSkipVerify Non compatible Booléen
envoyMetricsService.tlsSettings.mode Non compatible Chaîne (DISABLE, SIMPLE, MUTUAL, ISTIO_MUTUAL)
envoyMetricsService.tlsSettings.privateKey Non compatible Chaîne
envoyMetricsService.tlsSettings.sni Non compatible Chaîne
envoyMetricsService.tlsSettings.subjectAltNames Non compatible Tableau de chaînes

Paramètres de la vérification d'aptitude (defaultConfig.readinessProbe)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultConfig.readinessProbe.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
exec.command Non compatible Chaîne
failureThreshold Non compatible Integer
httpGet.host Non compatible Chaîne
httpGet.httpHeaders.name Non compatible Chaîne
httpGet.httpHeaders.value Non compatible Chaîne
httpGet.path Non compatible Chaîne
httpGet.port Non compatible Integer
httpGet.scheme Non compatible Chaîne
initialDelaySeconds Non compatible Integer
periodSeconds Non compatible Integer
successThreshold Non compatible Integer
tcpSocket.host Non compatible Chaîne
tcpSocket.port Non compatible Integer
timeoutSeconds Non compatible Integer

En-têtes de proxy et topologie (defaultConfig.proxyHeaders, gatewayTopology)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultConfig.proxyHeaders et gatewayTopology.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
gatewayTopology.forwardClientCertDetails Stable Chaîne (UNDEFINED, SANITIZE, FORWARD_ONLY, APPEND_FORWARD, SANITIZE_SET, ALWAYS_FORWARD_ONLY)
gatewayTopology.numTrustedProxies Stable Integer
gatewayTopology.proxyProtocol Non compatible Objet
proxyHeaders.attemptCount.disabled Non compatible Booléen
proxyHeaders.envoyDebugHeaders.disabled Non compatible Booléen
proxyHeaders.forwardedClientCert Non compatible Chaîne (UNDEFINED, SANITIZE, FORWARD_ONLY, APPEND_FORWARD, SANITIZE_SET, ALWAYS_FORWARD_ONLY)
proxyHeaders.metadataExchangeHeaders.mode Non compatible Chaîne (UNDEFINED, IN_MESH)
proxyHeaders.requestId.disabled Non compatible Booléen
proxyHeaders.server.disabled Non compatible Booléen
proxyHeaders.server.value Non compatible Chaîne

Métadonnées du proxy et valeurs d'exécution (defaultConfig.proxyMetadata, runtimeValues)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultConfig.proxyMetadata et runtimeValues.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
CA_PROVIDER Stable Chaîne
CA_ROOT_CA Non compatible Chaîne
ENABLE_NATIVE_SIDECARS Non compatible Chaîne
EXIT_ON_ZERO_ACTIVE_CONNECTIONS Stable Chaîne
GCE_METADATA_HOST Non compatible Chaîne
GCP_METADATA Stable Chaîne
GKE_CLUSTER_URL Stable Chaîne
GODEBUG Stable Chaîne
GRPC_VERBOSITY Stable Chaîne
HTTPS_PROXY Non compatible Chaîne
HTTP_PROXY Non compatible Chaîne
ISTIO_LOG_LEVEL Non compatible Chaîne
ISTIO_META_CLOUDRUN_ADDR Stable Chaîne
ISTIO_META_DNS_AUTO_ALLOCATE Non compatible Chaîne
ISTIO_META_DNS_CAPTURE Non compatible Chaîne
ISTIO_META_ENABLE_GSM_TD_LRS Stable Chaîne
ISTIO_META_ENABLE_MCP_LRS Stable Chaîne
ISTIO_META_GSM_TD_XDS_CAPABILITIES Stable Chaîne
ISTIO_META_HTTP10 Non compatible Chaîne
ISTIO_META_PROXY_XDS_VIA_AGENT Non compatible Chaîne
ISTIO_META_ENABLE_NATIVE_SIDECARS Non compatible Chaîne
MINIMUM_DRAIN_DURATION Stable Chaîne
OUTPUT_CERTS Non compatible Chaîne
PILOT_ENABLE_CONFIG_DISTRIBUTION_TRACKING Non compatible Chaîne
PILOT_ENABLE_K8S_SELECT_WORKLOAD_ENTRIES Non compatible Chaîne
PILOT_JWT_ENABLE_REMOTE_JWKS Non compatible Chaîne
PLUGINS Non compatible Chaîne
PROXY_CONFIG_XDS_AGENT Non compatible Chaîne
SECRET_GRACE_PERIOD_RATIO Stable Chaîne
SECRET_TTL Stable Chaîne
TERMINATION_DRAIN_DURATION_SECONDS Stable Chaîne
TRUST_DOMAIN Non compatible Chaîne
USE_TOKEN_FOR_CSR Stable Chaîne
XDS_AUTH_PROVIDER Non compatible Chaîne
XDS_HEADER_Cloud-Run-Enable-H2 Non compatible Chaîne
XDS_ROOT_CA Non compatible Chaîne
runtimeValues Stable Mappage clé-valeur

Paramètres de sécurité et autres (defaultConfig.sds, privateKeyProvider, proxyStatsMatcher, image)

Le tableau suivant liste la compatibilité au niveau des champs pour defaultConfig.sds, privateKeyProvider, proxyStatsMatcher et image.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
image.imageType Stable Chaîne (distroless) Seule l'option distroless est acceptée.
privateKeyProvider.cryptomb.pollDelay Non compatible Durée
privateKeyProvider.qat.pollDelay Non compatible Durée
proxyStatsMatcher.inclusionPrefixes Stable Tableau de chaînes
proxyStatsMatcher.inclusionRegexps Stable Tableau de chaînes
proxyStatsMatcher.inclusionSuffixes Stable Tableau de chaînes
sds.enabled Non compatible Booléen
sds.k8sSaJwtPath Non compatible Chaîne

GCPBackend (networking.gke.io/v1)

Les sections suivantes décrivent les champs compatibles avec les ressources GCPBackend.

Champs de caractéristiques

Le tableau suivant liste les champs de spécification compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
spec.hostname Stable Chaîne (nom d'hôte RFC 1123)
spec.port Stable Integer
spec.type Stable Chaîne (CloudRun, BackendService ou non définie pour spec.serviceUris)
spec.cloudrun.service Stable Chaîne
spec.cloudrun.regions Stable Tableau de chaînes (région)
spec.cloudrun.project Stable Chaîne Doit correspondre à l'ID du projet du cluster. Les backends Cloud Run multiprojets ne sont pas acceptés.
spec.backendservice.name Stable Chaîne
spec.backendservice.location Stable Chaîne (global) doit être global Les services de backend régionaux ne sont pas acceptés.
spec.backendservice.project Stable Chaîne (ID du projet) Doit correspondre à l'ID du projet du cluster. Les services de backend multiprojets ne sont pas acceptés.
spec.serviceUris Stable Tableau de chaînes (URI) Tous les URI doivent être du même type et régionaux. Un seul URI par région est autorisé.

GCPBackendPolicy (networking.gke.io/v1)

Les sections suivantes décrivent les champs compatibles avec les ressources GCPBackendPolicy.

Champs de la règle racine et de la règle par défaut

Le tableau suivant liste les champs de règle racine et par défaut compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
targetRef Stable Objet (group, kind, name, namespace) Doit cibler un Service. Les références entre espaces de noms ne sont pas acceptées.
default.maxRatePerEndpoint Stable Integer
default.backendPreference Stable Chaîne (DEFAULT, PREFERRED)
default.logging Non compatible Objet
default.sessionAffinity Non compatible Objet
default.connectionDraining Non compatible Objet
default.timeoutSec Non compatible Integer
default.securityPolicy Non compatible Chaîne
default.iap Non compatible Objet
default.balancingMode Non compatible Chaîne
default.capacityScalerPercent Non compatible Integer
default.customMetrics Non compatible Tableau d'objets
default.scopes Non compatible Tableau d'objets
default.trafficDuration Non compatible Chaîne
default.maxInFlightRequestsPerEndpoint Non compatible Integer

GCPTrafficDistributionPolicy (networking.gke.io/v1)

Les sections suivantes décrivent les champs compatibles avec les ressources GCPTrafficDistributionPolicy.

Champs de la règle racine et de la règle par défaut

Le tableau suivant liste les champs de règle racine et par défaut compatibles.

Champ Canal d'assistance le plus élevé Types de données acceptés (valeurs) Limites
targetRefs Stable Tableau d'objets (group, kind, name) Doit faire référence à des ressources Service.
default.serviceLbAlgorithm Stable Chaîne (SPRAY_TO_REGION, WATERFALL_BY_ZONE, WATERFALL_BY_REGION) La valeur par défaut est WATERFALL_BY_REGION si elle est omise.
default.autoCapacityDrain.enableAutoCapacityDrain Stable Booléen
default.failoverConfig.failoverHealthThreshold Stable Integer
default.localityLbAlgorithm Non compatible Chaîne
default.minimumHashRingSize Non compatible Integer
default.customMetrics Non compatible Tableau d'objets
default.sessionAffinity Non compatible Objet
default.subsetting Non compatible Chaîne
default.sharding Non compatible Objet

Annotations

Le tableau suivant liste les annotations compatibles.

Annotation Canal d'assistance le plus élevé Ressource Description Limites
alpha.istio.io/canonical-serviceaccounts Non compatible Service Spécifie les comptes de service non-Kubernetes autorisés à exécuter ce service. Obsolète.
alpha.istio.io/identity Non compatible Pod Identité de la charge de travail. Obsolète.
alpha.istio.io/kubernetes-serviceaccounts Non compatible Service Spécifie les comptes de service Kubernetes autorisés à exécuter ce service sur les VM. Obsolète.
galley.istio.io/analyze-suppress Non compatible Tous Liste de codes de message d'analyse de configuration séparés par une virgule à supprimer lors de l'exécution des analyseurs Istio (par exemple, galley.istio.io/analyze-suppress=IST0108,IST0103 ou * pour tous).
gateway.istio.io/controller-version Non compatible Tous Version ajoutée à la passerelle par le contrôleur, spécifiant la version du contrôleur.
inject.istio.io/templates Stable Pod Noms des modèles d'injection à utiliser, sous la forme d'une liste d'éléments séparés par une virgule. Consultez Modèles personnalisés.
install.operator.istio.io/chart-owner Stable Tous Représente le nom du graphique utilisé pour créer cette ressource.
install.operator.istio.io/owner-generation Stable Tous Représente la génération avec laquelle la ressource a été rapprochée pour la dernière fois.
install.operator.istio.io/version Stable Tous Représente la version d'Istio associée à la ressource.
istio.io/autoRegistrationGroup Non compatible WorkloadEntry Sur un WorkloadEntry, stocke le WorkloadGroup associé.
istio.io/connectedAt Non compatible WorkloadEntry Sur un WorkloadEntry, stocke l'heure en nanosecondes à laquelle la charge de travail associée s'est connectée à une instance Pilot.
istio.io/disconnectedAt Non compatible WorkloadEntry Sur un WorkloadEntry, stocke l'heure en nanosecondes à laquelle la charge de travail associée s'est déconnectée d'une instance Pilot.
istio.io/dry-run Stable AuthorizationPolicy Indique si la ressource donnée est en mode dry run. Consultez la section Mode dry run.
istio.io/rev Stable Pod Spécifie une révision du plan de contrôle à laquelle un proxy donné est connecté. Ajouté automatiquement par le plan de contrôle ; non défini par un utilisateur. Représente la révision réelle, et non la révision demandée.
istio.io/workloadController Non compatible WorkloadEntry Sur une WorkloadEntry, stocke l'instance pilote actuelle ou la dernière instance pilote connectée à la charge de travail pour XDS.
kubernetes.io/ingress.class Stable Entrée Annotation sur une ressource Ingress indiquant la classe de contrôleurs qui en est responsable.
networking.istio.io/exportTo Non compatible Service Spécifie les espaces de noms vers lesquels ce service doit être exporté. La valeur * indique qu'il est accessible dans le maillage, tandis que . indique qu'il est accessible dans son espace de noms.
prometheus.istio.io/merge-metrics Non compatible Pod Indique si les métriques Prometheus de l'application sont fusionnées avec les métriques Envoy pour cette charge de travail.
proxy.istio.io/config Stable Pod Remplacements de la configuration du proxy pour ce proxy spécifique. Les options disponibles sont disponibles dans la documentation de référence sur ProxyConfig.
proxy.istio.io/overrides Stable Pod Utilisé en interne pour indiquer les remplacements spécifiés par l'utilisateur dans le conteneur proxy du pod lors de l'injection.
readiness.status.sidecar.istio.io/applicationPorts Non compatible Pod Spécifie la liste des ports exposés par le conteneur d'application. Utilisé par la vérification d'aptitude du side-car Envoy pour déterminer qu'Envoy est configuré et prêt à recevoir du trafic.
readiness.status.sidecar.istio.io/failureThreshold Non compatible Pod Spécifie le seuil d'échec de la vérification d'aptitude du side-car Envoy.
readiness.status.sidecar.istio.io/initialDelaySeconds Non compatible Pod Spécifie le délai initial (en secondes) de la vérification d'aptitude du side-car Envoy.
readiness.status.sidecar.istio.io/periodSeconds Non compatible Pod Spécifie la période (en secondes) de la vérification d'aptitude du side-car Envoy.
sidecar.istio.io/agentLogLevel Stable Pod Spécifie le niveau de sortie du journal pour pilot-agent.
sidecar.istio.io/bootstrapOverride Non compatible Pod Spécifie un autre fichier de configuration d'amorçage Envoy.
sidecar.istio.io/componentLogLevel Non compatible Pod Spécifie le niveau de journalisation des composants pour Envoy.
sidecar.istio.io/controlPlaneAuthPolicy Non compatible Pod Spécifie la règle d'authentification utilisée par le plan de contrôle Istio. Si la valeur est NONE, le trafic ne sera pas chiffré. Si la valeur est MUTUAL_TLS, le trafic entre les side-cars Envoy est encapsulé dans des connexions TLS mutuelles. Obsolète.
sidecar.istio.io/discoveryAddress Non compatible Pod Spécifie l'adresse XDS à utiliser pour cette charge de travail spécifique. Obsolète.
sidecar.istio.io/enableCoreDump Stable Pod Indique si un side-car Envoy doit activer le vidage de mémoire.
sidecar.istio.io/extraStatTags Non compatible Pod Liste supplémentaire de tags à extraire de la télémétrie Istio Wasm dans le proxy. Obsolète.
sidecar.istio.io/inject Stable Pod Indique si un side-car Envoy doit être automatiquement injecté dans la charge de travail. Obsolète. Remplacé par l'étiquette sidecar.istio.io/inject.
sidecar.istio.io/interceptionMode Stable Pod Spécifie le mode utilisé pour rediriger les connexions entrantes vers Envoy (REDIRECT ou TPROXY).
sidecar.istio.io/logLevel Stable Pod Spécifie le niveau de journalisation pour Envoy.
sidecar.istio.io/proxyCPU Stable Pod Spécifie le paramètre de processeur demandé pour le side-car Envoy.
sidecar.istio.io/proxyCPULimit Stable Pod Spécifie la limite de processeur pour le side-car Envoy.
sidecar.istio.io/proxyImage Non compatible Pod Spécifie l'image Docker à utiliser par le side-car Envoy.
sidecar.istio.io/proxyImageType Stable Pod Spécifie le type d'image Docker à utiliser par le side-car Envoy. Seule l'option distroless est acceptée.
sidecar.istio.io/proxyMemory Stable Pod Spécifie le paramètre de mémoire demandé pour le side-car Envoy.
sidecar.istio.io/proxyMemoryLimit Stable Pod Spécifie la limite de mémoire pour le side-car Envoy.
sidecar.istio.io/rewriteAppHTTPProbers Non compatible Pod Réécrivez les vérifications d'aptitude et d'activité HTTP pour qu'elles soient redirigées vers le side-car Envoy.
sidecar.istio.io/statsHistogramBuckets Non compatible Pod Spécifie les buckets d'histogramme personnalisés avec un outil de mise en correspondance de préfixe pour séparer les métriques de maillage Istio des statistiques Envoy, telles que {"istiocustom":[1,5,10,50,100,500,1000,5000,10000],"cluster.xds-grpc":[1,5,10,25,50,100,250,500,1000,2500,5000,10000]}. Les buckets par défaut sont [0.5,1,5,10,25,50,100,250,500,1000,2500,5000,10000,30000,60000,300000,600000,1800000,3600000].
sidecar.istio.io/statsInclusionPrefixes Non compatible Pod Spécifie la liste des préfixes des statistiques à émettre par Envoy, séparés par une virgule. Obsolète.
sidecar.istio.io/statsInclusionRegexps Non compatible Pod Spécifie la liste d'expressions régulières séparées par une virgule auxquelles les statistiques doivent correspondre pour être émises par Envoy. Obsolète.
sidecar.istio.io/statsInclusionSuffixes Non compatible Pod Spécifie la liste des suffixes des statistiques à émettre par Envoy, séparés par une virgule. Obsolète.
sidecar.istio.io/status Stable Pod Généré par l'injection side-car Envoy qui indique l'état de l'opération. Inclut un hachage de version du modèle exécuté et les noms des ressources injectées.
sidecar.istio.io/userVolume Non compatible Pod Spécifie un ou plusieurs volumes utilisateur (sous forme de tableau JSON) à ajouter au side-car Envoy.
sidecar.istio.io/userVolumeMount Non compatible Pod Spécifie un ou plusieurs montages de volume utilisateur (sous forme de tableau JSON) à ajouter au side-car Envoy.
status.sidecar.istio.io/port Stable Pod Spécifie le port d'état HTTP pour le side-car Envoy. Si la valeur est zéro, le side-car ne fournit pas d'état.
topology.istio.io/controlPlaneClusters Non compatible Espace de noms Liste de clusters séparés par une virgule (ou * pour n'importe quel cluster) exécutant istiod qui doivent tenter d'élire un leader pour un cluster distant dont l'espace de noms système inclut cette annotation.
traffic.istio.io/nodeSelector Non compatible Service Ensemble d'étiquettes de nœud (key1=value,key2=value) utilisées pour la communication inter-réseaux.
traffic.sidecar.istio.io/excludeInboundPorts Stable Pod Liste de ports entrants séparés par une virgule à exclure de la redirection vers Envoy. Ne s'applique que lorsque tout le trafic entrant (c'est-à-dire *) est redirigé.
traffic.sidecar.istio.io/excludeInterfaces Stable Pod Liste d'interfaces séparées par une virgule à exclure de la capture du trafic Istio.
traffic.sidecar.istio.io/excludeOutboundIPRanges Stable Pod Liste de plages d'adresses IP séparées par une virgule au format CIDR à exclure de la redirection. S'applique uniquement lorsque tout le trafic sortant (c'est-à-dire *) est redirigé.
traffic.sidecar.istio.io/excludeOutboundPorts Stable Pod Liste de ports sortants séparés par une virgule à exclure de la redirection vers Envoy.
traffic.sidecar.istio.io/includeInboundPorts Stable Pod Liste de ports entrants séparés par une virgule pour lesquels le trafic doit être redirigé vers Envoy. Le caractère générique * peut être utilisé pour configurer la redirection pour tous les ports. Une liste vide désactive toutes les redirections entrantes.
traffic.sidecar.istio.io/includeOutboundIPRanges Stable Pod Liste de plages d'adresses IP au format CIDR à rediriger vers Envoy, séparées par une virgule (facultatif). Le caractère générique * peut être utilisé pour rediriger tout le trafic sortant. Une liste vide désactive toutes les redirections sortantes.
traffic.sidecar.istio.io/includeOutboundPorts Stable Pod Liste de ports sortants séparés par une virgule pour lesquels le trafic doit être redirigé vers Envoy, quelle que soit l'adresse IP de destination.
traffic.sidecar.istio.io/kubevirtInterfaces Non compatible Pod Liste d'interfaces virtuelles séparées par une virgule dont le trafic entrant (provenant de la VM) est traité comme sortant.