12. 部署kubesphere管理面板(推荐)

# 一、kubesphere介绍

KubeSphere 提供了运维友好的向导式操作界面，帮助企业快速构建一个强大和功能丰富的容器云平台。KubeSphere 为用户提供构建企业级 Kubernetes 环境所需的多项功能，例如多云与多集群管理、Kubernetes 资源管理、DevOps、应用生命周期管理、微服务治理（服务网格）、日志查询与收集、服务与网络、多租户管理、监控告警、事件与审计查询、存储管理、访问权限控制、GPU 支持、网络策略、镜像仓库管理以及安全管理等

kubesphere官方中文文档： https://www.kubesphere.io/zh/docs

# 二、配置预置条件

在已有的k8s集群中安装kubesphere时，需在安装前满足两个前置条件

详见：https://www.kubesphere.io/zh/docs/v3.4/installing-on-kubernetes/introduction/prerequisites/

## 条件一

**要求安装的kubesphere需与kubernetes版本对应**

>如需在 Kubernetes 上安装 KubeSphere 3.4，您的 Kubernetes 版本必须为：
**v1.20.x、v1.21.x、v1.22.x、v1.23.x、\*v1.24.x、\*v1.25.x 和 \*v1.26.x**
⚠️说明：带星号的版本可能出现边缘节点部分功能不可用的情况。因此，如需使用边缘节点，推荐安装 v1.23.x。

示例安装版本为kubesphere的v3.4，要求k8s的版本v1.20.x~v1.26.x之间

**1查看当前k8s版本**

```
kubectl version --output yaml
# 或使用如下命令查询
kubectl version --output yaml
```

![](/media/202407/2024-07-11_124408_3238200.4881794320688624.png)

## 条件二

>Kubernetes 集群已配置默认 StorageClass（请使用 `kubectl get sc` 进行确认）

查看集群中以有的StorageClass
```
kubectl get sc
```

![](/media/202407/2024-07-11_124741_0781040.7855615353400326.png)

如没有 StorageClass的默认资源，可通过如下过程创建StorageClass，并将其设为默认的StorageClass

```
tee >local-storage-class.yaml<<EOF
# 创建存储类
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: local-storage
  annotations:
    storageclass.kubernetes.io/is-default-class: "true" # 设置为默认存储类
provisioner: kubernetes.io/no-provisioner
volumeBindingMode: WaitForFirstConsumer # 等到有第一个使用者再绑定到pv
EOF
```

创建StorageClass资源
```
kubectl apply -f local-storage-class.yaml
```

再次查看StorageClass
```
kubectl get sc
```

![](/media/202407/2024-07-11_125401_9511750.5935331369534413.png)

验证StorageClass已完成创建，并已设置为默认存储类
>说明: 当前创建的storageclass可以成功安装kubesphere，但是local-storage配合pvc无法动态创建pv。因此，创建storageclass建议使用nfs-storageclass ，详见 [<创建nfs存储类>](/doc/478/ "创建nfs存储类")

----

>⚠️注意：
如已安装并卸载过或者循环安装卸载过,则需要使用官方删除脚本实现彻底卸载后才能再次安装
否则将出现如下安装的情况
![](/media/202407/2024-07-31_152254_8095220.6912836240182763.png)

脚本下载：
```
https://raw.githubusercontent.com/kubesphere/\
ks-installer/master/scripts/kubesphere-delete.sh
```

# 三、安装kubesphere

至此，kubesphere的安装前置条件已经满足，可以进行kubesphere安装

安装概述: https://www.kubesphere.io/zh/docs/v3.4/installing-on-kubernetes/introduction/overview/

执行以下命令以开始安装
```
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.4.0/kubesphere-installer.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.4.0/cluster-configuration.yaml
```

检查安装日志：
```
kubectl logs -f -n kubesphere-system $(kubectl get pod -n kubesphere-system -l \
'app in (ks-install, ks-installer)' -o jsonpath='{.items[0].metadata.name}')
```

![](/media/202407/2024-07-11_130922_7451860.462060114245021.png)

使用 `kubectl get pod -n kubesphere-system` 查看所有与 KubeSphere 相关的 Pod 是否正常运行。如果在正常运行

请通过以下命令来检查控制台的端口（默认为 30880）：
```
kubectl get svc/ks-console -n kubesphere-system
```

确保在安全组中打开了 30880 端口，并通过如下方式访问 Web 控制台。

>NodePort地址： http://{YOUR_IP}:30880
默认帐户: admin
默认密码: P@88w0rd

>⚠️注意：如需在主节点安装kubesphere，还需添加相应容忍以允许pod在主节点调度

# 四、配置Ingress访问(可选)

新增ingress资源配置，实现通过指定域名访问kubesphere

编写ingress配置文件，指定使用kubesphere.local.com域名访问平台
```
tee > kubesphere-ingress.yaml <<EOF
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: kubesphere-ingress
  namespace: kubesphere-system # 指定ingress的工作所属命名空间
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /

spec:
  ingressClassName: nginx
  rules:
    - host: kubesphere.local.com # 指定访问域名
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: ks-console # 指定后端服务
                port:
                  number: 80    # 指定后端service端口,Ingress 控制器会尝试通过服务的
                                # ClusterIP 端口来路由流量,而不是通过 NodePort
EOF
```

通过配置文件创建ingress资源
```
kubectl apply -f kubesphere-ingress.yaml
```

查看ingress详情

![](/media/202407/2024-07-11_140252_3269670.36349746550352335.png)

访问验证
>**注意⚠️：** 需要在客户端机器配置好对应域名映射关系
> 例如:
> 11.1.1.133 kubesphere.local.com

客户端浏览器访问 http://kubesphere.local.com 即可访问

![](/media/202407/2024-07-11_140626_8248640.525583930882847.png)

至此kubesphere已完成安装