Beaver/beaver_project
6
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
5e851298699bb2b6a67722a0dc93288bd53aeaac
beaver_project/app-instance
History
steven_li 5e85129869 feat(mcp): 增强MCP服务器异常处理和错误描述 
- 添加_iter_leaf_exceptions函数用于处理嵌套异常组
- 实现_describe_mcp_exception函数提供详细的MCP服务器错误信息
- 改进connect_mcp_servers中的错误处理，使用更精确的错误描述
- 在日志记录中包含更具体的错误详情

feat(outlook): 优化Outlook集成异常处理

- 添加_iter_leaf_exceptions函数用于异常处理
- 创建_coerce_outlook_mcp_exception函数统一异常转换
- 改进_call_outlook_mcp_tool中的异常捕获和处理
- 对认证令牌获取和MCP调用添加专门的超时和HTTP错误处理

feat(web): 改进Web会话定时任务结果记录

- 实现_record_cron_result_for_web_session函数
- 为Web模式下的独立定时任务执行结果提供持久化存储
- 支持将定时任务响应消息添加到目标会话中
- 确保前端可以显示定时任务执行结果
2026-03-20 17:56:45 +08:00
..
backend
feat(mcp): 增强MCP服务器异常处理和错误描述
2026-03-20 17:56:45 +08:00
frontend
feat(server): 添加系统重启功能支持
2026-03-19 10:26:43 +08:00
runtime/registry
prepro-adapt
2026-03-18 14:22:00 +08:00
.dockerignore
第一次提交
2026-03-13 16:40:08 +08:00
create-instance.sh
feat: 重命名项目为Boardware Genius并添加运行时环境同步功能
2026-03-18 15:45:42 +08:00
Dockerfile
第一次提交
2026-03-13 16:40:08 +08:00
entrypoint.sh
feat: 重命名项目为Boardware Genius并添加运行时环境同步功能
2026-03-18 15:45:42 +08:00
instance-registry.py
第一次提交
2026-03-13 16:40:08 +08:00
list-instances.sh
第一次提交
2026-03-13 16:40:08 +08:00
nginx.conf
第一次提交
2026-03-13 16:40:08 +08:00
README.md
第一次提交
2026-03-13 16:40:08 +08:00
remove-instance.sh
第一次提交
2026-03-13 16:40:08 +08:00

README.md

app-instance

单实例应用单元：

  • 一个 Docker 容器里同时运行前端、后端和 Nginx 反代
  • 前端走 /
  • 后端 API 走 /api
  • WebSocket 走 /ws

关键文件

  • Dockerfile
    • 统一镜像构建入口
  • entrypoint.sh
    • 容器内启动前端、后端、Nginx
  • create-instance.sh
    • 创建实例目录、生成配置、启动容器、写注册表
  • remove-instance.sh
    • 删除容器、移除注册表、可选清理实例目录
  • list-instances.sh
    • 查看当前注册实例
  • instance-registry.py
    • 维护 runtime/registry/instances.json

注册表

默认注册表路径：

runtime/registry/instances.json

每条记录至少包含：

  • instance_id
  • instance_slug
  • container_name
  • host_port
  • public_url
  • instance_root
  • image_name

常用命令

1. 构建镜像

docker build -t nano/app-instance:latest .

2. 创建实例

./create-instance.sh \
  --image nano/app-instance:latest \
  --instance-id demo-001 \
  --auth-username admin \
  --auth-password 123456 \
  --api-key 'your-api-key'

可选参数：

  • --host-port
  • --public-url
  • --username
  • --email
  • --instance-host
  • --authz-base-url
  • --backend-id
  • --client-id
  • --client-secret
  • --network
  • --host-bind-ip
  • --build
  • --replace

3. 查看实例

./list-instances.sh
./list-instances.sh --json

4. 删除实例

./remove-instance.sh --instance-id demo-001

如果要把实例目录也一并清掉：

./remove-instance.sh --instance-id demo-001 --purge-data

目录约定

默认实例数据目录：

runtime/instances/<instance-slug>/

其中会生成：

runtime/instances/<instance-slug>/
└── nanobot-home
    ├── config.json
    ├── web_auth_users.json
    └── workspace/

当前状态

这层已经支持：

  • 统一镜像构建
  • 实例创建
  • 实例删除
  • 实例列表
  • 基于注册表的端口分配
  • 为 deploy-control / router-proxy 记录用户名和实例 host

生产注意

  • 实例容器的宿主机端口默认只绑定 127.0.0.1
  • 外部访问应统一走 router-proxy
  • 如果你确实要把单个实例端口直接暴露到公网，再显式传 --host-bind-ip 0.0.0.0

下一步可以继续接：

  • portal 调用创建实例
  • URL 分配和反向代理
  • 实例续期 / 停用 / 启用