From a89bf2fcee2504a6c833fc9656973c0a838ec3a0 Mon Sep 17 00:00:00 2001
From: David Donchez <david.donchez@enix.fr>
Date: Wed, 6 Sep 2023 13:58:53 +0200
Subject: [PATCH] docs: add procedure for 1.3.0 upgrade

---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.md b/README.md
index 06a3d92e..e2e44e9a 100644
--- a/README.md
+++ b/README.md
@@ -160,6 +160,19 @@ helm upgrade --install \
      --set cachedImagesExpiryDelay=90
 ```
 
+## Upgrading
+
+### From 1.2.0 to 1.3.0
+
+In v1.3.0, we removed the finalizer `pod.kuik.enix.io/finalizer` from pods that were rewritten by Kuik.
+
+To avoid having these pods stuck in `Terminating` state after a delete action or a rolling update, you will need to manually remove the finalizer from these pods once you upgrade to 1.3.0.
+This can be achieved using the following command: 
+
+```
+kubectl get pods --all-namespaces -l kuik.enix.io/images-rewritten=true -o json | jq '.items[].metadata.finalizers=null' | kubectl replace -f -
+```
+
 ## Advanced usage
 
 ### Pod filtering