49 lines
3.7 KiB
Markdown
49 lines
3.7 KiB
Markdown
# DSH Runtime Release
|
||
|
||
`dockerfile` 分支只维护发布清单和 runtime 镜像构建文件，不包含管理面板源码或部署配置。
|
||
|
||
## 发布清单
|
||
|
||
`release.json` 是发布入口：`schema_version` 为清单格式版本，`release_id` 标识一次发布，`version` 为精确 DSH 版本，`deployment_schema` 为运行布局版本，`platforms` 为支持的平台。当前为 `runtime-7.1`、DSH `0.2.0-rc.2`、布局 7、`linux/amd64`。
|
||
|
||
此分支是可信代码来源，不是仅供读取的数据源：Dockerfile 和安装脚本会在构建时执行。只使用经过审核的提交，不要将不可信分支、PR 或任意远端内容直接用于构建。清单本身不代表镜像已经完成运行验收。
|
||
|
||
## 本地构建与检查
|
||
|
||
需要 Docker、Node.js，以及拉取基础镜像和构建依赖的网络。从仓库根目录执行，版本和平台直接取自清单，不跟踪 latest：
|
||
|
||
~~~sh
|
||
DSH_VERSION="$(node -p "require('./release.json').version")"
|
||
PLATFORM="$(node -p "require('./release.json').platforms[0]")"
|
||
RELEASE_ID="$(node -p "require('./release.json').release_id")"
|
||
node --test image/*.test.mjs
|
||
docker build --platform "$PLATFORM" \
|
||
--build-arg DSH_VERSION="$DSH_VERSION" \
|
||
-t "dsh-web:$RELEASE_ID" ./image
|
||
~~~
|
||
|
||
`image/` 是构建上下文。构建只生成本地镜像，不推送镜像，也不自动发布分支。保留 `image/init-profile.test.mjs` 作为独立 runtime 回归测试，覆盖初始化幂等性、保留已有配置和拒绝符号链接目录；它不依赖面板，且被 `image/.dockerignore` 排除在构建上下文之外。此测试不能替代真实容器启动、插件和持久化验收。
|
||
|
||
## 布局 7 合约
|
||
|
||
- 以 UID/GID 1000 运行；实例持久目录挂载到 `/workspace`，必须允许该身份读写。`DSH_HOME`、`HOME` 和工作目录均为 `/workspace`，XDG 数据与配置也位于其中。
|
||
- `/data/dsh-home` 是指向 `/workspace` 的兼容符号链接；不要用旧 home 挂载覆盖该路径。`/shared` 不是布局 7 的持久化入口。
|
||
- DSH 监听 loopback 3080，Caddy 在容器 8080 转发；只通过受信入口访问，不直接公开 runtime 端口，不挂载 Docker socket。原生模块需要可执行的 `/tmp`，可保留 nosuid/nodev 与容量限制。
|
||
- 新 profile 默认启用固定版本的 mobile、free-search 和 workspace bundle，默认工作区为 `/workspace`。已有非空 profile 不自动注入或覆盖；升级镜像不会强制改变已有插件选择。
|
||
- 启动前协调插件依赖，失败则不启动应用；仅含内置固定依赖的 profile 使用离线安装。用户添加插件后可能需要网络。
|
||
|
||
## 手动发布
|
||
|
||
1. 审核 runtime 资产变更及其可信来源，选择精确 DSH 版本，更新 `release.json`。每次发布变更都必须使用新的 `release_id`；布局合约变化时同步更新 `deployment_schema`、镜像及调用方适配，不能只修改数字。
|
||
2. 运行上述测试与本地构建，并完成目标平台的容器启动、插件、持久化与兼容验收；检查 `git diff --check` 和最终差异。
|
||
3. 维护者确认后，**手动提交并手动推送** `dockerfile` 分支到已核实的发布远端。修改清单或本地构建不会自动 commit/push，也不会自动更新运行中的实例。
|
||
|
||
## 文件范围
|
||
|
||
- `release.json`：发布清单。
|
||
- `README.md`：本分支说明。
|
||
- `image/Dockerfile`、`image/Caddyfile`、`image/entrypoint.sh`、`image/.dockerignore`：镜像构建与启动。
|
||
- `image/install-*.mjs`、`image/init-profile.mjs`：内置 runtime 资产安装与 profile 初始化。
|
||
- `image/init-profile.test.mjs`：保留的 profile 初始化回归测试。
|
||
- `image/entrypoint.test.mjs`：从面板测试迁移的 runtime 启动失败保护与镜像约束测试，需要 Bash；不依赖 Go 或面板。
|