Update migration doc

Signed-off-by: Jianbo Sun <[email protected]>
kubevela · Jul 28, 2023 · d694f49 · d694f49
1 parent f647710
commit d694f49
Show file tree

Hide file tree

Showing 11 changed files with 44 additions and 18 deletions.
diff --git a/docs/developers/references/devex/faq.md b/docs/developers/references/devex/faq.md
@@ -35,7 +35,7 @@ Image Hub | "hub.kubevela.net" | "docker.io" or "ghcr.io/kubevela"
 Helm charts | https://charts.kubevela.net/core | https://kubevela.github.io/charts
 Official Addon Registry | https://addons.kubevela.net | https://kubevela.github.io/catalog/official
 Experimental Addon Registry | - | https://kubevela.github.io/catalog/experimental
-CLI | https://kubevela.net/script/install.sh | download from [release page](https://github.com/kubevela/kubevela/releases)
+CLI | https://kubevela.io/script/install.sh | download from [release page](https://github.com/kubevela/kubevela/releases)
 VelaD | - | migrating 
 
 ### You have reached rate limit for Docker Image Registry 

diff --git a/docs/platform-engineers/system-operation/migration-from-old-version.md b/docs/platform-engineers/system-operation/migration-from-old-version.md
@@ -6,6 +6,32 @@ This doc aims to provide a migration guide from old versions to the new ones wit
 
 KubeVela has [release cadence](../../contributor/release-process) for every 2-3 months, we'll only maintain for the last 2 releases. As a result, you're highly recommended to upgrade along with the community. We'll strictly align with the [semver version rule](https://semver.org/) for compatibility.
 
+## From v1.8.x to v1.9.x
+
+:::caution
+1. Legacy code removal. Basically you will not be able to use EnvBinding, HealthScope, ScopeDefinition and other objects in old KubeVela (<1.0), like ApplicationConfiguration.
+2. Registry migrated from kubevela.net OSS storage to GitHub pages.
+> Notice: the "hub.kubevela.net", "charts.kubevela.net" and "addons.kubevela.net" will not be served in the future.
+> 1. For docker images in "hub.kubevela.net", replace it with "docker.io" or "ghcr.io/kubevela".
+> 2. For helm charts in "charts.kubevela.net", replace it with "kubevela.github.io/charts".
+> 3. For addons in "addons.kubevela.net", replace it with "kubevela.github.io/catalog/official".
+> 
+> You can run the following command to update your addon registry.
+> ```shell
+> vela addon registry delete KubeVela
+> vela addon registry add KubeVela --type helm --endpoint=https://kubevela.github.io/catalog/official
+> vela addon registry add experimental --type helm --endpoint=https://kubevela.github.io/catalog/experimental
+> ```
+:::
+
+1. Upgrade your kubevela chart
+
+```
+helm repo add kubevela https://kubevela.github.io/charts
+helm repo update
+helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.9.5 --wait
+```
+
 ## From v1.7.x to v1.8.x
 
 These isn't too much work to be done for upgrading from v1.7.x to v1.8.x for usage.
@@ -15,7 +41,7 @@ These isn't too much work to be done for upgrading from v1.7.x to v1.8.x for usa
 ```
 helm repo add kubevela https://charts.kubevela.net/core
 helm repo update
-helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.8.0 --wait
+helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.8.2 --wait
 ```
 
 ## From v1.6.x to v1.7.x
@@ -55,7 +81,7 @@ Since we have migrated some workflow step definitions and views from workflow ad
 You can execute this script to solve it before upgrade helm chart:
 
 ```
-curl -fsSl https://kubevela.net/script/checklegacy.sh | bash
+curl -fsSl https://kubevela.io/script/checklegacy.sh | bash
 ```
 
 The script will just help patch helm annotations for you, you can also do that manually one by one like:

diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/installation/kubernetes.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/installation/kubernetes.mdx
@@ -35,13 +35,13 @@ KubeVela CLI 提供了常用的集群和应用管理能力。
 ** MacOS/Linux **
 
 ```shell script
-curl -fsSl https://kubevela.net/script/install.sh | bash
+curl -fsSl https://kubevela.io/script/install.sh | bash
 ```
 
 **Windows**
 
 ```shell script
-powershell -Command "iwr -useb https://kubevela.net/script/install.ps1 | iex"
+powershell -Command "iwr -useb https://kubevela.io/script/install.ps1 | iex"
 ```
 
 </TabItem>

diff --git a/...-docs/current/platform-engineers/system-operation/migration-from-old-version.md b/...-docs/current/platform-engineers/system-operation/migration-from-old-version.md
@@ -41,7 +41,7 @@ helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.7.
 你可以执行下列脚本修复：
 
 ```
-curl -fsSl https://kubevela.net/script/checklegacy.sh | bash
+curl -fsSl https://kubevela.io/script/checklegacy.sh | bash
 ```
 
 这个脚本就是在帮你自动添加 Helm 的注解，你也可以通过如下命令手动修复：

diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-v1.9/installation/kubernetes.mdx b/i18n/zh/docusaurus-plugin-content-docs/version-v1.9/installation/kubernetes.mdx
@@ -35,13 +35,13 @@ KubeVela CLI 提供了常用的集群和应用管理能力。
 ** MacOS/Linux **
 
 ```shell script
-curl -fsSl https://kubevela.net/script/install.sh | bash
+curl -fsSl https://kubevela.io/script/install.sh | bash
 ```
 
 **Windows**
 
 ```shell script
-powershell -Command "iwr -useb https://kubevela.net/script/install.ps1 | iex"
+powershell -Command "iwr -useb https://kubevela.io/script/install.ps1 | iex"
 ```
 
 </TabItem>

