56 lines
2.9 KiB
Markdown
56 lines
2.9 KiB
Markdown
---
|
||
vssueId: 72
|
||
description: 本文描述了Kuboard_v2.0.x版本的升级方法
|
||
---
|
||
|
||
# 从 Kuboard v1.0.x 升级到 Kuboard v2.0.x
|
||
|
||
## Kuboard v2.0.x 与 Kuboard v1.0.x 不兼容的地方
|
||
|
||
### 自定义名称空间的方式
|
||
|
||
Kuboard v1.0.x 中，通过 ConfigMap 加载 kuboard-namespace-layout.yaml 文件的方式自定义名称空间的布局，参考 [自定义名称空间的布局](/install/install-kuboard-layout.html)。在 Kuboard v2.0.x 中，增强了名称空间配置的方式：
|
||
* 通过 CustomResource 进行配置；
|
||
* 在 Kuboard 界面中即可完成名称空间布局的配置；
|
||
* 可以配置全局默认的名称空间布局，还可以按名称空间单独配置；
|
||
|
||
升级建议：升级到 Kuboard v2.0.x 后，您需要按照 Kuboard v2.0.x 的方式重新定义名称空间布局。
|
||
|
||
### Kuboard 注解/标签变更
|
||
|
||
Kuboard 中，引入了一些自定义的标签（Labels）和注解（Annotations），主要用作如下用途：
|
||
* k8s.eip.work/layer 标识工作负载属于哪个分层
|
||
* k8s.eip.work/displayName 标识工作负载显示在 Kuboard 界面上的名字
|
||
|
||
从 Kuboard v2.0.0-beta.1 开始，这类标签（Labels）或注解（Annotations）将被调整为 k8s.kuboard.cn，例如：
|
||
* k8s.kuboard.cn/layer
|
||
* k8s.kuboard.cn/displayName
|
||
|
||
Kuboard v2.0.x **仍然将继续支持** k8s.eip.work/layer 和 k8s.eip.work/displayName 的显示，但是新建工作负载都将调整为 k8s.kuboard.cn
|
||
|
||
### 套件
|
||
|
||
Kuboard v1.0.x 中，由于早期版本不支持鉴权，在提供套件功能时，未能很好的解决权限问题，因此，在 Kuboard v1.0.x 中存在套件过度授权的情况，参考 [KUBOARD_SAFE_MODE](/install/install-kuboard-env.html#kuboard-safe-mode)。
|
||
|
||
Kuboard v2.0.x 将彻底解决这个问题，并重构套件功能，开放套件 API（尚不包括在 v2.0.0-beta.x 版本中）。如果您现在升级到 Kuboard v2.0.0-beta.x，将不能使用套件功能。
|
||
|
||
### 显示ICP备案编号
|
||
|
||
Kuboard v2.0.0-beta.x 暂不支持在页尾显示公司名字及 ICP 备案编号的信息，参考 [KUBOARD_ICP_DESCRIPTION](/install/install-kuboard-env.html#kuboard-icp-description)
|
||
|
||
## 升级办法
|
||
|
||
* 卸载 Kuboard 套件（如果有安装 Kuboard 套件）
|
||
|
||
参考 [卸载套件](/guide/addon/#卸载套件)
|
||
|
||
> Kuboard v2.0.0 的正式版将提供重构后的套件功能，届时，需要重新安装套件。如果您打算在某个时间点退回到 Kuboard v1.0.x，也可以选择不卸载套件，Kuboard v2.0.x 中不再提供 Kuboard v1.0.x 的套件卸载功能。
|
||
|
||
* 修改 Kuboard 镜像标签
|
||
|
||
参考 [指定 Kuboard 版本升级](/install/install-dashboard-upgrade.html#指定版本升级)，将 Kuboard 标签修改为 beta，或 v2.0.0-beta.1
|
||
|
||
* 重新自定义名称空间布局
|
||
|
||
进入 Kuboard v2.0.x 界面后，在名称空间页的右上角，可以找到 **自定义名称空间布局** 按钮，按照界面提示修改名称空间布局。
|