diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 06c0ce2db9..efed10c766 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -51,6 +51,7 @@ * [Build Infra](user-guide/global-configurations/build-infra.md) * [Devtron Upgrade](setup/upgrade/README.md) * [Update Devtron from Devtron UI](setup/upgrade/upgrade-devtron-ui.md) + * [0.6.x-0.7.x](setup/upgrade/devtron-upgrade-0.6.x-0.7.x.md) * [0.5.x-0.6.x](setup/upgrade/devtron-upgrade-0.5.x-0.6.x.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) diff --git a/docs/setup/upgrade/README.md b/docs/setup/upgrade/README.md index c74f89c671..2f5130b176 100644 --- a/docs/setup/upgrade/README.md +++ b/docs/setup/upgrade/README.md @@ -6,6 +6,7 @@ Devtron can be upgraded in one of the following ways: **Versions Upgrade** +- [0.6.x to 0.7.x](devtron-upgrade-0.6.x-0.7.x.md) - [0.5.x to 0.6.x](devtron-upgrade-0.5.x-0.6.x.md) - [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) diff --git a/docs/setup/upgrade/devtron-upgrade-0.6.x-0.7.x.md b/docs/setup/upgrade/devtron-upgrade-0.6.x-0.7.x.md new file mode 100644 index 0000000000..16cefd8693 --- /dev/null +++ b/docs/setup/upgrade/devtron-upgrade-0.6.x-0.7.x.md @@ -0,0 +1,55 @@ +# Upgrading Devtron 0.6.x to 0.7.x + +To check the current version of your Devtron setup, use the following command + +```bash +kubectl -n devtroncd get installers installer-devtron -o jsonpath='{.status.sync.data}' | grep "^LTAG=" | cut -d"=" -f2- +``` + +Proceed with the following steps only if the version is `0.6.x` + +--- + +## Prerequisites + +1. Set the release name + +```bash +export RELEASE_NAME=devtron +``` + +2. Label and annotate the service accounts in the `devtron-ci` namespace + +```bash +kubectl -n devtron-ci label sa --all "app.kubernetes.io/managed-by=Helm" --overwrite +kubectl -n devtron-ci annotate sa --all "meta.helm.sh/release-name=$RELEASE_NAME" "meta.helm.sh/release-namespace=devtroncd" --overwrite +``` + +3. Now, label and annotate the service accounts in the `devtron-cd` namespace + +``` +kubectl -n devtron-cd label sa --all "app.kubernetes.io/managed-by=Helm" --overwrite +kubectl -n devtron-cd annotate sa --all "meta.helm.sh/release-name=$RELEASE_NAME" "meta.helm.sh/release-namespace=devtroncd" --overwrite +``` + +--- + +## Upgrade Commands + +1. Update the Helm repository + +```bash +helm repo update +``` + +2. Run the upgrade command for Devtron + +```bash +helm upgrade devtron devtron/devtron-operator -n devtroncd --reuse-values -f https://raw.githubusercontent.com/devtron-labs/devtron/main/charts/devtron/devtron-bom.yaml +``` + +--- + +## Expected Command Output + +![Command Output](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/kubernetes-resource-browser/command-output.jpg)