From 2259a7fdb8fc8719e092cf97f141a3629e75693a Mon Sep 17 00:00:00 2001 From: Venktesh Date: Fri, 20 Dec 2024 11:22:14 +0000 Subject: [PATCH] update upgrade docs --- .../installing-nic/installation-with-helm.md | 3 +++ .../installation/installing-nic/upgrade-to-v4.md | 14 ++++++++++++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/site/content/installation/installing-nic/installation-with-helm.md b/site/content/installation/installing-nic/installation-with-helm.md index c0fe568b7..aebcd19ed 100644 --- a/site/content/installation/installing-nic/installation-with-helm.md +++ b/site/content/installation/installing-nic/installation-with-helm.md @@ -34,6 +34,9 @@ If you do not use the custom resources that require those CRDs (which correspond ### Upgrade the CRDs +{{< note >}} Please make sure to read the steps outlined in [Upgrade to V4](https://docs.nginx.com/nginx-ingress-controller/installation/installing-nic/upgrade-to-v4/#update-custom-resource-apiversion) before running the CRD upgrade and perform the steps if applicable +{{< /note >}} + To upgrade the CRDs, pull the chart sources as described in [Pull the Chart](#pull-the-chart) and then run: ```shell diff --git a/site/content/installation/installing-nic/upgrade-to-v4.md b/site/content/installation/installing-nic/upgrade-to-v4.md index 7880c17a9..f88706634 100644 --- a/site/content/installation/installing-nic/upgrade-to-v4.md +++ b/site/content/installation/installing-nic/upgrade-to-v4.md @@ -17,9 +17,9 @@ For NGINX Plus users, there is a third step to create a Secret for your license. ## Update custom resource apiVersion -If the Helm chart you have been using is `v2.x`, before upgrading to NGINX Ingress Controller 4.0.0 you must update your GlobalConfiguration, Policy and TransportServer resources from `apiVersion: k8s.nginx.org/v1alpha1` to `apiVersion: k8s.nginx.org/v1`. +If the Helm chart you have been using is `v2.x`, before upgrading to NGINX Ingress Controller 4.0.0 you must update your GlobalConfiguration, Policy and TransportServer resources from `apiVersion: k8s.nginx.org/v1alpha1` to `apiVersion: k8s.nginx.org/v1` -If the Helm chart you have been using is `v1.0.2` or earlier (NGINX Ingress Controller `v3.2.2`), upgrade to Helm chart `v1.4.2` (NGINX Ingress Controller `v3.7.2`) before updating your GlobalConfiguration, Policy and TransportServer resources. +If the Helm chart you have been using is `v1.0.2` or earlier (NGINX Ingress Controller `v3.3.2`), upgrade to Helm chart `v1.4.2` (NGINX Ingress Controller `v3.7.2`) before updating your GlobalConfiguration, Policy and TransportServer resources. The example below shows the change for a Policy resource: you must do the same for all GlobalConfiguration and TransportServer resources. @@ -61,6 +61,16 @@ spec: If a *GlobalConfiguration*, *Policy* or *TransportServer* resource is deployed with `apiVersion: k8s.nginx.org/v1alpha1`, it will be **deleted** during the upgrade process. {{}} +Please run below `kubectl` commands before upgrading to v4.0.0 Custom Resource Definitions (CRDs) + +```shell +kubectl patch customresourcedefinitions transportservers.k8s.nginx.org --subresource='status' --type='merge' -p '{"status":{"storedVersions": ["v1"]}}' +``` + +```shell +kubectl patch customresourcedefinitions globalconfigurations.k8s.nginx.org --subresource='status' --type='merge' -p '{"status":{"storedVersions": ["v1"]}}' +``` + --- ## Configure structured logging