G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的
docs/development/conventions.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# Shell 与 Compose 约定
- Shell 使用 Bash,并保持
set -euo pipefail兼容。 - 所有路径基于脚本所在仓库根解析,避免依赖调用者当前目录。
- 仅支持 Docker Compose V2(
docker compose)。 - 业务片段选择集中在
compose-business.inc;新增片段须同步business.d/README.md、.env.example与工程文档。 --business为追加语义,并与BUSINESS_EXTENSIONS去重合并。- G2rain 组件镜像使用固定版本标签;禁止默认引入
latest。 - 资源、端口、卷、健康检查的变更必须同步
docs/与README.md。 - 清理、覆盖、生成密钥、删除数据卷均属于显式授权操作,必须有清晰提示。
- 示例配置只提供占位用途;演示私钥不得被当作生产材料。