搭建开发环境

搭建开发环境，需要安装 KubeSphere 和扩展组件开发所需的开发工具。

  • KubeSphere：准备 K8s 集群并部署 KubeSphere，为扩展组件提供基础的运行环境。
  • 开发工具：安装 create-ks-project 和 ksbuilder 用于初始化扩展组件项目、打包和发布扩展组件，你也可能需要用到以下开发工具 Node.js、Helm、kubectl 等。

@ks-console/* 依赖已经迁移到私有 npm 仓库 https://registry.npm.kubesphere.com.cn，请通过 kubesphere@yunify.com 申请用户名，并按照自建 npm 仓库说明 配置 .npmrc，否则 yarn install 可能会因为 https://www.npmjs.com 不再提供这些包而失败。

安装 KubeSphere

  1. 准备 Kubernetes 集群

    KubeSphere 在任何 Kubernetes 集群上均可安装。可以使用 KubeKey 快速部署 K8s 集群。

    curl -sfL https://get-kk.kubesphere.io | sh -
./kk create cluster --with-local-storage  --with-kubernetes v1.31.0 --container-manager containerd  -y

    在 K8s 集群中安装 Helm。

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

  2. 安装 KubeSphere

    chart=oci://hub.kubesphere.com.cn/kse/ks-core
version=1.2.2
helm upgrade --install -n kubesphere-system --create-namespace ks-core $chart --debug --wait --version $version --set apiserver.nodePort=30881 --reset-values

    更多内容，请参考在线安装 Kubernetes 和 KubeSphere。

  3. 激活 KubeSphere

    申请 KubeSphere 社区版的免费许可，导入 License 后完成激活。

安装开发工具

除了 K8s 和 KubeSphere Luban 的环境搭建，开发主机上需要用到以下工具。

  1. 安装开发扩展组件所需的开发工具

    • Node.js 和 Yarn 用于扩展组件的前端开发：安装 Node.js v16.17+ 和 Yarn v1.22+。
    • Helm 和 kubectl 用于扩展组件的编排和 K8s 集群管理：安装 Helm v3.8+ 和 kubectl v1.23+。
    • ksbuilder 用于扩展组件的打包与发布：下载 ksbuilder 并保存到可执行文件目录。

  2. 配置开发环境

    复制 K8s 集群的 kubeconfig 配置文件到开发主机上，确保使用 kubectl 可以正常访问 K8s 集群。

    ➜  ~ kubectl -n kubesphere-system get po
NAME                                     READY   STATUS    RESTARTS       AGE
ks-apiserver-7c67b4577b-tqqmd            1/1     Running   0              10d
ks-console-7ffb5954d8-qr8tx              1/1     Running   0              10d
ks-controller-manager-758dc948f5-8n4ll   1/1     Running   0              10d