43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
# SpacetimeDB 云端配置移除记录
|
||
|
||
日期：`2026-05-02`
|
||
|
||
## 1. 目标
|
||
|
||
当前项目不再使用旧云端 SpacetimeDB 目标，仓库内不再保留云端专用配置、脚本入口和文档默认口径。后续开发、迁移、Jenkins 流水线与后台验证均以本地或显式传入的 SpacetimeDB 服务为准。
|
||
|
||
## 2. 入口调整
|
||
|
||
1. 根工程后端单独启动入口统一为：
|
||
|
||
```bash
|
||
npm run api-server
|
||
```
|
||
|
||
2. 该入口读取 `.env`、`.env.local` 与当前进程环境中的 `GENARRATIVE_SPACETIME_*`，默认服务地址回落到 `http://127.0.0.1:3101`。
|
||
3. 已移除旧云端发布入口和脚本。SpacetimeDB 模块发布继续通过本地联调脚本、发布包 `start.sh` 或显式 `spacetime publish --server <server-url>` 执行。
|
||
|
||
## 3. 环境变量口径
|
||
|
||
`api-server`、迁移脚本和 Jenkins 部署脚本只使用以下运行变量：
|
||
|
||
```text
|
||
GENARRATIVE_SPACETIME_SERVER_URL
|
||
GENARRATIVE_SPACETIME_DATABASE
|
||
GENARRATIVE_SPACETIME_TOKEN
|
||
```
|
||
|
||
旧云端专用变量不再作为兼容回退读取。需要连接其它 SpacetimeDB 服务时，必须显式设置 `GENARRATIVE_SPACETIME_SERVER_URL` 或在脚本参数中传入 `--server-url`。
|
||
|
||
## 4. 迁移脚本口径
|
||
|
||
1. `scripts/spacetime-migration-common.mjs` 默认 server 为本地 `dev`，解析到 `http://127.0.0.1:3101`。
|
||
2. 授权、撤销、导出等 CLI 调用会显式传 `-s`，避免落回机器上的 SpacetimeDB CLI 默认服务。
|
||
3. Jenkins 数据库导入导出流水线默认 `SERVER=dev`，需要操作其它目标时必须显式填写 `SERVER_URL`。
|
||
|
||
## 5. 后续约束
|
||
|
||
1. 新增 SpacetimeDB 运维脚本时，不允许把云端服务写成默认值。
|
||
2. 文档中的验证命令统一使用 `npm run api-server`。
|
||
3. 如果某次任务需要连接非本地 SpacetimeDB，必须在文档和验证记录中写清楚实际 `SERVER_URL`、数据库名和身份来源；除 CI/CD 脚本内部受控用法外，不再把 `--root-dir` 写入人工命令。
|