From f73036262d4fce2244ff53828701ca834f36d675 Mon Sep 17 00:00:00 2001 From: allenxu404 Date: Wed, 9 Aug 2023 15:26:16 +0800 Subject: [PATCH] add upgrade doc Signed-off-by: allenxu404 --- ...{upgrade-to-1.11.md => upgrade-to-1.12.md} | 52 +++++++++---------- site/data/docs/main-toc.yml | 4 +- 2 files changed, 28 insertions(+), 28 deletions(-) rename site/content/docs/main/{upgrade-to-1.11.md => upgrade-to-1.12.md} (70%) diff --git a/site/content/docs/main/upgrade-to-1.11.md b/site/content/docs/main/upgrade-to-1.12.md similarity index 70% rename from site/content/docs/main/upgrade-to-1.11.md rename to site/content/docs/main/upgrade-to-1.12.md index ee412a0fa6..ba97660bdb 100644 --- a/site/content/docs/main/upgrade-to-1.11.md +++ b/site/content/docs/main/upgrade-to-1.12.md @@ -1,28 +1,28 @@ --- -title: "Upgrading to Velero 1.11" +title: "Upgrading to Velero 1.12" layout: docs --- ## Prerequisites -- Velero [v1.10.x][5] installed. +- Velero [v1.11.x][5] installed. If you're not yet running at least Velero v1.6, see the following: -- [Upgrading to v1.6][1] -- [Upgrading to v1.7][2] -- [Upgrading to v1.8][3] -- [Upgrading to v1.9][4] -- [Upgrading to v1.10][5] +- [Upgrading to v1.7][1] +- [Upgrading to v1.8][2] +- [Upgrading to v1.9][3] +- [Upgrading to v1.10][4] +- [Upgrading to v1.11][5] Before upgrading, check the [Velero compatibility matrix](https://github.com/vmware-tanzu/velero#velero-compatibility-matrix) to make sure your version of Kubernetes is supported by the new version of Velero. ## Instructions -**Caution:** From Velero v1.10, except for using restic to do file-system level backup and restore, kopia is also been integrated, it could be upgraded from v1.10 to v1.11 directly, but it would be a little bit of difference when upgrading to v1.11 from a version lower than v1.10.0. +**Caution:** From Velero v1.10, except for using restic to do file-system level backup and restore, kopia is also been integrated, it could be upgraded from v1.10 or higher to v1.12 directly, but it would be a little bit of difference when upgrading to v1.12 from a version lower than v1.10.0. ### Upgrade from version lower than v1.10.0 -1. Install the Velero v1.11 command-line interface (CLI) by following the [instructions here][0]. +1. Install the Velero v1.12 command-line interface (CLI) by following the [instructions here][0]. Verify that you've properly installed it by running: @@ -34,7 +34,7 @@ Before upgrading, check the [Velero compatibility matrix](https://github.com/vmw ```bash Client: - Version: v1.11.0 + Version: v1.12.0 Git commit: ``` @@ -51,7 +51,7 @@ Before upgrading, check the [Velero compatibility matrix](https://github.com/vmw ```bash # uploader_type value could be restic or kopia kubectl get deploy -n velero -ojson \ - | sed "s#\"image\"\: \"velero\/velero\:v[0-9]*.[0-9]*.[0-9]\"#\"image\"\: \"velero\/velero\:v1.11.0\"#g" \ + | sed "s#\"image\"\: \"velero\/velero\:v[0-9]*.[0-9]*.[0-9]\"#\"image\"\: \"velero\/velero\:v1.12.0\"#g" \ | sed "s#\"server\",#\"server\",\"--uploader-type=$uploader_type\",#g" \ | sed "s#default-volumes-to-restic#default-volumes-to-fs-backup#g" \ | sed "s#default-restic-prune-frequency#default-repo-maintain-frequency#g" \ @@ -60,7 +60,7 @@ Before upgrading, check the [Velero compatibility matrix](https://github.com/vmw # optional, if using the restic daemon set echo $(kubectl get ds -n velero restic -ojson) \ - | sed "s#\"image\"\: \"velero\/velero\:v[0-9]*.[0-9]*.[0-9]\"#\"image\"\: \"velero\/velero\:v1.11.0\"#g" \ + | sed "s#\"image\"\: \"velero\/velero\:v[0-9]*.[0-9]*.[0-9]\"#\"image\"\: \"velero\/velero\:v1.12.0\"#g" \ | sed "s#\"name\"\: \"restic\"#\"name\"\: \"node-agent\"#g" \ | sed "s#\[ \"restic\",#\[ \"node-agent\",#g" \ | kubectl apply -f - @@ -77,41 +77,41 @@ Before upgrading, check the [Velero compatibility matrix](https://github.com/vmw ```bash Client: - Version: v1.11.0 + Version: v1.12.0 Git commit: Server: - Version: v1.11.0 + Version: v1.12.0 ``` -### Upgrade from v1.10 -If it's directly upgraded from v1.10, the other steps remain the same only except for step 3 above. The details as below: +### Upgrade from v1.10 or higher +If it's directly upgraded from v1.10 or higher, the other steps remain the same only except for step 3 above. The details as below: -3. Update the container image used by the Velero deployment, plugin and, optionally, the node agent daemon set: +1. Update the container image used by the Velero deployment, plugin and, optionally, the node agent daemon set: ```bash # set the container and image of the init container for plugin accordingly, # if you are using other plugin kubectl set image deployment/velero \ - velero=velero/velero:v1.11.0 \ - velero-plugin-for-aws=velero/velero-plugin-for-aws:v1.7.0 \ + velero=velero/velero:v1.12.0 \ + velero-plugin-for-aws=velero/velero-plugin-for-aws:v1.8.0 \ --namespace velero # optional, if using the node agent daemonset kubectl set image daemonset/node-agent \ - node-agent=velero/velero:v1.11.0 \ + node-agent=velero/velero:v1.12.0 \ --namespace velero ``` ## Notes -If upgraded from v1.9.x, there still remains some resources left over in the cluster and never used in v1.11.x, which could be deleted through kubectl and it is based on your desire: +If upgraded from v1.9.x, there still remains some resources left over in the cluster and never used in v1.12.x, which could be deleted through kubectl and it is based on your desire: - resticrepository CRD and related CRs - velero-restic-credentials secret in velero install namespace [0]: basic-install.md#install-the-cli -[1]: https://velero.io/docs/v1.6/upgrade-to-1.6 -[2]: https://velero.io/docs/v1.7/upgrade-to-1.7 -[3]: https://velero.io/docs/v1.8/upgrade-to-1.8 -[4]: https://velero.io/docs/v1.9/upgrade-to-1.9 -[5]: https://velero.io/docs/v1.10/upgrade-to-1.10 +[1]: https://velero.io/docs/v1.7/upgrade-to-1.7 +[2]: https://velero.io/docs/v1.8/upgrade-to-1.8 +[3]: https://velero.io/docs/v1.9/upgrade-to-1.9 +[4]: https://velero.io/docs/v1.10/upgrade-to-1.10 +[5]: https://velero.io/docs/v1.11/upgrade-to-1.11 diff --git a/site/data/docs/main-toc.yml b/site/data/docs/main-toc.yml index 75ea67bc6e..7b5e9154d0 100644 --- a/site/data/docs/main-toc.yml +++ b/site/data/docs/main-toc.yml @@ -13,8 +13,8 @@ toc: url: /basic-install - page: Customize Installation url: /customize-installation - - page: Upgrade to 1.11 - url: /upgrade-to-1.11 + - page: Upgrade to 1.12 + url: /upgrade-to-1.12 - page: Supported providers url: /supported-providers - page: Evaluation install