feat: expose build identity for release verification

This commit is contained in:
2026-09-20 18:26:00 +08:00
parent b53cffd07d
commit a1ba6cb145
9 changed files with 86 additions and 6 deletions

View File

@@ -38,6 +38,16 @@ curl -i http://127.0.0.1:8080/health/ready
响应不包含 DSN、数据库错误文本或凭据。检查迁移记录不能发现所有人工 DDL 漂移,运行账户权限和迁移流程仍需受控。
## GET /version
返回当前服务的构建和协议身份,不访问数据库,也无需鉴权。该接口适合在滚动发布或故障接管后核对节点是否运行了预期版本。
```sh
curl -fsS http://127.0.0.1:8080/version
```
响应字段包括 `version`、`revision`、`built_at`、`go_version`、HTTP/Worker/Event 协议版本和 Weave 定义结构版本。默认本地构建使用 `dev`、`unknown`;发布镜像应通过构建参数注入不可变提交和构建时间。响应不包含主机、数据库、凭据或租户信息。
## SDK 与运行限制
对应 `Client.Liveness(ctx)` 和 `Client.Readiness(ctx)`,见 [SDK 接入](../sdk/README.md)。HTTP 503 返回 `*orbit.HTTPError`。