KubeSphere教程FG002-KubeSphere在线安装与最小化部署实战

内容简介

本篇文章详细介绍KubeSphere的在线安装与最小化部署方法，帮助读者快速搭建KubeSphere环境。风哥教程参考KubeSphere官方文档安装指南相关内容，结合生产环境实战经验，为企业级Kubernetes平台的快速部署提供指导。

文章涵盖KubeSphere的在线安装流程、最小化部署配置、环境准备、安装验证等内容，旨在帮助读者掌握KubeSphere的快速部署技巧。

目录大纲

Part01-基础概念与理论知识
1.1 KubeSphere安装模式介绍
1.2 最小化部署概念与适用场景
1.3 在线安装与离线安装对比
Part02-生产环境规划与建议
2.1 系统硬件要求
2.2 网络环境要求
2.3 依赖项准备
Part03-生产环境项目实施方案
3.1 环境准备与配置
3.2 KubeKey工具安装
3.3 在线安装流程
Part04-生产案例与实战讲解
4.1 单节点最小化部署实战
4.2 多节点标准部署实战
4.3 安装验证与功能测试
Part05-风哥经验总结与分享
5.1 安装常见问题与解决方案
5.2 最小化部署最佳实践
5.3 后续扩展与升级建议

Part01-基础概念与理论知识

1.1 KubeSphere安装模式介绍

KubeSphere提供多种安装模式，包括：风哥提示：

在线安装：通过网络下载所需组件，适用于网络环境良好的场景
离线安装：使用离线包进行安装，适用于网络受限的环境
最小化部署：仅安装核心组件，减少资源占用
标准部署：安装全部组件，提供完整功能

1.2 最小化部署概念与适用场景

最小化部署是指仅安装KubeSphere的核心组件，包括：

KubeSphere控制台
多集群管理
基础认证授权
核心监控功能

适用场景：学习交流加群风哥微信: itpux-com

资源受限的环境，如测试环境或开发环境
只需要基础Kubernetes管理功能的场景
需要快速部署和验证KubeSphere功能的场景

1.3 在线安装与离线安装对比

特性	在线安装	离线安装
网络要求	需要互联网连接	无需互联网连接
安装速度	取决于网络速度	本地安装，速度较快
适用环境	网络环境良好的场景	网络受限或隔离环境
维护成本	较低，自动更新	较高，需要手动更新

Part02-生产环境规划与建议

2.1 系统硬件要求

最小化部署的硬件要求：

单节点部署：至少2核CPU，4GB内存，50GB磁盘空间
多节点部署：
- 控制节点：至少2核CPU，4GB内存，50GB磁盘空间
- 工作节点：至少2核CPU，4GB内存，50GB磁盘空间

2.2 网络环境要求

网络环境要求：

节点间网络互通，无防火墙限制
能够访问互联网（在线安装）
建议使用静态IP地址
网络延迟小于10ms

2.3 依赖项准备

安装KubeSphere前需要准备以下依赖项：学习交流加群风哥QQ113257174

Docker或containerd
Kubernetes集群（可通过KubeKey自动安装）
网络插件（如Calico、Flannel等）
存储插件（如CSI）

Part03-生产环境项目实施方案

3.1 环境准备与配置

在安装KubeSphere之前，需要做好以下准备工作：

# 检查系统版本
cat /etc/os-release
NAME="Oracle Linux Server"
VERSION="9.3"
ID="ol"
ID_LIKE="fedora"
VARIANT="Server"
VARIANT_ID="server"
VERSION_ID="9.3"
PLATFORM_ID="platform:el9"
PRETTY_NAME="Oracle Linux Server 9.3"
ANSI_COLOR="0;31"
CPE_NAME="cpe:/o:oracle:linux:9:3:server"
HOME_URL="https://linux.oracle.com/"
BUG_REPORT_URL="https://bugzilla.oracle.com/"

ORACLE_BUGZILLA_PRODUCT="Oracle Linux 9"
ORACLE_BUGZILLA_PRODUCT_VERSION=9.3
ORACLE_SUPPORT_PRODUCT="Oracle Linux"
ORACLE_SUPPORT_PRODUCT_VERSION=9.3

# 关闭防火墙
systemctl stop firewalld
systemctl disable firewalld
Removed /etc/systemd/system/multi-user.target.wants/firewalld.service.
Removed /etc/systemd/system/dbus-org.fedoraproject.FirewallD1.service.

# 关闭SELinux
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
setenforce 0
无输出

