G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的
docs/development/testing.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:工程设计、实施或验证记录。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# 验证策略
# 当前基线
2026-11-09 静态复核:
init-once.sh、start.sh、stop.sh、update.sh、compose-business.inc、config/generate-ssl.sh通过bash -n。- Docker Compose 成功解析基础编排(13 服务)、默认 Agent+Knowledge(23 服务),以及追加 department/member/cms 的组合。
- 未执行容器运行测试。
本次 Compose 使用 .env.example 执行 config --services,只解析配置,不拉取镜像或启动容器。
# 变更验证
- Shell 语法:所有生命周期
.sh、compose-business.inc与将实际调用的辅助脚本。 - Compose:基础编排、每个业务片段及常用合并组合(含可选扩展)。
- 扩展选择:
BUSINESS_EXTENSIONS、--business追加与去重。 - 镜像:确认默认标签可追溯,覆盖变量不会悄悄引入
latest。 - 资源与端口:核对锚点、片段内联声明与
.env.example端口映射。 - 生命周期:在隔离 Docker Context 中验证启动等待、更新、普通停止;破坏性清理需单独授权。
- 数据:验证已有/空数据卷、数据库初始化、Milvus 建表标记、备份与回滚。
- 安全:扫描固定凭据、私钥、危险权限和不可信命令执行入口。
仅静态解析通过不能证明部署成功;运行时验证必须说明使用的环境、服务范围和数据影响。