kubesphere部署手册(helm版本)

使用 Helm 部署 KubeSphere

1.准备工作

1.1 系统要求

• Kubernetes 集群版本：1.19.x+
• 节点资源：至少 8 CPU 核和 16GB 内存

1.2 安装 Helm 3

在开始部署之前，需要确保已经安装了 Helm。如果尚未安装，可以通过以下命令安装：

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

2. 配置文件 (kubesphere-values.yaml)

在部署之前，需要准备一个 Helm 配置文件（kubesphere-values.yaml），用于自定义 KubeSphere 的配置。以下是一个示例配置文件的内容：

global:
  imageRegistry: swr.cn-southwest-2.myhuaweicloud.com/ks  # 镜像仓库地址
  tag: v4.1.3                                             # KubeSphere 版本
  imagePullSecrets: []                                    # 私有仓库凭证

# 多集群配置
multicluster:
  role: ""                                                # host/member 角色
  hostClusterName: "k8s-test"                             # 主集群名称

# 访问配置
portal:
  hostname: "k8sui.xxx.com"                            # 访问域名

# Ingress 配置
ingress:
  enabled: true                                           # 启用 Ingress
  ingressClassName: "nginx"                               # Ingress 控制器类型
  tls:
    enabled: false                                        # 是否启用 TLS
    source: generation                                    # 证书来源
    secretName: kubesphere-tls-certs                      # TLS 证书 Secret

# 控制台配置
console:
  nodePort: 30880                                          # NodePort 端口（设为null，service按ClusterIP模式部署）

# 扩展镜像仓库
extension:
  imageRegistry: "swr.cn-southwest-2.myhuaweicloud.com/ks"

# 高可用配置
ha:
  enabled: true                                           # 是否启用高可用

# Redis 配置
redis:
  port: 6379
  image:
    registry: ""
    repository: kubesphere/redis
    tag: 7.2.4-alpine
    pullPolicy: IfNotPresent
  persistentVolume:
    enabled: true                                         # 是否持久化
    size: 5Gi                                            # 存储大小

3.部署 KubeSphere

3.1 添加 Helm 仓库

helm repo add kubesphere https://charts.kubesphere.com.cn/main
helm repo update

3.2 执行部署

helm upgrade --install ks-core kubesphere/ks-core \
  --version 1.1.5 \
  -n kubesphere-system \
  --create-namespace \
  -f kubesphere-values.yaml \
  --debug \
  --wait

3.3 验证安装

# 查看 Pod 状态
kubectl get pods -n kubesphere-system -w

# 查看安装日志
kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f

4. 访问 KubeSphere

4.1 访问方式

• Ingress 访问：https://k8sui.xxx.com

• NodePort 访问：http://:

默认管理员账号：

• 用户名：admin
• 密码：P@88w0rd

5. 卸载 KubeSphere

helm uninstall ks-core -n kubesphere-system
kubectl delete ns kubesphere-system