16 lines
1.4 KiB
Markdown
16 lines
1.4 KiB
Markdown
# ADR-002：外部项目使用子模块配置
|
|
|
|
## 状态
|
|
|
|
已接受，2026-10-15。替代早期复制数据库驱动源码的做法。
|
|
|
|
## 决定
|
|
|
|
数据库服务与 Rust 驱动作为两个独立 Git 子模块维护。主仓库只提交远程地址、固定版本指针、初始化/构建配置，不提交依赖源码或编译产物。Cargo 引用初始化后的驱动路径，数据库从外部 checkout 构建并暂存到被忽略的 Docker 构建目录。
|
|
|
|
子模块登记来源使用 `ChuGit:/srv/git/ChuSQL.git` 与 `ChuGit:/srv/git/ChuSQL-RustDriver.git`。服务器初始化由 `deploy` 用户执行，优先连接 `ssh://git@localhost/srv/git/…`；本机不可用或不含固定提交时，改用对应 GitHub 仓库。支持空仓库留下的半初始化状态恢复。回退仍保持固定提交，不自动跟随远程最新分支。
|
|
|
|
可选项目级 `insteadOf` 只将自建服务器别名转到 localhost SSH，不重写 GitHub，以保证回退独立。开发者可以显式使用已有文件路径；文件协议只对这种开发覆盖参数的一次命令启用。Docker 构建前通过同一个初始化脚本取依赖，Git 密钥不进入构建上下文。
|
|
|
|
已有驱动副本从主仓库的历史树中删除。外部项目仍各自保留完整历史；主仓库不能替代依赖仓库分发其对象，源仓库必须先具有固定指针所引用的提交。
|