v2.0

v2.0
v2.1-dev
v1.0
Express
  1. Release Notes
  1. 产品介绍
  1. 安装指南
  1. 快速入门
  1. 管理员指南
    1. 多租户管理
    1. 平台管理
    1. 基础设施
    1. 监控中心
    1. 平台设置
    1. 工具箱
    1. 通用配置
    1. FAQ
  1. 用户指南
    1. 应用
    1. 工作负载
    1. 存储
    1. 网络与服务
    1. 监控告警
    1. 配置中心
    1. 项目设置
    1. DevOps 工程
  1. API 文档
  1. 常见问题
  1. 附录
KubeSphere®️ 2019 All Rights Reserved.

升级

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

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

如何升级

第一步:下载最新安装包

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

$ curl -L https://kubesphere.io/download/stable/advanced-2.0.2 > advanced-2.0.2.tar.gz && tar -zxf advanced-2.0.2.tar.gz && cd kubesphere-all-advanced-2.0.2/scripts

第二步:修改配置文件

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

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

All-in-One

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

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

Multi-Node

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

  • 将 2.0.1 的 conf/hosts.ini 中的主机参数配置覆盖至 2.0.2 安装包的 conf/hosts.ini,参数释义详见 Multi-Node 模式 - 准备安装配置文件
  • 选取 2.0.1 的 conf/vars.yml 中所有修改过的参数配置项的值同步至 2.0.2 conf/vars.yml 中的对应项。例如,2.0.1 配置使用的是 QingCloud 块存储、NFS、Ceph RBD 或 GlusterFS 这一类存储,那么在 2.0.2 安装包的 conf/vars.yml 中也要进行相应的设置(即与 2.0.1 的配置保持一致),参数释义详见 存储配置参数
  • 注意,2.0.2 可选配置项如负载均衡器插件、邮件服务器、SonarQube 配置,在 Installer 的 conf/vars.yml 中可按需进行安装。

第三步:开始升级

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

3.1. 在 kubesphere-all-advanced-2.0.2 目录下进入 /script 目录,执行 upgrade.sh 脚本,建议使用 root 用户:

$ ./upgrade.sh

3.2. 在以下返回中输入 yes 开始升级:

ks_version: 2.0.1 to 2.0.2
k8s_version: v1.12.5 to v1.13.5

The relevant information is shown above, Please confirm:  (yes/no)

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

升级
如何升级
第一步:下载最新安装包
第二步:修改配置文件
All-in-One
Multi-Node
第三步:开始升级