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. DevOps 配置
    1. FAQ
  1. 用户指南
    1. 应用
    1. 工作负载
    1. 存储
    1. 网络与服务
    1. 监控告警
    1. 配置中心
    1. 项目设置
    1. DevOps 工程
  1. 开发者指南
    1. Helm 应用开发
    1. Source to Image(S2I) 自定义模版开发
  1. API 文档
  1. 常见问题
  1. 附录
KubeSphere®️ 2020 All Rights Reserved.

安装说明

编辑

KubeSphere 是在 Kubernetes 之上构建的 企业级分布式容器平台,为用户提供简单易用的操作界面以及向导式操作方式,还能够帮助一键快速安装与运营 Kubernetes 集群。

KubeSphere 支持部署和运行在包括 公有云、私有云、虚机、物理机 和 Kubernetes 等任何基础设施之上,KubeSphere 可以部署在公有云托管的 Kubernetes 之上 (如 GKE、EKS、ACK),也支持部署在私有化的 Kubernetes 之上 (如 kubeadm、k3s、RKE 部署的集群)。目前已在 阿里云、腾讯云、华为云、青云 QingCloud、AWS、Google Cloud、Kubernetes、GKE、RKE 上进行过部署测试。并且,KubeSphere 支持 在线安装与离线安装

KubeSphere 所有版本 100% 开源免费,已大规模服务于社区用户,广泛地应用在以容器为中心的开发测试及生产环境,大量服务平稳地运行在 KubeSphere 之上。

安装须知

  • 由于安装过程中需要更新操作系统和从镜像仓库拉取镜像,因此必须能够访问外网。如果不能访问外网,则需要下载离线安装包。
  • 当进行 all-in-one 模式进行单节点安装时,这个节点既是管理节点,也是工作节点。
  • 当进行 multi-node 模式安装多节点集群时,可在配置文件中设置集群各节点的角色。
  • 如果是新安装的系统,在 Software Selection 界面需要把 OpenSSH Server 选上。
  • 安装之前建议关闭防火墙,或参考 端口防火墙 开放指定端口。

快速安装(适用于快速体验测试)

KubeSphere 在 2.1 版本的 Installer 对各功能组件进行了 解耦快速安装将默认仅开启最小化安装(Minimal Installation),支持在安装前或安装后 自定义可插拔的功能组件的安装,使最小化安装 更快速轻量且资源占用更少,方便不同用户 按需选择安装不同的功能组件

快速安装的方式 无需配置持久化存储,仅建议您用来快速安装测试和体验 2.1 的功能特性。正式环境建议配置持久化存储与集群的高可用部署。

安装在 Linux

  • all-in-one:单节点安装,支持一键安装。
  • multi-node:多节点安装,支持一键安装。

提示:2.1.1 的离线安装包将在 2 月底发布。发布前可参考 离线安装多节点 KubeSphere 2.1.0

安装在 Kubernetes

确保您的 Kubernetes 集群满足前提条件,然后再开启安装。

正式环境安装

安装在 Linux

正式环境需要使用多节点(Multi-node)部署,并且同时配置 持久化存储集群的高可用

  • 持久化存储配置说明: KubeSphere 默认开启了 Local Volume 方便初次安装但没有准备存储服务端的场景下进行部署测试。若在 正式环境安装使用需配置 KubeSphere 支持的持久化存储服务,并准备相应的存储服务端。本文档说明安装过程中如何在 Installer 中配置持久化存储服务端。
  • 高可用集群配置与安装:Multi-Node 模式安装 KubeSphere 可以帮助用户顺利地部署环境,由于在实际的生产环境我们还需要考虑 master 节点的高可用问题,本文档以配置负载均衡器 (Load Banlancer) 为例,引导您在安装过程中如何配置高可用的 Master 和 etcd 节点。

安装在 Kubernetes

需要注意的是,为方便快速安装测试,在 Kubernetes 在线部署 KubeSphere 文档中使用的存储类型是基于 OpenEBS 创建的 Local Volume。在正式环境安装 KubeSphere 之前,建议您保证 Kubernetes 集群本身已配置了高可用,即 Kubernetes 集群满足以下两个条件:

  • 集群已配置了持久化存储,并创建了 StorageClass
  • Master 节点数量 ≥ 3,且配置了负载均衡方案满足高可用

若满足以上两个条件,即可参考 在 Kubernetes 在线部署 KubeSphere 进行安装。

自定义安装可插拔的功能组件

Installer 支持在 KubeSphere 安装前和安装后单独安装可选的功能组件,您可以根据 业务需求和机器配置,选择安装所需的功能组件,体验 KubeSphere 完整的端到端的容器产品解决方案,并且 所有组件都是开源免费的

Pluggable Components

升级

若您的机器已安装的环境为 2.0.x 或 2.1.0 版本,我们建议您升级至最新的高级版 2.1.1,Installer 2.1.1 支持将 KubeSphere 从 2.0.x 或 2.1.0 环境一键升级至目前最新的 2.1.1,详见 升级指南

集群参数配置

在获取 Installer 并解压至目标安装机器后,如果需要修改网络、组件版本等集群配置相关参数,可参考以下说明进行修改,本文档对 Installer 中的安装配置文件 conf/common.yaml 进行说明,简单介绍每一个字段的意义。参考 集群参数配置

运维指南

集群节点扩容

安装 KubeSphere 后,在正式环境使用时可能会遇到服务器容量不足的情况,这时就需要添加新的节点 (node),然后将应用系统进行水平扩展来完成对系统的扩容,配置详见 集群节点扩容

卸载

卸载将从机器中删除 KubeSphere,该操作不可逆,详见 卸载说明

高危操作

KubeSphere 支持管理节点和 etcd 节点高可用,保证集群稳定性,同时基于 kubernetes 底层调度机制,可以保证容器服务的可持续性及稳定性,但并不推荐无理由关闭或者重启节点,因为这类后台操作均属于高危操作,可能会造成相关服务不可用,请谨慎操作。执行高危操作需将风险告知用户,并由用户以及现场运维人员同意之后,由运维人员进行后台操作。比如以下列表包含了高危操作和禁止操作,可能造成节点或集群不可用:

高危操作列表

序列 高危操作
1 重启集群节点或重装操作系统。
2 建议不要在集群节点安装其它软件,可能导致集群节点不可用。

禁止操作列表

序列 禁止操作
1 删除 /var/lib/etcd/,删除 /var/lib/docker,删除 /etc/kubernetes/,删除 /etc/kubesphere/
2 磁盘格式化、分区。