安装搭建KubeSphere环境&&Kubernetes环境

原创

已于 2025-07-09 21:25:50 修改 · 1.5k 阅读

于 2025-07-09 21:15:40 首次发布

Kubesphere概述

Kubernetes的默认dashboard功能有限，Kubesphere集成了很多套件，功能强大，但是集群要求较高

KubeSphere是一款开源项目，在目前主流容器调度平台Kukernetes之上构建的企业级分布式多租户容器管理平台，提供简单易用的操作界面以及向导式操作方式，在降低用户使用容器调度平台学习成本的同时，极大降低开发调试、测试、运维的日常工作的复杂度

KubeShpere官网：https://kubesphere.io/

文档地址：https://kubersphere.io/zh/docs/v3.3/introduction/what-is-kubesphere/

文档地址：https://v2-1.docs.kubesphere.io/docs/zh-CN/introduction/what-is-kubeshpere/

Kubesphere最大的优点就是可以自定义安装可拔插的功能组件，并且所有组件都是开源免费的

kuboard也不错，集群要求不高

Kuboard下载地址：https://kuboard.cn/support/

Kuboard是一款免费的Kubernetes管理工具，提供了丰富的功能，结合已有或新建的代码仓库、镜像仓库、CI/CD工具等，可以便捷的搭建一个生产可用的Kubernetes容器云平台，轻松管理和运行云原生应用，您也可以直接将Kuboard安装到现有的Kubernetes集群，通过Kuboard提供的Kubernetes RBAC管理界面，将Kubernetes提供的能力开放给您的开发测试团队

安装方式

kubesphere具有如下可选安装选项

All-in-One：在单个节点上安装 KubeSphere（仅为让用户快速熟悉 KubeSphere）。

多节点安装：在多个节点上安装 KubeSphere（用于测试或开发）。

在 Linux 上离线安装：将 KubeSphere 的所有镜像打包（便于在 Linux 上进行离线安装）。

高可用安装：安装具有多个节点的高可用 KubeSphere 集群，该集群用于生产环境。

最小化安装：仅安装 KubeSphere 所需的最少系统组件。以下是最低资源要求：
2 个 CPU
4 GB 运行内存
40 GB 存储空间

全家桶安装：安装 KubeSphere 的所有可用系统组件，例如 DevOps、服务网格、告警等。

这里使用All-in-One安装模式，仅需准备一台主机，官方文档写的很详细，照着来就行，这里就纯粹记录个人开发过程，踩坑过程

环境准备

硬件推荐 2核CPU，4GB内存，40GB磁盘空间 节点要求 节点必须能通过SSH连接

节点上可以使用sudo/curl/openssl/tar命令

可用的容器

集群必须有一个可用的容器运行，如果使用KubeKey搭建集群，KubeKey会默认安装最新版本的Docker，或者可以创建集群前手动安装Docker或其他容器

依赖项要求

Kubesphere可以将Kubernetes和KubeSphere一同安装，针对不同的Kubernetes版本，需要安装的依赖项可能有所不同

可以参考以下列表，查看是否需要提前在节点上安装相关的依赖项。

安装依赖

yum install -y socat conntrack ebtables ipset

安装Kubesphere

下载KubeKey

确保从正确的区域下载KubeKey

export KKZONE=cn

下载KubeKey

#可以修改命令中的版本号下载指定版本
curl -sfL https://get-kk.kubesphere.io | VERSION=2.2.1 sh -

为kk添加可执行权限

chmod +x kk

[root@administrator ~]# export KKZONE=cn

[root@administrator ~]# curl -sfL https://get-kk.kubesphere.io | VERSION=v2.2.1 sh -

Downloading kubekey v2.2.1 from https://kubernetes.pek3b.qingstor.com/kubekey/releases/download/v2.2.1/kubekey-v2.2.1-linux-amd64.tar.gz ...


Kubekey v2.2.1 Download Complete!

[root@administrator ~]# ls
 kk        
[root@administrator ~]# chmod +x kk

开始安装 首先需要创建一个配置文件，命令如下

kubeadm config print init-defaults > /etc/kubernetes/kubeadm-config.yaml

然后修改配置文件内容，如下模板，可以直接复制粘贴

apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration
certificatesDir: /etc/kubernetes/pki
clusterName: kubernetes
controlPlaneEndpoint: 192.168.1.10:6443  # 请替换为实际控制平面节点的IP或主机名
apiServer:
  extraArgs:
    authorization-mode: Node,RBAC
  timeoutForControlPlane: 4m0s
controllerManager: {}
dns: {}
etcd:
  local:
    dataDir: /var/lib/etcd
imageRepository: registry.cn-hangzhou.aliyuncs.com/google_containers
kubernetesVersion: v1.23.17
networking:
  dnsDomain: cluster.local
  podSubnet: 172.20.0.0/16
  serviceSubnet: 10.96.0.0/12
scheduler: {}

配置文件修改之后需要导入密钥

sudo kubeadm init phase upload-certs --upload-certs --config /etc/kubernetes/kubeadm-config.yaml

导入密钥成功后就可以安装进行安装了

只需执行一个命令即可安装，其模板如下，ai了一下，原来通过这一个命令就可以安装好k8s集群和可视化平台，但是基本环境还是需要注意的，容易出问题的基本换进就是docker源、交换分区swap、docker驱动要改为systemd

环境配置参考文章：

微信公众号文章
https://mp.weixin.qq.com/s/2FDec7lOXHjDNWDSKulo5Q
CSDN文章
https://blog.csdn.net/chinese_cabbage0/article/details/149203811

是的，通过执行 ./kk create cluster --with-kubernetes v1.23.17 --with-kubesphere v3.0.0 命令，你可以在一个空环境中一键安装 Kubernetes 集群和 KubeSphere 可视化平台。

#获取k8s的版本
kubectl version --short

./kk create cluster [--with-kubernetes version] [--with-kubesphere version]

若要同时安装Kubernetes和KubeSphere，参考以下示例命令

./kk create cluster --with-kubernetes v1.22.10 --with-kubesphere v3.3.0

执行该命令后，KubeKey将检查安装环境，结果显示在一张表格中。输入yes继续安装流程。

[root@administrator ~]# chmod +x kk
[root@administrator ~]# ./kk create cluster --with-kubernetes v1.22.10 --with-kubesphere v3.3.0
WARN[0000] Failed to decode the keys ["storage.options.override_kernel_check"] from

标签