Skip to content

How to upgrade the Istio Operator Package chart📜

  1. Checkout the branch that renovate created. This branch will have the image tag updates and typically some other necessary version changes that you will want. You can either work off of this branch or branch off of it.
  2. Run a kpt update to the new version of the Istio Operator chart, typically you can just run kpt pkg update chart@<version> --strategy alpha-git-patch (for example kpt pkg update chart@1.14.3 --strategy alpha-git-patch)
  3. Update the CRD file: chart/crds/customresourcedefinitions.gen.yaml is the file to update, there should be a link at the top that takes you to the source file. After navigating there, switch to the correct tag for the new version then copy down the contents + update the link on the first line to the new version.
  4. Update version references for the Chart. version should be <version>-bb.0 (ex: 1.14.3-bb.0) and appVersion should be <version> (ex: 1.14.3). Also validate that the BB annotation for the main Istio Operator version is updated (leave the Tetrate version as-is unless you are updating those images).
  5. Add a changelog entry for the update. At minimum mention updating the image versions + syncing the upstream chart.
  6. Update the readme following the steps in Gluon.
  7. Open MR (or check the one that Renovate created for you) and validate that the pipeline is successful. Also follow the testing steps below for some manual confirmations.

Testing new Istio Operator version📜

Generally the operator should be tested alongside the new controlplane version. Follow the steps in the controlplane documentation for testing.

Modifications made to upstream chart📜

/chart/templates/deployment.yaml📜

Renovate may remove the two keys listed here. Make sure that they are present and that their values are set to 1337: - spec.template.spec.containers.securityContext.runAsGroup - spec.template.spec.containers.securityContext.runAsUser

Added .Values.enterprise boolean gate to determine use of tetrate images. Make sure this is not removed and is updated if needed to reflect values changes. - spec.template.spec.containers[0].image

/chart/values.yaml📜

Changes to default values: - defaults.operator.monitoring.host should be 0.0.0.0 - defaults.operator.monitoring.port should be 8383 - defaults.hub should be ironbank image path

Added ## Big Bang Additions below this line ## section at bottom of file

Last update: 2024-05-16 by Greg M