docs: add a note of helm not updating CRDs in the upgrade section (#4675

) * add a note of helm not updating CRDs in the upgrade section Signed-off-by: Arko Dasgupta <arko@tetrate.io> * fix link Signed-off-by: Arko Dasgupta <arko@tetrate.io> --------- Signed-off-by: Arko Dasgupta <arko@tetrate.io>
envoyproxy · Nov 8, 2024 · 5d3df77 · 5d3df77
1 parent 3c5f27a
commit 5d3df77
Show file tree

Hide file tree

Showing 3 changed files with 9 additions and 3 deletions.
diff --git a/site/content/en/docs/install/install-helm.md b/site/content/en/docs/install/install-helm.md
@@ -61,7 +61,9 @@ consideration when debugging.
 
 ## Upgrading from a previous version
 
-Follow the steps outlined in [this](./install-yaml.md#upgrading-from-v1.1) section if you're upgrading from a previous version.
+[Helm](https://helm.sh/docs/chart_best_practices/custom_resource_definitions/#some-caveats-and-explanations) does not update CRDs
+that live in the `/crds` folder in the Helm Chart. So you will manually need to update the CRDs.
+Follow the steps outlined in [this](./install-yaml/#upgrading-from-v1.1) section if you're upgrading from a previous version.
 
 ## Helm chart customizations
 

diff --git a/site/content/en/latest/install/install-helm.md b/site/content/en/latest/install/install-helm.md
@@ -61,7 +61,9 @@ consideration when debugging.
 
 ## Upgrading from a previous version
 
-Follow the steps outlined in [this](./install-yaml.md#upgrading-from-v1.1) section if you're upgrading from a previous version.
+[Helm](https://helm.sh/docs/chart_best_practices/custom_resource_definitions/#some-caveats-and-explanations) does not update CRDs
+that live in the `/crds` folder in the Helm Chart. So you will manually need to update the CRDs.
+Follow the steps outlined in [this](./install-yaml/#upgrading-from-v1.1) section if you're upgrading from a previous version.
 
 ## Helm chart customizations
 

diff --git a/site/content/en/v1.2/install/install-helm.md b/site/content/en/v1.2/install/install-helm.md
@@ -61,7 +61,9 @@ consideration when debugging.
 
 ## Upgrading from a previous version
 
-Follow the steps outlined in [this](./install-yaml.md#upgrading-from-v1.1) section if you're upgrading from a previous version.
+[Helm](https://helm.sh/docs/chart_best_practices/custom_resource_definitions/#some-caveats-and-explanations) does not update CRDs
+that live in the `/crds` folder in the Helm Chart. So you will manually need to update the CRDs.
+Follow the steps outlined in [this](./install-yaml/#upgrading-from-v1.1) section if you're upgrading from a previous version.
 
 ## Helm chart customizations