KubeSphere教程FG003-KubeSphere离线安装包制作与内网部署实战

内容简介

本篇文章详细介绍KubeSphere的离线安装包制作与内网部署方法，帮助读者在网络受限环境中部署KubeSphere。风哥教程参考KubeSphere官方文档离线安装指南相关内容，结合生产环境实战经验，为企业级Kubernetes平台的离线部署提供指导。

文章涵盖KubeSphere离线安装包的制作流程、内网环境准备、离线部署步骤、验证方法等内容，旨在帮助读者掌握KubeSphere的离线部署技巧。

目录大纲

Part01-基础概念与理论知识
1.1 离线安装包概念与适用场景
1.2 离线安装包组成结构
1.3 离线部署与在线部署对比
Part02-生产环境规划与建议
2.1 系统硬件要求
2.2 内网环境准备
2.3 存储与网络规划
Part03-生产环境项目实施方案
3.1 离线安装包制作准备
3.2 离线安装包制作流程
3.3 内网部署步骤
Part04-生产案例与实战讲解
4.1 离线安装包制作实战
4.2 内网环境部署实战
4.3 部署验证与功能测试
Part05-风哥经验总结与分享
5.1 离线安装常见问题与解决方案
5.2 离线部署最佳实践
5.3 离线环境维护与升级建议

Part01-基础概念与理论知识

1.1 离线安装包概念与适用场景

离线安装包是指包含KubeSphere及其依赖组件的完整安装包，可以在没有互联网连接的环境中使用。适用场景包括：风哥提示：

网络隔离的企业内网环境
网络带宽有限的环境
需要严格控制软件版本的环境
安全要求较高的生产环境

1.2 离线安装包组成结构

KubeSphere离线安装包主要包含以下内容：

Kubernetes相关镜像
KubeSphere核心组件镜像
依赖的第三方组件镜像
安装脚本和配置文件
KubeKey工具

1.3 离线部署与在线部署对比

特性	离线部署	在线部署
网络要求	无需互联网连接	需要互联网连接
安装速度	本地安装，速度较快	取决于网络速度
版本控制	完全可控	依赖在线仓库版本
维护成本	较高，需要手动更新	较低，自动更新
适用环境	网络隔离环境	网络环境良好的场景

Part02-生产环境规划与建议

2.1 系统硬件要求

离线部署的硬件要求与在线部署相同：学习交流加群风哥微信: itpux-com

控制节点：至少4核CPU，8GB内存，50GB磁盘空间
工作节点：至少2核CPU，4GB内存，50GB磁盘空间
存储：建议使用SSD存储，确保IO性能
网络：建议使用10Gbps网络，确保集群通信效率

2.2 内网环境准备

内网环境准备：

确保内网节点间网络互通
配置内网DNS服务器（可选）
准备内网镜像仓库（如Harbor）
确保内网存储系统可用

2.3 存储与网络规划

存储与网络规划：学习交流加群风哥QQ113257174

存储规划：
- 为离线安装包准备足够的存储空间（至少100GB）
- 为Kubernetes集群准备持久化存储
- 配置存储类（StorageClass）
网络规划：
- 配置节点间网络通信
- 配置Pod网络CIDR
- 配置服务网络CIDR

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

3.1 离线安装包制作准备

在制作离线安装包之前，需要准备以下环境：

一台可以访问互联网的服务器
足够的磁盘空间（至少100GB）
Docker环境
KubeKey工具

3.2 离线安装包制作流程

使用KubeKey制作离线安装包的流程：

# 下载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
无输出

# 制作离线安装包
./kk artifact create --output kubesphere-offline.tar.gz --with-kubesphere v4.2.0 --with-kubernetes v1.26.0
[2026-04-10 13:00:00] [INFO]  Downloading kubernetes images...
[2026-04-10 13:30:00] [INFO]  Downloading kubesphere images...
[2026-04-10 14:00:00] [INFO]  Creating offline artifact...
[2026-04-10 14:10:00] [INFO]  Offline artifact created successfully: kubesphere-offline.tar.gz

3.3 内网部署步骤

在内网环境中部署KubeSphere的步骤：更多视频教程www.fgedu.net.cn

将离线安装包传输到内网服务器

解压离线安装包

配置集群配置文件

执行安装命令

验证安装结果

Part04-生产案例与实战讲解

4.1 离线安装包制作实战

制作KubeSphere离线安装包：

# 查看离线安装包大小
ls -lh kubesphere-offline.tar.gz
-rw-r--r-- 1 root root 85G Apr 10 14:10 kubesphere-offline.tar.gz

# 检查离线安装包内容
tar -tzf kubesphere-offline.tar.gz | head -20
kubesphere-offline/
kubesphere-offline/images/
kubesphere-offline/images/kubernetes/
kubesphere-offline/images/kubesphere/
kubesphere-offline/images/others/
kubesphere-offline/kk
kubesphere-offline/kubectl
kubesphere-offline/ks-installer.yaml
kubesphere-offline/README.md

4.2 内网环境部署实战

在内网环境中部署KubeSphere：更多学习教程公众号风哥教程itpux_com

# 解压离线安装包
tar -xzf kubesphere-offline.tar.gz
无输出

# 创建集群配置文件
cd kubesphere-offline
./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
# 编辑配置文件，设置节点信息

# 执行离线部署
./kk create cluster -f config-sample.yaml --with-offline kubesphere-offline
[2026-04-10 15:00:00] [INFO]  Creating cluster...
[2026-04-10 15:00:05] [INFO]  Loading offline images...
[2026-04-10 15:30:00] [INFO]  Installing kubernetes...
[2026-04-10 16:00:00] [INFO]  Installing kubesphere...
[2026-04-10 16:30:00] [INFO]  Cluster created successfully!

4.3 部署验证与功能测试

验证KubeSphere离线部署是否成功： from K8S+DB视频:www.itpux.com

# 检查集群状态
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

# 检查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 离线安装常见问题与解决方案

磁盘空间不足：确保制作离线安装包的服务器有足够的磁盘空间
镜像加载失败：检查Docker服务是否正常运行，磁盘空间是否充足
网络配置问题：确保内网节点间网络互通，检查网络配置
权限问题：确保使用root用户或具有sudo权限的用户执行安装

5.2 离线部署最佳实践

提前规划：在部署前充分规划集群规模和资源需求
测试验证：在正式部署前，在测试环境验证离线安装包
镜像管理：建立内网镜像仓库，方便后续的镜像管理和更新
文档记录：详细记录离线部署的步骤和配置，便于后续维护

5.3 离线环境维护与升级建议

定期更新：定期更新离线安装包，获取最新的安全补丁和功能
备份策略：定期备份集群配置和数据，确保数据安全
监控配置：配置完善的监控系统，及时发现和解决问题
灾备方案：制定详细的灾备方案，确保集群高可用性

在制作离线安装包时，建议在网络良好的环境中进行，确保所有镜像能够正确下载。

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