3.2 KubeKey工具安装

KubeKey是KubeSphere官方提供的安装工具，用于快速部署Kubernetes和KubeSphere：更多视频教程www.fgedu.net.cn

# 下载KubeKey
curl -sfL https://get-kk.kubesphere.io | VERSION=v3.0.8 sh -
Downloading kubekey-v3.0.8-linux-amd64.tar.gz ...
Download completed. Extracting kubekey-v3.0.8-linux-amd64.tar.gz ...
KubeKey v3.0.8 is downloaded successfully!

# 赋予执行权限
chmod +x kk
无输出

3.3 在线安装流程

使用KubeKey在线安装KubeSphere：

# 创建配置文件
./kk create config --with-kubesphere v4.2.0 --with-kubernetes v1.26.0
Generating KubeKey config file...
KubeKey config file "config-sample.yaml" generated successfully.

# 编辑配置文件
vi config-sample.yaml
# 编辑配置文件，设置节点信息和安装参数

Part04-生产案例与实战讲解

4.1 单节点最小化部署实战

单节点最小化部署步骤：

# 单节点部署
./kk create cluster -f config-sample.yaml --with-kubesphere v4.2.0 --with-minimal
[2026-04-10 11:00:00] [INFO]  Creating cluster...
[2026-04-10 11:00:05] [INFO]  Installing kubernetes...
[2026-04-10 11:05:00] [INFO]  Installing kubesphere...
[2026-04-10 11:10:00] [INFO]  Cluster created successfully!

# 检查集群状态
kubectl get nodes
NAME             STATUS   ROLES                  AGE   VERSION
fgedu-master-01  Ready    control-plane,master   30m   v1.26.0

4.2 多节点标准部署实战

多节点标准部署步骤：更多学习教程公众号风哥教程itpux_com

# 多节点部署
./kk create cluster -f config-sample.yaml --with-kubesphere v4.2.0
[2026-04-10 12:00:00] [INFO]  Creating cluster...
[2026-04-10 12:00:05] [INFO]  Installing kubernetes...
[2026-04-10 12:15:00] [INFO]  Installing kubesphere...
[2026-04-10 12:30:00] [INFO]  Cluster created successfully!

# 检查集群状态
kubectl get nodes
NAME             STATUS   ROLES                  AGE   VERSION
fgedu-master-01  Ready    control-plane,master   1h    v1.26.0
fgedu-worker-01  Ready    worker                 1h    v1.26.0
fgedu-worker-02  Ready    worker                 1h    v1.26.0

4.3 安装验证与功能测试

验证KubeSphere安装是否成功： from K8S+DB视频:www.itpux.com

# 检查KubeSphere组件状态
kubectl get pods -n kubesphere-system
NAME                                      READY   STATUS    RESTARTS   AGE
ks-console-6f7d4997d8-5k8z8               1/1     Running   0          1h
ks-controller-manager-7d9f56c46c-8f42d    1/1     Running   0          1h
ks-installer-6c79b5f7c4-9t2k9             1/1     Running   0          1h
openldap-0                                1/1     Running   0          1h
redis-master-0                            1/1     Running   0          1h

# 查看KubeSphere控制台访问地址
kubectl get svc -n kubesphere-system ks-console
NAME         TYPE       CLUSTER-IP     EXTERNAL-IP   PORT(S)        AGE
ks-console   NodePort   10.233.44.18           30880:30880/TCP   1h

Part05-风哥经验总结与分享

5.1 安装常见问题与解决方案

网络连接问题：确保节点间网络互通，检查防火墙设置
依赖项缺失：确保所有依赖项已正确安装
资源不足：确保节点资源满足最低要求
权限问题：确保使用root用户或具有sudo权限的用户执行安装

5.2 最小化部署最佳实践

资源规划：根据实际需求规划节点资源，避免资源浪费
网络配置：使用高性能网络，确保集群通信效率
存储配置：使用SSD存储，提高IO性能
监控配置：配置基础监控，及时发现问题

5.3 后续扩展与升级建议

功能扩展：根据业务需求逐步启用其他功能模块
版本升级：定期升级KubeSphere版本，获取新功能和安全补丁
集群扩容：根据业务增长需求，适时扩容集群
备份策略：定期备份集群配置和数据

在进行KubeSphere安装时，建议先阅读官方文档，了解安装要求和注意事项，避免出现不必要的问题。

本文由风哥教程整理发布,仅用于学习测试使用,转载注明出处:http://www.fgedu.net.cn/10327.html