codex-bot
534c2a3b2c
Verify databases and deploy Aster VM / verify-and-deploy (push) Successful in 14m4s
40 lines
4.7 KiB
Markdown
40 lines
4.7 KiB
Markdown
# 开发交接
|
||
|
||
## 入口与验证
|
||
|
||
先阅读根目录 AGENTS.md。工作区四个 crate 的边界必须保持，内核无数据库／HTTP 依赖。用户明确禁止本地测试，不在本机运行检查／冒烟脚本，也不为此下载依赖。指定的远端验证环境是 ces-control；CI 在 Docker 中运行 `sh scripts/check.sh`、`python3 scripts/smoke.py` 和真实 PostgreSQL 集成测试。正式持久部署选择 PostgreSQL。检查记录见 validation.md。
|
||
|
||
核心 API 示例在 `aster-core/src/lib.rs`，由 rustdoc 实际编译执行。公开语义测试在 `aster-core/tests/runtime.rs`；伪造句柄仅在私有堆单元测试中构造，禁止为测试添加公开非法构造器。
|
||
|
||
用户已澄清：当前实现 Endor 的 VM 运行时，不实现 Python type 系统，也不定义语言根类。旧的 Class／Type、create_class、create_instance、root_class 和 type_of API 已移除。公共结构和操作接口在 object.rs，分配、引用计数和循环回收在 heap.rs，对外检查入口在 vm.rs。详见 endor-object.md。
|
||
|
||
关键所有权规则：分配给一个外部强引用；句柄拷贝与 Value 克隆只产生借用；额外持有使用 retain。托管属性和 trace 声明的不可变载荷边分别计数。get_attr／call 返回借用值。长链释放使用迭代队列；循环回收以外部引用为根。添加可变载荷引用时必须设计 VM 管理的更新协议，不能只改 trace 的返回结果。
|
||
|
||
CLI bootstrap 演示两个原生运行时对象并显式释放；HTTP /bootstrap 返回 object_model=EndorObject、type_system=false、heap_objects=0。修改宿主表示时同步 scripts/smoke.py。
|
||
|
||
存储测试用 `tempfile` 隔离文件，关闭池后重开，验证独立连接生命周期中的持久化。内存测试验证克隆共享、独立 store 隔离、特殊字符参数绑定、更新／缺失键。PostgreSQL 失败测试用只监听但不处理协议的本地 TCP socket，检验真实连接超时和不降级；成功测试显式 ignore，需要用户提供专用测试库。
|
||
|
||
远端冒烟脚本用于跨进程调用 CLI、启动 HTTP 宿主、探测真实 TCP 端点、发送 SIGTERM 并确认正常退出。它只创建临时目录，不改 `.env`，不操作外部服务器。端口通过临时绑定选择，释放后启动间存在很小的端口竞争窗口；在指定验证环境中若冲突，可重试整个脚本。
|
||
|
||
依赖使用 Cargo.lock。此前编译器为 1.91.1；更换依赖后须在指定环境检查 MSRV 和容器构建版本。核心测试无需数据库，但 Cargo 首次依赖解析仍可能访问注册表；不要因此在本机恢复下载或测试。
|
||
|
||
## 下一阶段建议
|
||
|
||
1. 为执行栈与宿主持有值建立明确的强引用根管理，扩展原生调用上下文，补对应生命周期测试。
|
||
2. 在 core 内构建可测的最小执行循环，先用手写指令，继续不做解析器和渲染器。
|
||
3. 按实际分配负载设计 GC 触发、资源限额与暂停策略；现有手动循环回收不等于分代或增量 GC。
|
||
4. 浏览器能力与外部对象桥接使用原生载荷；保持 core 无网络或宿主库依赖。
|
||
5. VM 快照需要另行定义持久身份与格式，不能序列化当前进程句柄。语言类型、根类和继承以后再确定。
|
||
|
||
## Git 状态与后续远程
|
||
|
||
origin 为用户提供的 `ssh://git@gitea.entroia.com:22222/Zayden-Jung/endorphin-aster-vm.git`。仓库级 author 和隔离 SSH 命令已配置；不得复制其他身份或猜测 owner。发布 CI/CD 需要提交、推送并跟踪远端结果；遵守 AGENTS.md 的授权及中文逐文件报告要求。初始开发阶段记录与后续部署记录在 validation.md 中分开说明。
|
||
|
||
## 远端 CI 与部署
|
||
|
||
`scripts/ci-ces-control.sh` 构建 Dockerfile 的 ci 阶段，创建专属网络与临时 PostgreSQL，再依次运行 workspace 检查、显式 PostgreSQL 测试、SQLite／宿主端到端冒烟。Docker daemon 为 legacy builder，工作流显式设置 `DOCKER_BUILDKIT=0`；没有依赖 buildx。远端内存约 1.7 GiB，Rust 单任务编译、调试构建不生成 debug 信息。
|
||
|
||
`scripts/deploy-ces-control.sh` 仅部署已经构建的 SHA 镜像；使用文件锁防止并行切换生产版本，第一次自动生成服务器密码文件，后续保留。Compose 固定项目名，独占 PostgreSQL 数据目录，与其他项目隔离。部署通过健康检查和真实元数据写入／读取后才切换 current；失败时尝试恢复上一版健康 Compose，不删除数据库或镜像。
|
||
|
||
更换应用容器不应重建密码或清理数据目录。PostgreSQL major 版本升级与 schema 变更须另外计划迁移；禁止把应用镜像回退当作数据库回退。修改此链路后，验证必须继续放在 ces-control，不要恢复本机依赖下载。
|