diff --git a/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-helm.md b/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-helm.md index 64f6ec3a9..295161b6f 100644 --- a/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-helm.md +++ b/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-helm.md @@ -14,12 +14,22 @@ title: Upgrade Milvus Cluster with Helm Chart This guide describes how to upgrade your Milvus cluster with Milvus Helm charts. +## Prerequisites +- Helm version >= 3.14.0 +- Kubernetes version >= 1.20.0 + +
+ +Since Milvus-Helm chart version 4.2.21, we introduced pulsar-v3.x chart as dependency. For backward compatibility, please upgrade your helm to v3.14 or later version, and be sure to add the `--reset-then-reuse-values` option whenever you use `helm upgrade`. + +
+ ## Check Milvus Helm Chart Run the following commands to check new Milvus versions. ``` -$ helm repo update +$ helm repo update zilliztech $ helm search repo zilliztech/milvus --versions ``` @@ -31,7 +41,7 @@ The Milvus Helm Charts repo at `https://milvus-io.github.io/milvus-helm/` has be helm repo add zilliztech https://zilliztech.github.io/milvus-helm helm repo update # upgrade existing helm release -helm upgrade my-release zilliztech/milvus +helm upgrade my-release zilliztech/milvus --reset-then-reuse-values ``` The archived repo is still available for the charts up to 4.0.31. For later releases, use the new repo instead. @@ -122,8 +132,8 @@ sh rollingUpdate.sh -n default -i my-release -o update -t 2.4.15 -w 'milvusdb/mi To upgrade Milvus from a minor release before v2.2.3 to the latest, run the following commands: ```shell -helm repo update -helm upgrade my-release zilliztech/milvus --reuse-values --version=4.1.24 # use the helm chart version here +helm repo update zilliztech +helm upgrade my-release zilliztech/milvus --reset-then-reuse-values --version=4.1.24 # use the helm chart version here ``` Use the Helm chart version in the preceding command. For details on how to obtain the Helm chart version, refer to [Check the Milvus version](#Check-the-Milvus-version). diff --git a/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-operator.md b/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-operator.md index 3a2d8c9f3..7770e6474 100644 --- a/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-operator.md +++ b/v2.4.x/site/en/adminGuide/upgrade_milvus_cluster-operator.md @@ -80,10 +80,10 @@ spec: image: milvusdb/milvus: ``` -Then save your configuration as a YAML file (for example, `milvusupgrade.yml`) and apply this configuration file to your Milvus instance as follows: +Then save your configuration as a YAML file (for example, `milvusupgrade.yml`) and patch this configuration file to your Milvus instance as follows: ```shell -kubectl apply -f milvusupgrade.yml +kubectl patch -f milvusupgrade.yml ``` @@ -107,7 +107,7 @@ spec: Then run the following to perform the upgrade: ```shell -kubectl apply -f milvusupgrade.yaml +kubectl patch -f milvusupgrade.yaml ``` ## Migrate the metadata @@ -142,10 +142,10 @@ spec: ### 2. Apply the new configuration -Run the following command to apply the new configuration. +Run the following command to create the new configuration. ``` -$ kubectl apply -f https://github.com/zilliztech/milvus-operator/blob/main/config/samples/beta/milvusupgrade.yaml +$ kubectl create -f https://github.com/zilliztech/milvus-operator/blob/main/config/samples/beta/milvusupgrade.yaml ``` diff --git a/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-helm.md b/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-helm.md index d10bc0ebc..e4cc7b829 100644 --- a/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-helm.md +++ b/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-helm.md @@ -15,6 +15,16 @@ title: Upgrade Milvus Standalone with Helm Chart This guide describes how to upgrade your Milvus standalone with Milvus Helm charts. +## Prerequisites +- Helm version >= 3.14.0 +- Kubernetes version >= 1.20.0 + +
+ +Since Milvus-Helm chart version 4.2.21, we introduced pulsar-v3.x chart as dependency. For backward compatibility, please upgrade your helm to v3.14 or later version, and be sure to add the `--reset-then-reuse-values` option whenever you use `helm upgrade`. + +
+ ## Check the Milvus version Run the following commands to check new Milvus versions. @@ -30,9 +40,9 @@ The Milvus Helm Charts repo at `https://milvus-io.github.io/milvus-helm/` has be ```shell helm repo add zilliztech https://zilliztech.github.io/milvus-helm -helm repo update +helm repo update zilliztech # upgrade existing helm release -helm upgrade my-release zilliztech/milvus +helm upgrade my-release zilliztech/milvus --reset-then-reuse-values ``` The archived repo is still available for the charts up to 4.0.31. For later releases, use the new repo instead. @@ -125,7 +135,7 @@ To upgrade Milvus from a minor release before v2.2.3 to the latest, run the foll ```shell helm repo update -helm upgrade my-release milvus/milvus --reuse-values --version=4.1.24 # use the helm chart version here +helm upgrade my-release milvus/milvus --reset-then-reuse-values --version=4.1.24 # use the helm chart version here ``` Use the Helm chart version in the preceding command. For details on how to obtain the Helm chart version, refer to [Check the Milvus version](#Check-the-Milvus-version). diff --git a/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-operator.md b/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-operator.md index e0977ab11..7da452233 100644 --- a/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-operator.md +++ b/v2.4.x/site/en/adminGuide/upgrade_milvus_standalone-operator.md @@ -80,10 +80,10 @@ spec: image: milvusdb/milvus: ``` -Then save your configuration as a YAML file (for example, `milvusupgrade.yml`) and apply this configuration file to your Milvus instance as follows: +Then save your configuration as a YAML file (for example, `milvusupgrade.yml`) and patch this configuration file to your Milvus instance as follows: ```shell -kubectl apply -f milvusupgrade.yml +kubectl patch -f milvusupgrade.yml ``` ## Upgrade Milvus by changing its image @@ -108,7 +108,7 @@ spec: Then run the following to perform the upgrade: ```shell -kubectl apply -f milvusupgrade.yaml +kubectl patch -f milvusupgrade.yaml ``` ## Migrate the metadata @@ -144,7 +144,7 @@ spec: Run the following command to apply the new configuration. ``` -$ kubectl apply -f https://raw.githubusercontent.com/zilliztech/milvus-operator/main/config/samples/milvusupgrade.yaml +$ kubectl create -f https://raw.githubusercontent.com/zilliztech/milvus-operator/main/config/samples/milvusupgrade.yaml ```