Add in-place upgrade for APK upgrading

helm-charts/README.md

@@ -317,6 +317,7 @@ A Helm chart for APK components
 | gatewaySystem.enableServiceAccountCreation | bool | `true` |  |
 | gatewaySystem.enableClusterRoleCreation | bool | `true` |  |
 | gatewaySystem.serviceAccountName | string | `"gateway-api-admission"` |  |
+| gatewaySystem.applyGatewayWehbhookJobs | bool | `true` |  |
 | certmanager.enabled | bool | `true` | Enable certificate manager to generate certificates |
 | certmanager.enableClusterIssuer | bool | `true` | Enable cluster issuer to generate certificates |
 | certmanager.enableRootCa | bool | `true` | Enable root CA to generate certificates |

helm-charts/Version-Upgrade.md

@@ -1,3 +1,27 @@
-# Version Upgrade APK
+# Updating APK Version
 
-helm template test . -f version-upgrade-values.yaml && helm show crds . > t.yaml
+This guide outlines the process of upgrading from APK v1.0.0 installation to APK v1.1.0 installation.
+
+## In-Place Upgrade
+
+The in-place upgrade process transitions your existing APK v1.0.0 installation to APK v1.1.0. Prior to implementing these steps in a production environment, it is advised to apply and validate them in lower environments.
+
+- Ensure APK v1.0.0 is currently installed in the cluster.
+
+    **Note:** The steps provided below assume that APK v1.0.0 is installed in the `default` namespace under the release name `apk`. Replace the dot (.) with the appropriate APK v1.1.0 Helm chart name and version, which is `wso2apk/apk-helm --version 1.1.0`.
+
+- Install/Update CRDs for APK v1.1.0.
+
+    ```bash
+    (helm template apk . -f crds-upgrade-values.yaml -n default && helm show crds .) > apk-v1.1.0-crds.yaml
+
+    kubectl apply -f apk-v1.1.0-crds.yaml
+    ```
+
+- Upgrade the existing APK v1.0.0 installation to APK v1.1.0.
+
+    ```bash
+    helm upgrade --reuse-values apk . -f ./in-place-upgrade-values.yaml --set skipCrds=true
+    ```
+
+These steps will seamlessly transition your APK installation to the latest version, ensuring continued functionality and compatibility.

helm-charts/version-upgrade-values.yaml → helm-charts/crds-upgrade-values.yaml

@@ -35,6 +35,7 @@ gatewaySystem:
   enabled: false
   enableServiceAccountCreation: false
   enableClusterRoleCreation: false
+  applyGatewayWehbhookJobs: false
 
 certmanager:
   enabled: false