升级说明

升级到 Istio 1.7 时需要考虑的重要变化。

当您从 Istio 1.6.x 升级到 Istio 1.7.x 时,您需要考虑当前文档的变化说明。这些说明详细介绍了有意破坏与 Istio 1.6.x 的向后兼容性的更改。说明中还提到了在引入新行为的同时保留向后兼容性的变化。只有当新的行为对 Istio 1.6.x 的用户来说是意外的时候,才会包括更改。

要求 Kubernetes 1.16+ 版本{#require-Kubernetes-1.16+}

现在需要安装 Kubernetes 1.16+ 版本。

安装

以非 Root 身份运行的网关

现在,网关默认情况下是在没有 Root 权限下的情况下运行。因此,它们将不再能够绑定到 1024 以下的端口。默认情况下,我们将绑定到有效的端口。然而,如果您在网关上明确声明端口,您可能需要修改您的安装。例如,如果您以前有以下配置:

ingressGateways:
- name: istio-ingressgateway
  enabled: true
  k8s:
    service:
      ports:
        - port: 15021
          targetPort: 15021
          name: status-port
        - port: 80
          name: http2
        - port: 443
          name: https

应该修改为指定的有效的 targetPort,可以被绑定到。

ingressGateways:
- name: istio-ingressgateway
  enabled: true
  k8s:
    service:
      ports:
        - port: 15021
          targetPort: 15021
          name: status-port
        - port: 80
          name: http2
          targetPort: 8080
        - port: 443
          name: https
          targetPort: 8443

注意:targetPort 只修改了网关绑定的端口。客户端仍然会连接到由 port 定义的端口(一般是 80 和 443),所以这个变化应该是透明的。

如果您需要以 Root 身份运行,则可以使用 --set values.gateways.istio-ingressgateway.runAsRoot=true 启用此选项。

EnvoyFilter 语法更改{#EnvoyFilter-syntax-change}

使用传统的 config 语法的 EnvoyFilter 将需要迁移到新的 typed_config。这是由于 Envoy 的 API 中的基本变化

由于 EnvoyFilter 是一个没有向后兼容性保证的 Break Glass API,我们建议用户明确地将 EnvoyFilter 绑定到特定的版本,并在升级前对其进行适当测试。

例如,Istio 1.6 的配置,使用传统的 config 语法:

apiVersion: networking.istio.io/v1alpha3
kind: EnvoyFilter
metadata:
  name: lua-1.6
spec:
  configPatches:
    - applyTo: HTTP_FILTER
      match:
        context: ANY
        listener:
          filterChain:
            filter:
              name: envoy.http_connection_manager
        proxy:
          proxyVersion: ^1\.6.*
      patch:
        operation: INSERT_BEFORE
        value:
          name: envoy.lua
          config:
            inlineCode: |
              function envoy_on_request(handle)
                request_handle:headers():add("foo", "bar")
              end

当升级到 Istio 1.7 时,应该添加一个新的过滤器:

apiVersion: networking.istio.io/v1alpha3
kind: EnvoyFilter
metadata:
  name: lua-1.7
spec:
  configPatches:
    - applyTo: HTTP_FILTER
      match:
        context: ANY
        listener:
          filterChain:
            filter:
              name: envoy.http_connection_manager
        proxy:
          proxyVersion: ^1\.7.*
      patch:
        operation: INSERT_BEFORE
        value:
          name: envoy.filters.http.lua
          typed_config:
            '@type': type.googleapis.com/envoy.extensions.filters.http.lua.v3.Lua
            inlineCode: |
              function envoy_on_request(handle)
                request_handle:headers():add("foo", "bar")
              end