ASMMeshConfig CRD说明

字段路径

数据类型

描述

示例值

影响范围

.spec.connectTimeout

Duration

定义Envoy代理建立TCP连接的最大等待时间，超时触发upstream connect timeout错误。单位支持ns/ms/s/m/h。

30s

网格维度出站TCP连接。

.spec.protocolDetectionTimeout

Duration

自动协议检测的超时时间，用于识别HTTP/HTTPS流量。超时后按原始协议处理流量。

30s

网格维度协议嗅探。

字段路径

数据类型

描述

示例值

影响范围

.spec.tcpKeepalive.probes

Uint32

发送的TCP保活探测包最大次数。设置为0时禁用保活机制。

9

出站TCP长连接。

.spec.tcpKeepalive.time

Duration

TCP连接空闲等待时间，超时后开始发送保活探测包。

7200s

.spec.tcpKeepalive.interval

Duration

保活探测包发送间隔，需小于time参数。

75s

字段路径

数据类型

描述

示例值

影响范围

.spec.pathNormalization.normalization

Enum

URI路径处理策略：

• NONE：禁用标准化。

• BASE：合并斜杠并保留路径参数（如;）。

• MERGE_SLASHES：仅合并连续斜杠。

NONE

网格维度HTTP路由。

字段路径

数据类型

描述

示例值

影响范围

.spec.defaultHttpRetryPolicy.attempts

Int32

全局HTTP请求最大重试次数（含初始请求），仅当VirtualService未显式配置时生效。

2

HTTP路由策略。

.spec.defaultHttpRetryPolicy.perTryTimeout

Duration

单次重试的超时时间，需短于VirtualService中定义的总超时时间。

0s（无限制）

.spec.defaultHttpRetryPolicy.retryOn

String

触发重试的条件，支持标准错误类型： 5xx/gateway-error/connect-failure/reset等，多值以逗号分隔。

gateway-error, connect-failure, refused-stream

字段路径

数据类型

描述

示例值

影响范围

.spec.enablePrometheusMerge

Bool

自动合并Pod原有prometheus.io注解与ASM监控配置，避免指标重复采集。

true

Prometheus监控配置。

字段路径

数据类型

描述

示例值

影响范围

.spec.sidecarInjectorWebhookConfiguration.rewriteAppHTTPProbe

Bool

自动将Pod的HTTP就绪探针重定向到Sidecar代理端口。

true

Sidecar注入行为。

.spec.sidecarInjectorWebhookConfiguration.replicaCount

Int

Sidecar注入控制器的副本数，用于提升高可用性。

2

Sidecar注入器组件。

.spec.sidecarInjectorWebhookConfiguration.resources

Object

资源配额配置：

• requests：容器启动最小资源需求。

• limits：容器资源使用上限。

...
    resources:
      requests:
        cpu: 100m
        memory: 256Mi
      limits:
        cpu: '2'
        memory: 2Gi

Sidecar注入器组件。

字段路径

数据类型

描述

示例值

影响范围

.spec.rateLimitService.enabled

Bool

是否启用限流服务。

true

全局启用限流服务能力。

.spec.rateLimitService.replicas

Int

限流服务的副本数。

1

限流服务可用性与性能。

.spec.rateLimitService.resources

Object

限流服务的资源配置。

limits:
  cpu: 500m
  memory: 512Mi
requests:
  cpu: 100m
  memory: 128Mi

限流服务可用性与性能。

.spec.rateLimitService.redis

Object

限流服务查询的 Redis 配置。

    redis:
      authSecret: redis-secret
      url: redis.istio-system.svc:6379

限流状态存储后端。

.spec.rateLimitService.redis.type

String

redis 集群类型，可选值：single，cluster和sentinel。默认为single。

single

限流状态存储后端。

.spec.rateLimitService.redis.url

String

redis 地址。

redis.istio-system.svc.cluster.local:6379

限流状态存储后端。

.spec.rateLimitService.redis.auth

String

redis 认证信息，格式为：password或user:password。（为了安全起见，推荐您使用 AuthSecret 的形式）。

xxxxxx

凭据安全管理。

.spec.rateLimitService.redis.authSecret

String

存储redis认证信息的 secret 名称。

apiVersion: v1
data:
  redis-auth: ${base64编码后的认证信息}
kind: Secret
metadata:
  name: redis-secret
  namespace: istio-system
type: Opaque

凭据安全管理。

.spec.rateLimitService.redis.cacheKeyPrefix

String

Redis cache 的key前缀。默认为空。

N/A

限流状态存储后端。