v2.1

v2.1
v2.0
v1.0
Express
  1. Release Notes
  1. 产品介绍
  1. 安装指南
    1. 安装说明
    1. 在 Linux 快速安装 KubeSphere
    1. 安装可插拔的功能组件
    1. 集群高可用配置安装
    1. 在 Kubernetes 安装 KubeSphere
    1. 相关工具与插件
    1. 认证与安全
    1. 运维指南
  1. 快速入门
  1. 管理员指南
    1. 多租户管理
    1. 平台管理
    1. 基础设施
    1. 监控中心
    1. 平台设置
    1. 工具箱
    1. 通用配置
    1. FAQ
  1. 用户指南
    1. 应用
    1. 工作负载
    1. 存储
    1. 网络与服务
    1. 监控告警
    1. 配置中心
    1. 项目设置
    1. DevOps 工程
  1. 开发者指南
    1. Helm 应用开发
  1. API 文档
  1. 常见问题
  1. 附录
KubeSphere®️ 2019 All Rights Reserved.

升级编辑此页面

KubeSphere v2.1.0 已发布,该版本修复了已知的 Bug,关于 v2.1.0 版本的更新详情可参考 Release Note - v2.1.0

若您已安装的环境为 2.0.x 版本,我们强烈建议您下载 2.1.0 版本的 Installer 并升级至 2.1.0,最新的 Installer 支持将 KubeSphere 从 2.0.x 一键升级至 2.1.0,无需卸载和重新安装;同时支持升级 Kubernetes 和 etcd 至指定版本,升级过程中所有节点将会逐个升级,可能会出现短暂的应用服务中断现象,请您安排合理的升级时间。注意,2.1.0 目前暂不支持回滚至 2.0.x。

说明:本文档仅适用于 Linux Installer 安装的环境,若 2.0.x 是基于 Kubernetes 部署的环境,请参考 ks-installer 进行升级。

如何升级

第一步:下载最新安装包

下载最新的 KubeSphere v2.1.0 安装包至任务执行机,进入安装目录。

$ curl -L https://kubesphere.io/download/stable/v2.1.0 > installer.tar.gz \
&& tar -zxf installer.tar.gz

第二步:修改配置文件

升级将默认读取 2.1.0 的 conf 目录下的配置文件,因此在升级前需要将原有安装包中 conf 目录下的配置文件中的参数都同步到 2.1.0 版本安装包的对应文件中,修改配置文件分以下两种情况。

提示:若您的 2.0.x 集群是部署在 QingCloud 云平台,vars.yaml 文件中的与 QingCloud 云平台相关配置需在 2.1.0 的 plugin-qingcloud.yaml 中进行同步。

注意,在升级前请确保主机规格满足主机最低规格配置。 请根据您的安装模式参考 All-in-One 模式 - 准备主机Multi-Node 模式 主机规格表。

All-in-One

若 2.0.x 是以 all-in-one 模式安装的单节点集群,那么升级前在 2.0.x 中无需修改 conf/hosts.ini 文件,仅需要确认 2.0.x 的 conf/vars.yaml 参数配置是否修改,若有修改则需要在 2.1.0 的对应文件中同步所有修改的参数。

例如,目前 2.1.0 中默认使用 Local 作为存储类型,如果您的 2.0.x 配置使用了其它存储类型,如 QingCloud 块存储、NFS、Ceph RBD 或 GlusterFS 等,那么在 2.1.0 安装包的 conf/common.yaml 中也需要进行相应的设置(即与 2.0.x 的配置保持一致),参数释义详见 存储配置参数

Multi-Node

若 2.0.x 是以 multi-node 模式安装的多节点集群,那么升级前需先将 2.0.x Installer 中的 conf/hosts.iniconf/vars.yaml 中的配置都同步到 2.1.0 的对应文件中:

  • 将 2.0.x 的 conf/hosts.ini 中的主机参数配置覆盖至 2.1.0 安装包的 conf/hosts.ini,参数释义详见 Multi-Node 模式 - 准备安装配置文件
  • 注意,选取 2.0.x 的 conf/vars.yaml 中所有修改过的参数配置项的值同步至 2.1.0 conf/common.yaml 中的对应项。例如,2.0.x 配置使用的是 QingCloud 块存储、NFS、Ceph RBD 或 GlusterFS 这一类存储,那么在 2.1.0 安装包的 conf/common.yaml 中存储类型的配置也需要与 2.0.x 的存储类型保持一致),参数释义详见 持久化存储配置说明
  • 提示:若 2.0.x 使用的存储类型不是 local volume,升级前需要先在 conf/common.yaml 中将 local volume 的两个字段设置为 false,再将之前的存储类型配置参数同步到 conf/common.yaml

第三步:开始升级

完成上述配置后,参考如下步骤进行升级:

3.1. 进入 scripts 目录,执行升级脚本,建议使用 root 用户:

$ ./upgrade.sh

3.2. 确认提示信息无误后,输入 yes 开始升级。

3.3. 由于升级是对逐个节点进行升级,因此升级时间与集群节点规模与网络状况相关。升级完成后,可使用之前的 KubeSphere 访问地址和账户登陆 Console,点击右上角的「关于」查看版本是否更新成功。