7.8 KiB
| title | description | weight | owner | test |
|---|---|---|---|---|
| Проблеми з оновленням | Вирішення поширених проблем з оновленнями Istio. | 60 | istio/wg-policies-and-telemetry-maintainers | n/a |
Міграція EnvoyFilter
EnvoyFilter — це альфа API, яка тісно повʼязана з деталями реалізації генерації конфігурації xDS в Istio. Використання альфа API EnvoyFilter в промислових системах має бути ретельно продуманим під час оновлення панелі управління або панелі даних Istio. У багатьох випадках EnvoyFilter можна замінити на API Istio, що несе значно менші ризики оновлення.
Використання Telemetry API для налаштування метрик
Використання IstioOperator для налаштування генерації метрик Prometheus було замінено на Telemetry API, оскільки IstioOperator спирається на шаблон EnvoyFilter для зміни конфігурації фільтра метрик. Зверніть увагу, що ці два методи несумісні, і Telemetry API не працює з EnvoyFilter або конфігурацією налаштування метрик IstioOperator.
Наприклад, наступна конфігурація IstioOperator додає теґ destination_port:
{{< text yaml >}} apiVersion: install.istio.io/v1alpha1 kind: IstioOperator spec: values: telemetry: v2: prometheus: configOverride: inboundSidecar: metrics: - name: requests_total dimensions: destination_port: string(destination.port) {{< /text >}}
Наступна конфігурація Telemetry замінює наведену вище:
{{< text yaml >}} apiVersion: telemetry.istio.io/v1 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)" {{< /text >}}
Використання WasmPlugin API для розширення можливостей Wasm панелі даних
Використання EnvoyFilter для додавання фільтрів Wasm було замінено на WasmPlugin API. WasmPlugin API дозволяє динамічне завантаження втулків з реєстрів артефактів, URL-адрес або локальних файлів. Виконавчий файл втулка "Null" більше не є рекомендованим варіантом для розгортання коду Wasm.
Використання топології шлюза для встановлення кількості довірених хопів
Використання EnvoyFilter для конфігурації кількості довірених хопів в HTTP-менеджері зʼєднань було замінено на поле gatewayTopology в ProxyConfig. Наприклад, наступна конфігурація EnvoyFilter повинна використовувати анотацію на podʼі або стандартне значення для мережі. Замість:
{{< text yaml >}} 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 {{< /text >}}
Використовуйте еквівалентну анотацію конфігурації проксі podʼа для шлюза:
{{< text yaml >}} metadata: annotations: "proxy.istio.io/config": '{"gatewayTopology" : { "numTrustedProxies": 1 }}' {{< /text >}}
Використання топології шлюза для увімкнення PROXY протоколу на шлюзах вхідного трафіку
Використання EnvoyFilter для увімкнення PROXY протоколу на шлюзах вхідного трафіку було замінено на поле gatewayTopology в ProxyConfig. Наприклад, наступна конфігурація EnvoyFilter повинна використовувати анотацію на podʼі або стандартне значення для мережі. Замість:
{{< text yaml >}} apiVersion: networking.istio.io/v1alpha3 kind: EnvoyFilter metadata: name: proxy-protocol spec: configPatches:
- applyTo: LISTENER_FILTER patch: operation: INSERT_FIRST value: name: proxy_protocol typed_config: "@type": "type.googleapis.com/envoy.extensions.filters.listener.proxy_protocol.v3.ProxyProtocol" workloadSelector: labels: istio: ingress-gateway {{< /text >}}
Використовуйте еквівалентну анотацію конфігурації проксі podʼа для шлюза:
{{< text yaml >}} metadata: annotations: "proxy.istio.io/config": '{"gatewayTopology" : { "proxyProtocol": {} }}' {{< /text >}}
Використання анотації проксі для налаштування розмірів кошиків гістограми
Використання EnvoyFilter та експериментального сервісу виявлення bootstrap для конфігурації розмірів кошиків для метрик гістограми було замінено на анотацію проксі sidecar.istio.io/statsHistogramBuckets. Наприклад, наступна конфігурація EnvoyFilter повинна використовувати анотацію на podʼі. Замість:
{{< text yaml >}} 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] {{< /text >}}
Використовуйте еквівалентну анотацію podʼа:
{{< text yaml >}} metadata: annotations: "sidecar.istio.io/statsHistogramBuckets": '{"istiocustom":[1,5,50,500,5000,10000]}' {{< /text >}}