diff --git a/.../version-v1.9/platform-engineers/system-operation/migration-from-old-version.md b/.../version-v1.9/platform-engineers/system-operation/migration-from-old-version.md
@@ -41,7 +41,7 @@ helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.7.
 你可以执行下列脚本修复：
 
 ```
-curl -fsSl https://kubevela.net/script/checklegacy.sh | bash
+curl -fsSl https://kubevela.io/script/checklegacy.sh | bash
 ```
 
 这个脚本就是在帮你自动添加 Helm 的注解，你也可以通过如下命令手动修复：

diff --git a/versioned_docs/version-v1.8/installation/kubernetes.mdx b/versioned_docs/version-v1.8/installation/kubernetes.mdx
@@ -36,7 +36,7 @@ KubeVela CLI provides an easy way to engage and manage your application delivery
 ** MacOS/Linux **
 
 ```shell script
-curl -fsSl https://kubevela.net/script/install.sh | bash
+curl -fsSl https://kubevela.net/script/install.sh | bash -s v1.8.0
 ```
 
 **Windows**
@@ -134,7 +134,7 @@ Refer to [using Vela CLI docker image](../platform-engineers/system-operation/ve
 <TabItem value="vela">
 
 ```shell script
-$ vela install
+$ vela install --version=v1.8.0
 ```
 <details>
   <summary> check out the outcome </summary>

diff --git a/versioned_docs/version-v1.8/installation/standalone.mdx b/versioned_docs/version-v1.8/installation/standalone.mdx
@@ -54,7 +54,7 @@ You may be required for root privilege during the installation process if not us
 If you don't need the automation with root access, you can download from the [release page](https://github.com/kubevela/velad/releases) and uncompress manually.
 
 ```shell
-curl -fsSl https://static.kubevela.net/script/install-velad.sh | bash
+curl -fsSl https://static.kubevela.net/script/install-velad.sh | bash -s 1.8.2
 ```
 
 Check `velad` installed in `/usr/local/bin/`
@@ -265,7 +265,7 @@ so you may be required for root privilege during the installation process.
 If you don't need the automation with root access, you can download from the [release page](https://github.com/kubevela/velad/releases) and uncompress manually.
 
 ```shell
-curl -fsSl https://static.kubevela.net/script/install-velad.sh | bash
+curl -fsSl https://static.kubevela.net/script/install-velad.sh | bash -s 1.8.2
 ```
 
 Check `velad` installed in `/usr/local/bin/`
@@ -416,7 +416,7 @@ Then you need to copy this kubeconfig to your local machine. Let's say you savin
 To access the cluster, you also need to install `vela` CLI in your local machine.
 
 ```shell
-curl -fsSl https://static.kubevela.net/script/install.sh | bash
+curl -fsSl https://static.kubevela.net/script/install.sh | bash -s 1.8.2
 ```
 
 #### Access KubeVela

diff --git a/.../version-v1.8/platform-engineers/system-operation/migration-from-old-version.md b/.../version-v1.8/platform-engineers/system-operation/migration-from-old-version.md
@@ -15,7 +15,7 @@ These isn't too much work to be done for upgrading from v1.7.x to v1.8.x for usa
 ```
 helm repo add kubevela https://charts.kubevela.net/core
 helm repo update
-helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.8.0 --wait
+helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.8.2 --wait
 ```
 
 ## From v1.6.x to v1.7.x

diff --git a/versioned_docs/version-v1.9/developers/references/devex/faq.md b/versioned_docs/version-v1.9/developers/references/devex/faq.md
@@ -35,7 +35,7 @@ Image Hub | "hub.kubevela.net" | "docker.io" or "ghcr.io/kubevela"
 Helm charts | https://charts.kubevela.net/core | https://kubevela.github.io/charts
 Official Addon Registry | https://addons.kubevela.net | https://kubevela.github.io/catalog/official
 Experimental Addon Registry | - | https://kubevela.github.io/catalog/experimental
-CLI | https://kubevela.net/script/install.sh | download from [release page](https://github.com/kubevela/kubevela/releases)
+CLI | https://kubevela.io/script/install.sh | download from [release page](https://github.com/kubevela/kubevela/releases)
 VelaD | - | migrating 
 
 ### You have reached rate limit for Docker Image Registry 

diff --git a/.../version-v1.9/platform-engineers/system-operation/migration-from-old-version.md b/.../version-v1.9/platform-engineers/system-operation/migration-from-old-version.md
@@ -15,7 +15,7 @@ These isn't too much work to be done for upgrading from v1.7.x to v1.8.x for usa
 ```
 helm repo add kubevela https://charts.kubevela.net/core
 helm repo update
-helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.8.0 --wait
+helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.8.2 --wait
 ```
 
 ## From v1.6.x to v1.7.x
@@ -55,7 +55,7 @@ Since we have migrated some workflow step definitions and views from workflow ad
 You can execute this script to solve it before upgrade helm chart:
 
 ```
-curl -fsSl https://kubevela.net/script/checklegacy.sh | bash
+curl -fsSl https://kubevela.io/script/checklegacy.sh | bash
 ```
 
 The script will just help patch helm annotations for you, you can also do that manually one by one like: