All-in-One 模式

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

  • KubeSphere 2.1 默认仅开启最小化安装,Installer 已支持自定义安装各个可插拔的功能组件,用户可根据业务需求和机器配置选择安装所需的组件,请确保开启可插拔组件之前机器资源满足最低要求,参考 安装说明 开启可选组件的安装。
  • 若您的机器资源配置充足(CPU 不小于 8 核,内存不小于 16 G),非常建议您在安装前 将 KubeSphere 所有功能组件都开启 后再执行安装,体验 KubeSphere 容器平台端到端完整的容器管理与运维能力。
  • 安装时间跟网络情况和带宽、机器配置、安装节点个数等因素有关,可通过调高带宽的方式,或在安装前 配置镜像加速器 来加快安装速度。

视频教程

视频教程以 QingCloud 云平台创建机器用作安装示例,其它平台安装步骤类似,具体以其官方文档为准。注意,视频中的演示的是下载 v2.1.0,请参考以下文档替换使用 v2.1.1 的下载命令。

前提条件

检查安装机器的网络防火墙是否已关闭,若未关闭防火墙则需要开放相关的指定端口,参考 需开放的端口

第一步: 准备主机

您可以参考以下节点规格准备一台符合要求的主机节点开始 all-in-one 模式的安装,为防止软件版本冲突,建议您选择一台干净的机器

说明:

  • 若使用 ubuntu 16.04 建议使用其最新的版本 16.04.5;
  • 若使用 ubuntu 18.04,则需要使用 root 用户;
  • 若 Debian 系统未安装 sudo 命令,则需要在安装前使用 root 用户执行 apt update && apt install sudo 命令安装 sudo 命令后再进行安装。
操作系统最小配置
CentOS 7.5 (64 bit)CPU:2 核, 内存:4 G, 系统盘:100 G
Ubuntu 16.04/18.04 LTS (64 bit)CPU:2 核, 内存:4 G, 系统盘:100 G
Red Hat Enterprise Linux Server 7.4 (64 bit)CPU:2 核, 内存:4 G, 系统盘:100 G
Debian Stretch 9.5 (64 bit)CPU:2 核, 内存:4 G, 系统盘:100 G

第二步: 准备安装包

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

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

第三步: 安装 KubeSphere

KubeSphere 安装过程中将会自动化地进行环境和文件监测、平台依赖软件的安装、Kubernetes(默认 v1.16.7)和 etcd 的自动化安装,以及存储的自动化配置,安装成功后可通过 KubeSphere 控制台右上角点击关于查看安装的版本。

说明:

  • 通常情况您不需要修改任何配置,直接安装即可。
  • 网络插件默认是 calico,若您需要自定义安装参数,如网络、存储、负载均衡器插件、可选组件等相关配置需在 conf/common.yaml 文件中指定或修改,参考 集群组件配置说明
  • 存储默认用 OpenEBS 基于 Local Volume 提供持久化存储服务,OpenEBS 支持 动态申请 PV,方便初次安装但没有准备存储服务端的场景下进行部署测试,即本地存储设备作为存储类型。
  • 支持存储类型与存储配置相关的详细信息请参考 存储配置说明
  • 由于 Kubernetes 集群的 Cluster IP 子网网段默认是 10.233.0.0/18,Pod 的子网网段默认是 10.233.64.0/18,因此安装 KubeSphere 的节点 IP 地址范围不应与以上两个网段有重复,若遇到地址范围冲突可在配置文件 conf/common.yaml 修改 kube_service_addresseskube_pods_subnet 的参数。

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

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

  1. ./install.sh

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

  1. ################################################
  2. KubeSphere Installer Menu
  3. ################################################
  4. * 1) All-in-one
  5. * 2) Multi-node
  6. * 3) Quit
  7. ################################################
  8. https://kubesphere.io/ 2020-02-23
  9. ################################################
  10. Please input an option: 1

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

(1) 待安装脚本执行完后,请耐心等待,当看到如下 "Successful" 的日志,则说明 KubeSphere 安装成功。

  1. #####################################################
  2. ### Welcome to KubeSphere! ###
  3. #####################################################
  4. Console: http://192.168.0.8:30880
  5. Account: admin
  6. Password: P@88w0rd
  7. NOTEPlease modify the default password after login.
  8. #####################################################

提示:如需要再次查看以上的界面信息,可参考 验证安装 的查看安装日志命令。

(2) 若需要在外网访问,在云平台可能需要在端口转发规则中将 内网端口 30880 转发到 源端口 30880,然后在防火墙开放这个 源端口,确保外网流量可以通过该端口。

例如在 QingCloud 平台配置端口转发和防火墙规则,则可以参考 云平台配置端口转发和防火墙

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

All-in-One 模式 - 图1

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

All-in-One 模式 - 图2

FAQ

KubeSphere 已在阿里云、腾讯云、华为云、青云、AWS 上进行过部署测试,测试结果与相关的解决方法,请参考 KubeSphere 云平台安装测试结果。另外,常见的安装问题我们也已整理相关的解决方法在 安装常见问题

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