KubeSphere 2.1.1 发布!全面支持 Kubernetes 1.17!多项功能与用户体验优化! 一键快速安装 →
KubeSphere 安装

KubeSphere 部署支持部署在 Linux 和 Kubernetes 之上, 快速安装仅对单节点 Linux 部署和基于 Kubernetes 集群部署这两种方式进行简介,详细的安装文档请参考文档中心

All-in-One 单节点部署

All-in-One 支持一键快速部署至目标机器

在已有 K8s 部署 KubeSphere

KubeSphere 支持部署在已有 Kubernetes 集群上

All-in-One deployment

All-in-One 模式

对于首次接触 KubeSphere 的用户,想寻找一个最快安装和体验 KubeSphere 的方式,All-in-One 模式支持一键安装 KubeSphere 和 Kubernetes 至一台目标机器。

提示:

  • KubeSphere 2.1 已支持 自定义安装各个功能组件,默认仅开启最小化安装,用户可根据机器配置选择安装所需要的组件,参考 安装说明 开启可选组件的安装。
  • 若在云平台使用在线安装,可在安装前 配置镜像加速器,或通过调高带宽的方式来加快安装速度。

前提条件

建议关闭机器的防火墙,若未关闭防火墙则需要开放相关端口,参考 需开放的端口

第一步: 准备主机

  1. 本文将演示 All-in-One 安装,请准备一台干净的机器(虚拟机或物理机),安装前关闭防火墙,并确保您的机器符合以下的最小要求:
  • 机器配置:

    • CPU: 最小化安装需 2 Cores;完整安装需 8 Cores
    • Memory: 最小化安装需 4 GB;完整安装需 16 GB
  • 操作系统:

    • CentOS 7.4 ~ 7.7 (64-bit)
    • Ubuntu 16.04/18.04 LTS (64-bit)
    • RHEL 7.4 (64-bit)
    • Debian Stretch 9.5 (64-bit)

说明:

  • 若使用 ubuntu 16.04 建议使用其最新的版本 16.04.5;
  • 若使用 ubuntu 18.04,则需要使用 root 用户;
  • 若 Debian 系统未安装 sudo 命令,则需要在安装前使用 root 用户执行 apt update && apt install sudo 命令安装 sudo 命令后再进行安装。

第二步: 准备安装包

下载 KubeSphere 2.1.1 安装包至待安装机器,进入安装目录。

curl -L https://kubesphere.io/download/stable/v2.1.1 > installer.tar.gz \
&& tar -zxf installer.tar.gz && cd kubesphere-all-v2.1.1/scripts

注意: Installer 默认仅开启了最小化安装,若需要开启所有组件进行完整安装,请在 kubesphere-all-v2.1.1/conf/common.yaml 中将可选功能组件设置为 true,请参考 完整安装,或在最小化安装后再开启可插拔功能组件。

第三步: 安装 KubeSphere

注意:由于 Kubernetes 集群的 Cluster IP 子网网段默认是 10.233.0.0/18,Pod 的子网网段默认是 10.233.64.0/18,因此安装 KubeSphere 的节点 IP 地址范围不应与以上两个网段有重复,若遇到地址范围冲突可在配置文件 conf/vars.yaml 修改 kube_service_addresseskube_pods_subnet 的参数。

参考以下步骤开始 all-in-one 安装:

1. 建议使用 root 用户安装,执行 install.sh 脚本:

$ ./install.sh

2. 输入数字 1 选择第一种即 all-in-one 模式开始安装:

################################################
         KubeSphere Installer Menu
################################################
*   1) All-in-one
*   2) Multi-node
*   3) Quit
################################################
https://kubesphere.io/               2020-02-24
################################################
Please input an option: 1

3. 测试 KubeSphere 单节点安装是否成功:

(1) 待安装脚本执行完后,当看到如下 "Successful" 界面,则说明 KubeSphere 安装成功。

说明:安装时间跟网络情况和带宽、机器配置、安装节点个数等因素有关,已测试过的 all-in-one 模式,在网络良好的情况下以规格列表最小配置安装用时大约为 20 分钟。

successsful!
#####################################################
###              Welcome to KubeSphere!           ###
#####################################################

Console: http://192.168.0.8:30880
Account: admin
Password: [email protected]

NOTE:Please modify the default password after login.
#####################################################

提示:如需要再次查看以上的界面信息,可在安装包目录下执行 cat kubesphere/kubesphere_running 命令查看。

(2) 安装成功后,浏览器访问对应的 URL,如 http://{$IP}:30880,即可进入 KubeSphere 登录界面,可使用默认的用户名和密码登录 KubeSphere 控制台体验,登录后请立即修改默认密码。参阅 快速入门 帮助您快速上手 KubeSphere。

提示:若需要在外网访问,请配置防火墙的端口策略,确保外网流量可以通过 30880 端口。

注意:登陆 Console 后请在 "集群状态" 查看服务组件的监控状态,待所有组件启动完成后即可开始使用,通常所有服务组件都将在 10 分钟内启动完成。

若遇到安装问题需要协助支持,请在 社区论坛 搜索解决方法或发布帖子,社区会尽快跟踪解决。