【免费下载链接】rocketride-serverHigh-performance AI pipeline engine with a C core and 50 Python-extensible nodes. Build, debug, and scale LLM workflows with 13 model providers, 8 vector databases, and agent orchestration, all from your IDE. Includes VS Code extension, TypeScript/Python SDKs, and Docker deployment.项目地址https://gitcode.com/gh_mirrors/ro/rocketride-server点击查看免费下载本文基于 RocketRide 仓库中的 Helm Chart 说明文档系统讲解该社区版 Chart 的完整生命周期操作——从helm install/upgrade/uninstall命令到 values.yaml 中的全部关键参数、双模式 Secret 管理engine.secrets与engine.existingSecret、预置外部服务 value 叠加层以及多副本高可用部署前必须满足的共享文件存储校验。读完后你可以独立完成 RocketRide 引擎在 Kubernetes 上的自托管部署、升级、排障与扩容。1. 前置条件与 Chart 定位RocketRide Helm Chart 面向开源社区自托管场景提供一套生产就绪的 Kubernetes 部署。根据 Chart.yamlChart 版本为0.1.0appVersion为3.1.2引擎镜像默认指向ghcr.io/rocketride-org/rocketride-engine。部署前需要满足Kubernetes 1.25Helm 3.10一个外部 PostgreSQL 实例或由你单独部署可参考 examples 目录按照 ARCHITECTURE.md 的设计该 Chart 部署的组件包括Engine DeploymentC 引擎 Python 节点运行时、ClusterIP Service暴露 5565 端口 API、ConfigMap非敏感环境变量、SecretAPI 密钥与凭证支持existingSecret、ServiceAccount最小权限专用账号、可选 Ingress 与可选 HPA。明确不部署任何数据库或向量存储PostgreSQL/pgvector、ChromaDB、Milvus 等需自行用托管服务或专用 Chart 提供——这是有意识的设计决策目的是避免有状态服务带来的升级与备份复杂度。2. 安装、升级与卸载完整命令清单2.1 安装无需添加 Helm 仓库直接安装源码目录下的 Chart# 直接安装 helm install rocketride deploy/helm/rocketride/ # 使用自定义 values helm install rocketride deploy/helm/rocketride/ --values my-values.yaml # Dry-run 预览渲染出的 manifests helm install rocketride deploy/helm/rocketride/ --dry-run --debug推荐先用--dry-run --debug预览除了看到最终 manifest还能提前暴露 Chart 内置的两类渲染期校验错误见 values_test.yaml 中 CI 用的配置说明——缺共享存储时 Chart 会故意让渲染失败。2.2 升级与卸载# 升级 helm upgrade rocketride deploy/helm/rocketride/ --values my-values.yaml # 卸载 helm uninstall rocketride # PVC 不会自动删除需要时手动清理 # kubectl delete pvc -l app.kubernetes.io/instancerocketride2.3 安装后的验证与访问方式安装成功后NOTES.txt会按 Service 类型打印对应的访问命令。默认 ClusterIP 模式下使用 port-forward 验证kubectl --namespace namespace port-forward svc/rocketride-engine 5565:5565 # 访问 http://127.0.0.1:5565/ping 验证连通性Chart 还提供内置的helm test它运行一个连接性 Pod用 curl 请求引擎 Service 的/ping端点实现见 test-connection.yaml使用curlimages/curl:8.11.1镜像、10 秒超时并以helm.sh/hook: test声明为测试钩子helm test rocketride3. 关键配置参数详解完整参数带内联注释以 values.yaml 为准。README 中列出的关键参数如下参数默认值说明engine.replicaCount1副本数2 需要共享存储见第 5 节 HA 调优engine.image.tag取 Chart appVersion引擎镜像 tagengine.resources见 values.yamlCPU/内存 requests 与 limits默认 requests 250m/512Milimits 2 核/2Giengine.autoscaling.enabledfalse启用 HPA同样需要共享存储engine.env.RR_STORE_URL未设置共享文件存储后端超过 1 个 Pod 前必须设置engine.sharedStoreConfiguredfalse声明RR_STORE_URL由 Chart 外部注入engine.service.sessionAffinityNone设为ClientIP可将客户端固定到某个 Pod临时方案非根治engine.existingSecret已存在的 Secret 名称engine.existingSecretChecksum手动触发外部 Secret 轮换后的滚动更新ingress.enabledfalse通过 Ingress 暴露引擎值得展开的几个底层细节镜像 tag 的回退逻辑。在 deployment.yaml 引用的辅助模板 _helpers.tpl 中rocketride.engine.image定义tag为空时回退到 Chart 的appVersion因此不写engine.image.tag就会自动跟随 Chart 版本当前为3.1.2。三级探针。引擎容器同时配置了 readiness、liveness、startup 三个 HTTP 探针全部请求/ping:5565startup 探针给了failureThreshold: 30×periodSeconds: 5共约 150 秒的启动宽限避免 C 引擎冷启动被 liveness 误杀。这些阈值均可在engine.readinessProbe等节点下覆盖。默认安全加固。默认podSecurityContext以非 root 用户 1000 运行容器readOnlyRootFilesystem: true、allowPrivilegeEscalation: false、drop 全部 capabilities并且额外挂载一个/tmpemptyDir 供可写临时目录使用见 deployment.yaml 中的volumes段。ServiceAccount 默认创建且设置automountServiceAccountToken: false见 serviceaccount.yaml。GPU 为可选开启。engine.gpu.enabled: true时 Chart 在 limits 中注入nvidia.com/gpu: count并合并engine.gpu.nodeSelector/tolerations。values.yaml 中明确提示CPU/内存 HPA 不适合 GPU 推理负载GPU 利用率对 metrics server 不可见GPU 场景应改用 KEDA示例见deploy/helm/examples/keda-gpu-scaling.yaml。4. Secret 管理Chart 托管与外部托管双模式4.1 开发模式engine.secretsengine: secrets: OPENAI_API_KEY: sk-... POSTGRES_PASSWORD: my-passwordChart 会将这些键值 base64 编码后写入一个它创建的 Kubernetes Secret模板见 secret.yaml仅在engine.secrets非空且existingSecret为空时渲染。注意 values.yaml 中的命名约定从节点配置以${VAR}引用的变量必须以ROCKETRIDE_前缀开头引擎只解析该前缀其余${VAR}会被替换为字面量REDACTED。4.2 生产模式engine.existingSecretengine: existingSecret: rocketride-credentials existingSecretChecksum: 2026-04-09-rotation-1设置后 Chart不再创建Secret 资源只将命名 Secret 以环境变量方式挂载进 Pod适合 Vault、AWS Secrets Manager、Sealed Secrets 等外部体系。4.3 渲染期校验与滚动更新机制从源码结构看这两个模式对应两条不同的校验与滚动链路非空校验_helpers.tpl 中的rocketride.validateSecrets在existingSecret与engine.secrets均为空时直接fail报错提示必须通过engine.secrets提供 API 密钥或提供engine.existingSecret——防止裸部署缺少凭证。该校验在渲染 deployment.yaml 时首先触发。自动 vs 手动滚动Deployment 的 Pod 注解上写有两枚校验和见 deployment.yaml 第 21–26 行checksum/configConfigMap 渲染内容的 SHA256任何engine.env变更都会触发滚动checksum/secret若使用existingSecret取secret名:existingSecretChecksum的 SHA256——外部 Secret 内容本身 Chart 读不到所以轮换外部 Secret 后必须手动 bumpengine.existingSecretChecksum才能强制 rollout若使用engine.secrets则取 Secret 模板渲染结果的 SHA256改动自动触发滚动无需额外操作。NOTES.txt也会在部署完成后提醒Chart 不打包数据库/向量库需通过engine.env与engine.secrets配置外部服务。5. HA 调优多副本部署前必须先配置共享文件存储这是整个 README 的核心设计约束扩缩容前必须先有共享文件存储。5.1 为什么引擎不是无状态的引擎在无RR_STORE_URL时把账号文件保存在容器本地文件系统路径上由此产生两个问题每个 Pod 都持有一份私有副本——通过 Pod A 写入的文件下一个请求落到 Pod B 时就消失了同一后端下引擎还会为每个进程生成一把 URL 签名密钥RR_SIGNING_KEY于是 Pod A 签发的下载 URL 在其他所有 Pod 上都会返回 401。把RR_STORE_URL指向s3://或azureblob://引擎同时接受azure://作为后者的别名可以一次性解决两个问题对象存储天然共享且原生支持预签名 URL签名密钥这一环直接消失。Chart 对没有配置共享存储的多副本 release拒绝渲染。5.2 生产高可用部署示例完整继承原文档engine: replicaCount: 2 # 最小 HA 副本数动态扩缩请改用 autoscaling autoscaling: enabled: true minReplicas: 2 maxReplicas: 10 env: # 副本数 1 前必须设置 RR_STORE_URL: s3://my-bucket/rocketride secrets: RR_STORE_SECRET_KEY: {access_key_id: ..., secret_access_key: ...} affinity: podAntiAffinity: requiredDuringSchedulingIgnoredDuringExecution: - labelSelector: matchLabels: app.kubernetes.io/name: rocketride topologyKey: kubernetes.io/hostname示例中同时启用了反亲和强制副本分散到不同节点。5.3 校验逻辑的源码级印证上述拒绝渲染由 _helpers.tpl 中的rocketride.validateScaleOut实现其判定逻辑是先由rocketride.engine.canScaleOut判断 release 是否可能运行多个 Pod——autoscaling.enabled时以maxReplicas 1为准启用 HPA 时 Deployment 会省略replicas字段否则以replicaCount 1为准可能多副本时若sharedStoreConfigured不为true则检查engine.env.RR_STORE_URL是否以s3://、azureblob://或azure://开头任一不满足即fail报错信息会附带当前RR_STORE_URL取值与三种修复建议配置共享后端、回退单副本、或声明外部注入。这正是sharedStoreConfigured: true的用途当RR_STORE_URL从 Chart 视野之外注入例如经由engine.existingSecret其内容 Chart 无法读取时用它向 Chart 声明共享存储已就位以放行渲染。values_test.yaml 就是活例子CI 配置开启了autoscaling.enabled: true且maxReplicas: 5因此必须给出真实的RR_STORE_URL: s3://rocketride-test-bucket/store与RR_STORE_SECRET_KEY注释明确写道没有共享存储Chart 会故意让渲染失败。5.4 留在文件系统后端的两条注意单副本部署可以保留默认的 filesystem 存储但有两点必须知道显式设置engine.secrets.RR_SIGNING_KEY。不设置时引擎在启动时生成一把临时密钥Pod 一重启此前签发的所有下载 URL 全部失效。values.yaml 中还附了生成命令python -c import secrets; print(secrets.token_urlsafe(32))。Chart 不挂载任何 PersistentVolume默认存储无法在 Pod 重启后存活。需要自行通过engine.volumes/engine.volumeMounts挂载卷并把RR_STORE_URL指向挂载路径filesystem://scheme 仅限单副本且 Pod 重启即丢失。engine.service.sessionAffinity: ClientIP把客户端固定到单个 Pod只是文件系统后端部署的临时手段——它不能让状态共享也不会在 Pod 重新调度后保持。6. 预置 Value 叠加层examplesdeploy/helm/examples/ 提供四个开箱即用的 value 覆盖文件文件用途external-postgres.yaml连接外部 PostgreSQL / pgvector 实例external-chroma.yaml连接外部 ChromaDB 实例gpu-values.yaml启用 NVIDIA GPU 资源请求keda-gpu-scaling.yaml面向 GPU 推理负载的 KEDA 自动扩缩以 external-postgres.yaml 为例它通过engine.env设置POSTGRES_HOST/POSTGRES_PORT/POSTGRES_USER/POSTGRES_DB四个连接参数并用existingSecret: rocketride-postgres引用事先用kubectl create secret generic创建的密码 Secret——密码这类凭证不落 values 文件。叠加应用方式后写的-f优先级更高自定义覆盖应放在最后helm install rocketride deploy/helm/rocketride/ -f deploy/helm/examples/external-postgres.yaml helm install rocketride deploy/helm/rocketride \ -f deploy/helm/examples/external-postgres.yaml \ -f my-values.yaml按 ARCHITECTURE.md 的说法社区 Chart 刻意避开 SaaS 侧的 ArgoCD GitOps、External Secrets Operator、Cilium Gateway API 等专用工具链只用标准 Kubernetes 资源不引入 CRD保证在任何集群上无需预装 operator 即可运行可观测性、Secret 后端等能力则留给使用者按自身环境接入例如 values_test.yaml 中的podAnnotations展示了用prometheus.io/scrape注解暴露指标端点的做法。7. 小结部署前自检清单engine.secrets与engine.existingSecret至少配置其一否则渲染直接失败validateSecrets。副本数 1 或maxReplicas 1时RR_STORE_URL必须是s3:///azureblob:///azure://或设置sharedStoreConfigured: true否则validateScaleOut拒绝渲染。外部 Secret 轮换后记得 bumpengine.existingSecretChecksumengine.secrets模式则自动滚动。文件系统后端单副本显式设置RR_SIGNING_KEY否则重启后旧下载 URL 全部 401。GPU 负载不要依赖 CPU/内存 HPA改用engine.gpu KEDA 示例。部署完成后helm test rocketride验证/ping连通性。赞分享【免费下载链接】rocketride-serverHigh-performance AI pipeline engine with a C core and 50 Python-extensible nodes. Build, debug, and scale LLM workflows with 13 model providers, 8 vector databases, and agent orchestration, all from your IDE. Includes VS Code extension, TypeScript/Python SDKs, and Docker deployment.项目地址https://gitcode.com/gh_mirrors/ro/rocketride-server点击查看免费下载相关推荐如何用 ArduPilot 开源飞控零硬件跑通第一架无人机完整上手路径如何用 ArduPilot 开源飞控零硬件跑通第一架无人机完整上手路径 ArduPilot 是一套 GPL 许可的开源飞控系统支持多旋翼、固定翼、地面、水下后端AI 应用NLP使用 Helm Chart 在 Kubernetes 上部署 Tandoor Recipesvalues 配置、Secret 管理与流量接入实战使用 Helm Chart 在 Kubernetes 上部署 Tandoor Recipesvalues 配置、Secret 管理与流量接入实战 Tandoo后端前端AI 应用TREK 的 Kubernetes 部署指南使用官方 Helm Chart 安装与配置TREK 的 Kubernetes 部署指南使用官方 Helm Chart 安装与配置 导读 TREK 是一款自托管的旅行规划应用支持实时协作、交互式地图、后端前端MCP 服务AI 应用上一篇vLLM-Omni 部署 Voxtral TTS4B 文本转语音模型在线服务实战指南下一篇掌握scroll-world打造专业级3D滚动体验的完整技术指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考