Spica-Engine 核心组件 Kubernetes 部署架构深度解析
2025-07-05 22:14:29作者:庞队千Virginia
概述
Spica-Engine 是一个基于 Kubernetes 的现代应用引擎,其部署架构体现了云原生应用的最佳实践。本文将深入分析其核心组件的部署配置,帮助开发者理解 Spica-Engine 的技术架构和部署策略。
核心组件架构
Spica-Engine 采用微服务架构设计,主要包含以下核心组件:
- MongoDB 数据库服务
- Spica 前端服务
- Spica API 服务
- 入口网关(Ingress)
- MongoDB 复制控制器
这些组件通过 Kubernetes StatefulSet、Service 和 Ingress 等资源协同工作,构建了一个高可用、可扩展的应用引擎平台。
数据库层部署
MongoDB StatefulSet
Spica-Engine 使用 StatefulSet 部署 MongoDB,这是有状态应用的理想选择:
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: database
spec:
serviceName: mongo
replicas: 1
template:
spec:
containers:
- name: mongo
image: mongo:7.0.16
command:
- mongod
- "--replSet"
- rs0
- "--bind_ip_all"
关键配置解析:
- 使用 MongoDB 7.0.16 官方镜像
- 配置为副本集模式(rs0),为未来扩展做准备
- 绑定所有网络接口(--bind_ip_all)
- 通过 PVC 提供 1GB 持久化存储
MongoDB 服务
配套的 Headless Service 为 StatefulSet 提供稳定的网络标识:
apiVersion: v1
kind: Service
metadata:
name: mongo
spec:
clusterIP: None
ports:
- port: 27017
特点:
clusterIP: None
表示这是 Headless Service- 为每个 Pod 提供稳定的 DNS 记录(database-0.mongo...)
应用层部署
Spica StatefulSet
Spica 应用层同样采用 StatefulSet 部署,包含两个容器:
-
spica 容器:前端服务
- 使用 spicaengine/spica:master 镜像
- 暴露 80 端口
- 设置 BASE_URL 环境变量
-
api 容器:后端 API 服务
- 使用 spicaengine/api:master 镜像
- 暴露 4300 端口
- 配置 MongoDB 连接参数
- 设置认证密钥和持久化路径
args:
- --port
- "4300"
- --database-uri
- mongodb://database-0.mongo...
- --database-name
- spica
- --passport-secret
- $2b$10$shOzfYpDCy.RMgsVlwdQeONKGGzaBTfTQAjmXQNpMp4aKlLXrfZ/C
Spica 服务
NodePort 类型的 Service 暴露两个端口:
- 80 端口:前端服务
- 4300 端口:API 服务
spec:
type: NodePort
ports:
- name: spica
port: 80
- name: api
port: 4300
网络入口配置
Ingress 网关
Nginx Ingress 控制器处理外部流量,关键配置包括:
annotations:
nginx.ingress.kubernetes.io/proxy-body-size: 15M
nginx.ingress.kubernetes.io/rewrite-target: /$1
spec:
tls:
- hosts: [master.spicaengine.com]
secretName: spica
rules:
- host: master.spicaengine.com
http:
paths:
- path: /spica/?(.*)
backend:
service:
name: spica
port: 80
- path: /api/?(.*)
backend:
service:
name: spica
port: 4300
特点:
- 支持 15MB 大文件上传
- URL 重写规则
- TLS 终止
- 基于路径的路由规则
数据库初始化
MongoDB 复制控制器
Job 资源确保 MongoDB 副本集正确初始化:
apiVersion: batch/v1
kind: Job
metadata:
name: replication-controller
spec:
template:
spec:
containers:
- name: main
image: spicaengine/mongoreplicationcontroller:master
args:
- "--nodes"
- "database-0.mongo..."
功能:
- 初始化 MongoDB 副本集配置
- 确保数据库高可用性
- 任务完成后自动退出
资源配额管理
Spica-Engine 为各组件配置了合理的资源限制:
-
MongoDB:
- 请求:10m CPU, 10Mi 内存
- 限制:1000m CPU, 2000Mi 内存
-
Spica 前端:
- 请求:10m CPU, 10Mi 内存
- 限制:50m CPU, 100Mi 内存
-
API 服务:
- 请求:10m CPU, 10Mi 内存
- 限制:1000m CPU, 2000Mi 内存
这种配置确保了关键服务(如API和数据库)有足够的资源,同时防止资源浪费。
持久化存储
Spica-Engine 使用 Kubernetes 的 PersistentVolumeClaim 为有状态应用提供存储:
- MongoDB:1GB 存储
- API 服务:2GB SSD 存储(存储类 pd-ssd)
volumeClaimTemplates:
- metadata:
name: master-data
spec:
storageClassName: pd-ssd
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 2Gi
部署最佳实践总结
- 有状态应用:使用 StatefulSet 部署数据库和核心应用
- 服务发现:Headless Service 为 StatefulSet 提供稳定网络标识
- 资源隔离:合理设置资源请求和限制
- 持久化存储:为有状态组件配置 PVC
- 初始化任务:使用 Job 处理初始化逻辑
- 入口管理:Ingress 统一管理外部访问
- 安全传输:TLS 加密外部通信
通过这种架构设计,Spica-Engine 实现了高可用、可扩展的云原生应用引擎平台。
登录后查看全文
热门项目推荐
- QQwen3-Omni-30B-A3B-InstructQwen3-Omni是多语言全模态模型,原生支持文本、图像、音视频输入,并实时生成语音。00
community
本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息010GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0274get_jobs
💼【AI找工作助手】全平台自动投简历脚本:(boss、前程无忧、猎聘、拉勾、智联招聘)Java01Hunyuan3D-2
Hunyuan3D 2.0:高分辨率三维生成系统,支持精准形状建模与生动纹理合成,简化资产再创作流程。Python00Spark-Chemistry-X1-13B
科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile09
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
热门内容推荐
最新内容推荐
项目优选
收起

OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
152
1.97 K

deepin linux kernel
C
22
6

本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
494
37

本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息
323
10

openGauss kernel ~ openGauss is an open source relational database management system
C++
145
191

旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
991
395

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0

React Native鸿蒙化仓库
C++
193
277

🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
937
554

为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
75
70