从 4.0 升级到 4.1.x

4.1.2

前端

@ks-console/* 依赖已全部迁移至 https://registry.npm.kubesphere.com.cn。安装前请参阅自建 npm 仓库说明 了解用户名申请、.npmrc 配置及验证方式。

安装/升级 KubeSphere 依赖包

安装/升级 create-ks-project

npm install -g create-ks-project

安装/升级 KubeSphere Console 依赖包

yarn add -W \
  @ks-console/appstore@latest \
  @ks-console/bootstrap@latest \
  @ks-console/console@latest \
  @ks-console/core@latest \
  @ks-console/locales@latest \
  @ks-console/server@latest \
  @ks-console/shared@latest

@ks-console/* 的版本最好和 KubeSphere 的版本保持一致。安装时请确认 Yarn/npm 正在读取自建仓库，否则一旦 https://www.npmjs.com 不再提供这些依赖将导致安装失败。

安装/升级 Kube Design

yarn add -W \
  @kubed/charts@latest \
  @kubed/code-editor@latest \
  @kubed/components@latest \
  @kubed/diff-viewer@latest \
  @kubed/hooks@latest \
  @kubed/icons@latest \
  @kubed/log-viewer@latest

如果 @ks-console/* 版本 >=4.1.0，需要将 Kube Design 等依赖升级到最新版本。

否则在本地运行和打包时，可能会出现报错信息。

扩展组件外部依赖改变

在 KubeSphere 4.1.2 之前，core 会提供一些常用的依赖库，扩展组件无需安装这些依赖即可直接 import 使用，这些依赖被称为扩展组件的外部依赖。

然而，如果扩展组件的外部依赖导致功能异常时，扩展组件需要等待 core 更新依赖才能修复。这显然违背了扩展机制的初衷。

因此，从 4.1.2 开始，我们移除了一些扩展组件的外部依赖，具体如下：

  • lodash
  • react-is
  • react-markdown

扩展组件如需使用这些库，需要自行安装，import 和使用方法不变。

拆分 Webpack 自定义配置

在 KubeSphere 4.1.2 之前，只有一个 Webpack 自定义配置文件，即 configs/webpack.config.js。该文件既用于本地运行 KubeSphere Console（yarn dev 和 yarn dev:client）时的 Webpack 自定义配置，又用于打包扩展组件前端（yarn build:ext）时的 Webpack 自定义配置。

从 4.1.2 开始，Webpack 自定义配置文件分为 2 个：

  • configs/webpack.config.js：用于本地运行 KubeSphere Console（yarn dev 和 yarn dev:client）的 Webpack 自定义配置。
  • configs/webpack.extensions.config.js：用于打包扩展组件前端（yarn build:ext）的 Webpack 自定义配置。
弃用本地 production 模式

由于可以直接访问远端的 KubeSphere Console 查看扩展组件，因此不再需要本地的 production 模式。

因此，弃用 package.json 中 scripts 的 build:prod 和 start 命令。

4.1.0

前端

扩展组件配置方式改变

从 KubeSphere 4.1.0 开始，扩展组件前端需要把配置导出

export default extensionConfig;

而不是之前的注册扩展组件方式

globals.context.registerExtension(extensionConfig);