From 2bc8184f6ea7dc51b887fde8e0343b75530bd880 Mon Sep 17 00:00:00 2001 From: Venkat Date: Wed, 4 Dec 2024 16:49:45 +0000 Subject: [PATCH] fix: include upgrade notes that apply for v3.28+ --- charts/tigera-operator/README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/charts/tigera-operator/README.md b/charts/tigera-operator/README.md index 2679ce809bf..6e9dc632bcc 100644 --- a/charts/tigera-operator/README.md +++ b/charts/tigera-operator/README.md @@ -45,6 +45,16 @@ of the chart into the `tigera-operator` namespace. When upgrading from a version of Calico v3.22 or lower to a version of Calico v3.23 or greater, you must complete the following steps to migrate ownership of the helm resources to the new chart location. +## Upgrade OwnerReferences + +If you do not use OwnerReferences on resources in the projectcalico.org/v3 API group, you can skip this section. + +Starting in Calico v3.28, a change in the way UIDs are generated for projectcalico.org/v3 resources requires that you update any OwnerReferences that refer to projectcalico.org/v3 resources as an owner. After upgrade, the UID for all projectcalico.org/v3 resources will be changed, resulting in any owned resources being garbage collected by Kubernetes. + +1. Remove any OwnerReferences from resources in your cluster that have apiGroup: projectcalico.org/v3. +2. Perform the upgrade normally. +3. Add new OwnerReferences to your resources referencing the new UID. + ## Upgrade from Calico versions prior to v3.23.0 1. Patch existing resources so that the new chart can assume ownership.