docs: devtron upgrade 0.4.x to 0.5.x doc (#2259)

* devtron upgrade doc

* README.md update

* Update devtron-upgrade-0.4.x-0.5.x.md

Co-authored-by: Shubham9t9 <[email protected]>
Co-authored-by: Prakarsh <[email protected]>

Author: 3 people

docs/SUMMARY.md

@@ -28,6 +28,7 @@
   * [External links](user-guide/global-configurations/external-links.md)
 * [Devtron Upgrade](setup/upgrade/README.md)
   * [Update Devtron from Devtron UI](setup/upgrade/upgrade-devtron-ui.md)
+  * [0.4.x-0.5.x](setup/upgrade/devtron-upgrade-0.4.x-0.5.x.md)
   * [0.4.x-0.4.x](setup/upgrade/devtron-upgrade-0.4.x-0.4.x.md)
   * [0.3.x-0.4.x](setup/upgrade/devtron-upgrade-0.3.x-0.4.x.md)
   * [0.3.x-0.3.x](setup/upgrade/devtron-upgrade-0.3.x-0.3.x.md)
@@ -84,4 +85,3 @@
 ## Depricated
 
 * [Hyperion](hyperion/devtron.md)
-

docs/setup/upgrade/README.md

@@ -6,6 +6,7 @@ Devtron can be upgraded in one of the following ways:
 
 **Versions Upgrade**
 
+- [0.4.x to 0.5.x](devtron-upgrade-0.4.x-0.5.x.md)
 - [0.4.x to 0.4.x](devtron-upgrade-0.4.x-0.4.x.md)
 - [0.3.x to 0.4.x](devtron-upgrade-0.3.x-0.4.x.md)
 - [0.3.x to 0.3.x](devtron-upgrade-0.3.x-0.3.x.md)

docs/setup/upgrade/devtron-upgrade-0.4.x-0.5.x.md

@@ -0,0 +1,65 @@
+# Upgrading Devtron 0.4.x to 0.5.x
+
+If you want to check the current version of Devtron you are using, please use the following command.
+
+```
+kubectl -n devtroncd get installers installer-devtron -o jsonpath='{.status.sync.data}' | grep "^LTAG=" | cut -d"=" -f2-
+```
+
+## Follow the below mentioned steps to upgrade the Devtron version using Helm
+
+
+### 1. Apply Prerequisites Patch Job
+
+If you are using rawYaml in deployment template, this update can introduce breaking changes. We recommend you to update the `Chart Version`
+of your app to `v4.13.0` to make rawYaml section compatible to new argocd version `v2.4.0`.
+
+Or
+
+We have released a argocd-v2.4.0 patch job to fix the compatibilities issues. Please apply this job in your cluster and wait for completion
+and then only upgrade to `Devtron v0.5.x`.
+
+```bash
+kubectl apply -f https://raw.githubusercontent.com/devtron-labs/utilities/main/scripts/jobs/argocd-2.4.0-prerequisites-patch-job.yaml
+```
+
+### 2. Check the devtron release name
+
+```bash
+helm list --namespace devtroncd
+```
+
+### 3. Set release name in the variable
+```bash
+RELEASE_NAME=devtron
+```
+
+### 4. Fetch the latest Devtron helm chart
+
+```bash
+helm repo update
+```
+
+
+### 5. Upgrade Devtron 
+
+**`5.1` Upgrade Devtron to latest version**
+
+```bash
+helm upgrade devtron devtron/devtron-operator --namespace devtroncd \
+-f https://raw.githubusercontent.com/devtron-labs/devtron/main/charts/devtron/devtron-bom.yaml \
+--set installer.modules={cicd} --reuse-values
+```
+OR
+
+**`5.2` Upgrade Devtron to a custom version**
+
+ You can find the latest releases from Devtron on Github https://github.com/devtron-labs/devtron/releases
+
+```bash
+DEVTRON_TARGET_VERSION=v0.5.x
+
+helm upgrade devtron devtron/devtron-operator --namespace devtroncd \
+-f https://raw.githubusercontent.com/devtron-labs/devtron/$DEVTRON_TARGET_VERSION/charts/devtron/devtron-bom.yaml \
+--set installer.modules={cicd} --reuse-values
+```