From f09526c2cab94aef4d4684e6471d0e2471edbd45 Mon Sep 17 00:00:00 2001 From: hongming Date: Mon, 7 Apr 2025 11:35:52 +0800 Subject: [PATCH] Update extension upgrade docs (#3249) Signed-off-by: hongming --- ...-install-components.adoc => 01-install-extensions.adoc} | 0 .../01-set-configurations.adoc | 0 .../02-set-cluster-agents.adoc | 0 .../03-disable-extensions.adoc} | 2 +- .../_index.adoc | 2 +- ...-upgrade-components.adoc => 03-upgrade-extensions.adoc} | 7 ++++++- ...nstall-components.adoc => 04-uninstall-extensions.adoc} | 2 +- ...-install-components.adoc => 01-install-extensions.adoc} | 0 .../01-set-configurations.adoc | 0 .../02-set-cluster-agents.adoc | 0 .../03-disable-extensions.adoc} | 2 +- .../_index.adoc | 2 +- ...-upgrade-components.adoc => 03-upgrade-extensions.adoc} | 7 ++++++- ...nstall-components.adoc => 04-uninstall-extensions.adoc} | 2 +- 14 files changed, 18 insertions(+), 8 deletions(-) rename content/en/docs/v4.1/06-extension-user-guide/{01-install-components.adoc => 01-install-extensions.adoc} (100%) rename content/en/docs/v4.1/06-extension-user-guide/{03-manage-components => 02-manage-extensions}/01-set-configurations.adoc (100%) rename content/en/docs/v4.1/06-extension-user-guide/{03-manage-components => 02-manage-extensions}/02-set-cluster-agents.adoc (100%) rename content/en/docs/v4.1/06-extension-user-guide/{03-manage-components/04-disable-components.adoc => 02-manage-extensions/03-disable-extensions.adoc} (98%) rename content/en/docs/v4.1/06-extension-user-guide/{03-manage-components => 02-manage-extensions}/_index.adoc (79%) rename content/en/docs/v4.1/06-extension-user-guide/{03-manage-components/03-upgrade-components.adoc => 03-upgrade-extensions.adoc} (63%) rename content/en/docs/v4.1/06-extension-user-guide/{03-manage-components/05-uninstall-components.adoc => 04-uninstall-extensions.adoc} (98%) rename content/zh/docs/v4.1/06-extension-user-guide/{01-install-components.adoc => 01-install-extensions.adoc} (100%) rename content/zh/docs/v4.1/06-extension-user-guide/{03-manage-components => 02-manage-extensions}/01-set-configurations.adoc (100%) rename content/zh/docs/v4.1/06-extension-user-guide/{03-manage-components => 02-manage-extensions}/02-set-cluster-agents.adoc (100%) rename content/zh/docs/v4.1/06-extension-user-guide/{03-manage-components/04-disable-components.adoc => 02-manage-extensions/03-disable-extensions.adoc} (99%) rename content/zh/docs/v4.1/06-extension-user-guide/{03-manage-components => 02-manage-extensions}/_index.adoc (96%) rename content/zh/docs/v4.1/06-extension-user-guide/{03-manage-components/03-upgrade-components.adoc => 03-upgrade-extensions.adoc} (65%) rename content/zh/docs/v4.1/06-extension-user-guide/{03-manage-components/05-uninstall-components.adoc => 04-uninstall-extensions.adoc} (98%) diff --git a/content/en/docs/v4.1/06-extension-user-guide/01-install-components.adoc b/content/en/docs/v4.1/06-extension-user-guide/01-install-extensions.adoc similarity index 100% rename from content/en/docs/v4.1/06-extension-user-guide/01-install-components.adoc rename to content/en/docs/v4.1/06-extension-user-guide/01-install-extensions.adoc diff --git a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/01-set-configurations.adoc b/content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/01-set-configurations.adoc similarity index 100% rename from content/en/docs/v4.1/06-extension-user-guide/03-manage-components/01-set-configurations.adoc rename to content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/01-set-configurations.adoc diff --git a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/02-set-cluster-agents.adoc b/content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/02-set-cluster-agents.adoc similarity index 100% rename from content/en/docs/v4.1/06-extension-user-guide/03-manage-components/02-set-cluster-agents.adoc rename to content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/02-set-cluster-agents.adoc diff --git a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/04-disable-components.adoc b/content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/03-disable-extensions.adoc similarity index 98% rename from content/en/docs/v4.1/06-extension-user-guide/03-manage-components/04-disable-components.adoc rename to content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/03-disable-extensions.adoc index 98028207a..e12cee32e 100644 --- a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/04-disable-components.adoc +++ b/content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/03-disable-extensions.adoc @@ -2,7 +2,7 @@ title: "Disable Extensions" keywords: "Kubernetes, KubeSphere, Enable, Disable, Extensions" description: "Learn how to disable extensions." -weight: 04 +weight: 03 --- This section explains how to disable extensions. diff --git a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/_index.adoc b/content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/_index.adoc similarity index 79% rename from content/en/docs/v4.1/06-extension-user-guide/03-manage-components/_index.adoc rename to content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/_index.adoc index cf143c047..71849b457 100644 --- a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/_index.adoc +++ b/content/en/docs/v4.1/06-extension-user-guide/02-manage-extensions/_index.adoc @@ -3,7 +3,7 @@ title: "Manage Extensions" keywords: "Kubernetes, KubeSphere, Management, Extensions" description: "Learn how to manage extensions." layout: "second" -weight: 03 +weight: 02 --- This section explains how to configure, upgrade, disable, uninstall extensions, and configure cluster agents. \ No newline at end of file diff --git a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/03-upgrade-components.adoc b/content/en/docs/v4.1/06-extension-user-guide/03-upgrade-extensions.adoc similarity index 63% rename from content/en/docs/v4.1/06-extension-user-guide/03-manage-components/03-upgrade-components.adoc rename to content/en/docs/v4.1/06-extension-user-guide/03-upgrade-extensions.adoc index 1cf9ab08e..e38615333 100644 --- a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/03-upgrade-components.adoc +++ b/content/en/docs/v4.1/06-extension-user-guide/03-upgrade-extensions.adoc @@ -7,7 +7,12 @@ weight: 03 This section explains how to upgrade extensions. -When there is a new version of an extension, you can upgrade it in the extension details page. +Before upgrading the extensions, make sure to update the extension repository to fetch the latest versions. You can update the ks-core extension repository using the following command: + +[source,bash] +---- +helm -n kubesphere-system upgrade ks-core https://charts.kubesphere.io/main/ks-core-.tgz --set ksExtensionRepository.image=$(curl -s https://api.github.com/repos/kubesphere-extensions/ks-extensions/releases/latest | jq -r '.tag_name') +---- == Prerequisites diff --git a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/05-uninstall-components.adoc b/content/en/docs/v4.1/06-extension-user-guide/04-uninstall-extensions.adoc similarity index 98% rename from content/en/docs/v4.1/06-extension-user-guide/03-manage-components/05-uninstall-components.adoc rename to content/en/docs/v4.1/06-extension-user-guide/04-uninstall-extensions.adoc index 2fd173d1b..77105e4c7 100644 --- a/content/en/docs/v4.1/06-extension-user-guide/03-manage-components/05-uninstall-components.adoc +++ b/content/en/docs/v4.1/06-extension-user-guide/04-uninstall-extensions.adoc @@ -2,7 +2,7 @@ title: "Uninstall Extensions" keywords: "Kubernetes, KubeSphere, Uninstall, Force Uninstall, Extensions" description: "Learn how to uninstall extensions." -weight: 05 +weight: 04 --- This section explains how to uninstall extensions. diff --git a/content/zh/docs/v4.1/06-extension-user-guide/01-install-components.adoc b/content/zh/docs/v4.1/06-extension-user-guide/01-install-extensions.adoc similarity index 100% rename from content/zh/docs/v4.1/06-extension-user-guide/01-install-components.adoc rename to content/zh/docs/v4.1/06-extension-user-guide/01-install-extensions.adoc diff --git a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/01-set-configurations.adoc b/content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/01-set-configurations.adoc similarity index 100% rename from content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/01-set-configurations.adoc rename to content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/01-set-configurations.adoc diff --git a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/02-set-cluster-agents.adoc b/content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/02-set-cluster-agents.adoc similarity index 100% rename from content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/02-set-cluster-agents.adoc rename to content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/02-set-cluster-agents.adoc diff --git a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/04-disable-components.adoc b/content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/03-disable-extensions.adoc similarity index 99% rename from content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/04-disable-components.adoc rename to content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/03-disable-extensions.adoc index 5b50a82d3..67944345f 100644 --- a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/04-disable-components.adoc +++ b/content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/03-disable-extensions.adoc @@ -3,7 +3,7 @@ title: "禁用扩展组件" linkTitle: "禁用扩展组件" keywords: "Kubernetes, KubeSphere,启用,禁用,扩展组件" description: "介绍如何禁用扩展组件。" -weight: 04 +weight: 03 --- 本节介绍如何禁用扩展组件。 diff --git a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/_index.adoc b/content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/_index.adoc similarity index 96% rename from content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/_index.adoc rename to content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/_index.adoc index 9581e2e64..cc6997d3c 100644 --- a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/_index.adoc +++ b/content/zh/docs/v4.1/06-extension-user-guide/02-manage-extensions/_index.adoc @@ -4,7 +4,7 @@ linkTitle: "管理扩展组件" keywords: "Kubernetes, KubeSphere, 管理, 扩展组件" description: "介绍如何管理扩展组件。" layout: "second" -weight: 03 +weight: 02 --- 本节介绍如何在扩展中心配置、升级、禁用、卸载扩展组件，以及如何配置集群 Agent。 diff --git a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/03-upgrade-components.adoc b/content/zh/docs/v4.1/06-extension-user-guide/03-upgrade-extensions.adoc similarity index 65% rename from content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/03-upgrade-components.adoc rename to content/zh/docs/v4.1/06-extension-user-guide/03-upgrade-extensions.adoc index bdb49b8d1..6dc2e15c5 100644 --- a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/03-upgrade-components.adoc +++ b/content/zh/docs/v4.1/06-extension-user-guide/03-upgrade-extensions.adoc @@ -8,7 +8,12 @@ weight: 03 本节介绍如何升级扩展组件。 -当组件有新版本时，您可以在扩展中心的组件详情页升级组件。 +在升级扩展组件之前，您需要先更新扩展组件仓库以获取最新扩展组件。可以通过以下命令更新 `ks-core` 的扩展组件仓库： + +[source,bash] +---- +helm -n kubesphere-system upgrade ks-core https://charts.kubesphere.io/main/ks-core-.tgz --set ksExtensionRepository.image=$(curl -s https://api.github.com/repos/kubesphere-extensions/ks-extensions/releases/latest | jq -r '.tag_name') +---- == 前提条件 diff --git a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/05-uninstall-components.adoc b/content/zh/docs/v4.1/06-extension-user-guide/04-uninstall-extensions.adoc similarity index 98% rename from content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/05-uninstall-components.adoc rename to content/zh/docs/v4.1/06-extension-user-guide/04-uninstall-extensions.adoc index 0a683f1c7..95dd41149 100644 --- a/content/zh/docs/v4.1/06-extension-user-guide/03-manage-components/05-uninstall-components.adoc +++ b/content/zh/docs/v4.1/06-extension-user-guide/04-uninstall-extensions.adoc @@ -3,7 +3,7 @@ title: "卸载扩展组件" linkTitle: "卸载扩展组件" keywords: "Kubernetes, KubeSphere,卸载,强制卸载,扩展组件" description: "介绍如何卸载扩展组件。" -weight: 05 +weight: 04 --- 本节介绍如何卸载扩展组件。