升级问题
EnvoyFilter 迁移
EnvoyFilter
是一个与 Istio xDS 配置生成实现细节紧密耦合的 Alpha API。
在升级 Istio 的控制面或数据面时,必须谨慎使用 EnvoyFilter
Alpha API。
在许多情况下,您可以用低风险的标准 Istio API 替换 EnvoyFilter
。
使用 Telemetry API 自定义指标 {#use-telemetry-api-for-metrics- customization}
因为 IstioOperator
依赖于模板 EnvoyFilter
来更改指标过滤器配置,
所以使用 IstioOperator
自定义 Prometheus 指标生成的方式已经被
Telemetry API 所替换。
请注意,这两种方式互不兼容,Telemetry API 无法与 EnvoyFilter
或 IstioOperator
指标自定义配置一起使用。
例如,以下 IstioOperator
配置添加了一个 destination_port
标记:
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
values:
telemetry:
v2:
prometheus:
configOverride:
inboundSidecar:
metrics:
- name: requests_total
dimensions:
destination_port: string(destination.port)
以下 Telemetry
配置替换上述配置:
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
name: namespace-metrics
spec:
metrics:
- providers:
- name: prometheus
overrides:
- match:
metric: REQUEST_COUNT
mode: SERVER
tagOverrides:
destination_port:
value: "string(destination.port)"
使用 WasmPlugin API 扩展 Wasm 数据面
使用 EnvoyFilter
注入 Wasm 过滤器的做法已替换为
WasmPlugin API。
这是因为 WasmPlugin API 允许从镜像仓库、URL 或本地文件动态加载插件。
对于部署 Wasm 代码而言,“Null” 插件运行时不再是推荐的选项。
使用网关拓扑设置可信跳数
使用 EnvoyFilter
在 HTTP 连接管理器中配置可信跳数的方式已替换为
ProxyConfig
中的 gatewayTopology
字段。例如,以下 EnvoyFilter
配置应默认在 Pod 或网关上使用注解来替换:
apiVersion: networking.istio.io/v1alpha3
kind: EnvoyFilter
metadata:
name: ingressgateway-redirect-config
spec:
configPatches:
- applyTo: NETWORK_FILTER
match:
context: GATEWAY
listener:
filterChain:
filter:
name: envoy.filters.network.http_connection_manager
patch:
operation: MERGE
value:
typed_config:
'@type': type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
xff_num_trusted_hops: 1
workloadSelector:
labels:
istio: ingress-gateway
使用等效的入口网关代理配置注解:
metadata:
annotations:
"proxy.istio.io/config": '{"gatewayTopology" : { "numTrustedProxies": 1 }}'
使用代理注解自定义直方图桶大小
使用 EnvoyFilter
和实验性引导发现服务来配置直方图指标桶大小的方式已替换为代理注解
sidecar.istio.io/statsHistogramBuckets
。例如,以下 EnvoyFilter
配置应在 Pod 上使用注解来替换:
apiVersion: networking.istio.io/v1alpha3
kind: EnvoyFilter
metadata:
name: envoy-stats-1
namespace: istio-system
spec:
workloadSelector:
labels:
istio: ingressgateway
configPatches:
- applyTo: BOOTSTRAP
patch:
operation: MERGE
value:
stats_config:
histogram_bucket_settings:
- match:
prefix: istiocustom
buckets: [1,5,50,500,5000,10000]
使用等效的 Pod 注解:
metadata:
annotations:
"sidecar.istio.io/statsHistogramBuckets": '{"istiocustom":[1,5,50,500,5000,10000]}'