Istio 1.2 Upgrade Notes

Important changes operators must understand before upgrading to Istio 1.2.

Jun 18, 2019

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 namePurpose
adapterSpecification of Istio extension declarations
attributemanifestSpecification of Istio extension declarations
templateSpecification of Istio extension declarations
handlerSpecification of extension invocations
ruleSpecification of extension invocations
instanceSpecification 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