ASMMeshConfig CRD说明

字段路径

数据类型

描述

示例值

tcpKeepalive

TcpKeepalive

日志投递的阿里云 SLS 日志 project 名称。

30s

connectTimeout

Duration

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

30s

protocolDetectionTimeout

Duration

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

pathNormalization

PathNormalization

路径标准化。

defaultHttpRetryPolicy

DefaultHttpRetryPolicy

Sidecar 默认 HTTP 重试策略。

enablePrometheusMerge

Bool

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

true

sidecarInjectorWebhookConfiguration

SidecarInjectorWebhookConfiguration

Sidecar 注入配置。

accessLogExtraConf

AccessLogExtraConf

访问日志格式与采集配置。

ratelimitService

RatelimitService

全局限流服务配置。

字段路径

数据类型

描述

示例值

影响范围

probes

Uint32

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

9

出站TCP长连接。

time

Duration

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

7200s

interval

Duration

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

75s

字段路径

数据类型

描述

示例值

影响范围

normalization

Enum

URI路径处理策略：

• NONE：禁用标准化。

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

• MERGE_SLASHES：仅合并连续斜杠。

NONE

网格维度HTTP路由。

字段路径

数据类型

描述

示例值

影响范围

attempts

Int32

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

2

HTTP路由策略。

perTryTimeout

Duration

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

0s（无限制）

retryOn

String

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

gateway-error, connect-failure, refused-stream

字段路径

数据类型

描述

示例值

影响范围

rewriteAppHTTPProbe

Bool

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

true

Sidecar注入行为。

replicaCount

Int

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

2

Sidecar注入器组件。

resources

Object

资源配额配置：

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

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

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

Sidecar注入器组件。

字段路径

数据类型

描述

示例值

logEncoding

String

日志输出格式。可选值为 JSON，TEXT。

JSON

logProject

String

日志投递的阿里云 SLS 日志 project 名称。

log-project-test

gatewayEnabled

Boolean

是否将网关的访问日志采集至阿里云 SLS。

true

sidecarEnabled

Boolean

是否将 Sidecar 的访问日志采集至阿里云 SLS。

true

ztunnelEnabled

Boolean

是否将 Ztunnel 的访问日志采集至阿里云 SLS。

true

gatewayLifecycle

Integer

网关访问日志的保留时间，默认为 90 天。

30

sidecarLifecycle

Integer

Sidecar 访问日志的保留时间，默认为 90 天。

30

ztunnelLifecycle

Integer

Ztunnel 访问日志的保留时间，默认为 90 天。

30

字段路径

数据类型

描述

示例值

影响范围

enabled

Bool

是否启用限流服务。

true

全局启用限流服务能力。

replicas

Int

限流服务的副本数。

1

限流服务可用性与性能。

resources

Object

限流服务的资源配置。

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

限流服务可用性与性能。

redis

Object

限流服务查询的 Redis 配置。

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

限流状态存储后端。

redis.type

String

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

single

限流状态存储后端。

redis.url

String

redis 地址。

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

限流状态存储后端。

redis.auth

String

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

xxxxxx

凭据安全管理。

redis.authSecret

String

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

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

凭据安全管理。

redis.cacheKeyPrefix

String

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

N/A

限流状态存储后端。