Upgrade Notes

This page describes changes you need to be aware of when upgrading from Istio 1.1.x to 1.2.x. Here, we detail cases where we intentionally broke backwards compatibility. We also mention cases where backwards compatibility was preserved but new behavior was introduced that would be surprising to someone familiar with the use and operation of Istio 1.1.

Installation and upgrade

Most Mixer CRDs were removed from the system to simplify the configuration model, improve performance of Mixer when used with Kubernetes, and improve reliability in a variety of Kubernetes environments.

The following CRDs remain:

Custom Resource Definition name Purpose
adapter Specification of Istio extension declarations
attributemanifest Specification of Istio extension declarations
template Specification of Istio extension declarations
handler Specification of extension invocations
rule Specification of extension invocations
instance Specification of extension invocations

In the event you are using the removed mixer configuration schemas, set the following Helm flags during upgrade of the main Helm chart: --set mixer.templates.useTemplateCRDs=true --set mixer.adapters.useAdapterCRDs=true

Was this information useful?
Do you have any suggestions for improvement?

Thanks for your feedback!