服务器集群使用说明

一、服务器集群架构说明

1.集群的创建

2026年2月14日,团队成员CN059购买了一台8核心8GB的香港VPS服务器,并将其作为TATEN的云服务器使用.随后几天,CN059又购买了数台美国的高速VPS,并开始了TATEN云计算服务器集群的搭建进程.

集群采用了Monitor探针监控系统来对整个集群的服务器实时性能进行监控,可以通过监控系统的仪表盘查看每台服务器的CPU、内存、网络等性能指标,以便对服务器的运行状态进行统一的查看和管理.

2026年2月19-21日,XinHallow和CN059在香港一服务器上部署了kubernetes的master节点,并将美国一、美国二、美国三共三台服务器作为worker节点加入了kubernetes集群中.

随后购置了美国四节点,我们将美国四节点作为第二个master节点加入集群中.

2.集群的架构

集群共有五台服务器,分别是一台香港服务器和四台美国服务器.香港一服务器和美国四服务器是控制平面的master节点,美国一服务器是整个集群的nfs服务器,负责集群的持久化存储.通过 PersistentVolume（PV） 和 PersistentVolumeClaim（PVC） 机制将 NFS 存储抽象为 Kubernetes 资源

3.集群的详细组件

集群的CNI采用cilium,Ingress采用cilium的gateway功能,使用coreDNS作为DNS服务器,使用动态PVC作为持久化存储方案.

二、如何使用集群部署自己的服务

1.准备连接配置文件

你需要下载kubectl工具，以实现集群的连接.你可以查看kubectl安装指南来获取安装kubectl的详细步骤.

设置好后,将集群连接配置的config文件放置在默认位置（~/.kube/config）,集群的config连接配置文件可以向集群管理员申请获取.

2.验证连接

打开终端，输入以下命令来验证你是否成功连接到了集群：

kubectl get nodes

出现这样的输出代表连接成功：

cn059@cn059-2 Projects % kubectl get nodes
NAME STATUS ROLES AGE VERSION
hd-server Ready worker 4h26m v1.35.1
hka-k8s-server Ready control-plane 47h v1.35.1
lhka-k8s-worker Ready worker 98m v1.35.1
usa-k8s-worker Ready storage 43h v1.35.1
usc-k8s-worker Ready worker 46h v1.35.1
usd-k8s-master Ready control-plane 33h v1.35.1
use-k8s-worker Ready database 12h v1.35.1

3.编写自己的服务的配置文件

我们将采用更加完善的集群管理模式,做到一切配置都可追溯,不过目前服务器还没有部署CI/CD流水线,所以目前只能通过手动部署的方式来完成服务部署.

不过要注意的是,我们的yaml配置文件都需要写好,验证后才可以部署.

使用Git从GitHub仓库中拉取gitops仓库，这个仓库是我们的GitOps仓库，里面计划存放所有集群的配置文件，以及CI/CD流水线。截止目前,仍有很多的配置信息没有迁移,我们将尽快完成迁移工作.

apiVersion: v1
kind: Namespace
metadata:
  name: astrbot

如上述配置所示，我们创建了两个命名空间部署astrbot和napcat搭建QQ机器人.

你也可以在目录下新建文件夹编写自己的服务的配置文件,在编写配置文件之前,请提前学习kubernetes的集群架构和配置文件编写方法

你可以去互联网搜索kubernetes的相关教程进行学习,这里不再赘述.

4.部署服务

当你编写好配置文件后,可以使用kubectl apply命令来部署服务:

kubectl apply -f your-service-config.yaml

逐个运行命令,并及时查看对应yaml文件的运行结果,提前发现并解决问题