66 lines
4.2 KiB
Markdown
66 lines
4.2 KiB
Markdown
# v0.1.1：统一示例与正式版本发布
|
||
|
||
日期：2026-09-24。目标：以 `main` 交付代码，使用固定版本安装 SDK/Outbox，将功能说明和接入入口集中到根 README。
|
||
|
||
## 内容
|
||
|
||
- 24 个轻量 SDK 示例迁至根 examples module；与原有三个业务数据库工程一起形成 27 个独立场景目录。
|
||
- 每个目录补充 README，根 README 列出功能、准备条件、初始化管理员、调用方式、预期结果、配置及运维入口。
|
||
- 工作区、7 个模块的构建回归、MySQL/控制台/历史兼容脚本同步调整路径；历史版本 checkout 仍使用其原目录。
|
||
- 公共 SDK 生产代码没有改动；公共 MySQL Outbox 核心沿用[已经验收的实现](outbox-http-integration.md)。数据库结构没有因本次目录整理变化。
|
||
|
||
## 本次验证
|
||
|
||
本地检查与发布后远端安装均已完成，结果如下：
|
||
|
||
| 检查 | 结果 |
|
||
| --- | --- |
|
||
| 7 模块 `make test vet build` | 通过，退出 0 |
|
||
| `make sdk-check protocol-check docs-check` | 通过；SDK 5 个包、禁止依赖为 0；193 份 Markdown 本地链接有效 |
|
||
| `make integration` | 通过，退出 0；真实 MySQL、27 个示例场景、事务/HTTP 回执丢失、进程强杀及多节点恢复 |
|
||
| `make console-e2e` | 通过；登录/保护路由、Worker/重试/计划、保留策略/周期归档作业、离线核验和退出登录 |
|
||
| 历史任务 API 双向 smoke | 通过；当前 SDK 对 a50d5fa 服务端、a50d5fa SDK 对当前服务端 |
|
||
| 远端 main 与三组标签 | 原子推送成功，默认分支 main；三组标签均指向发布提交 81e56bd633cfe9f7669b4243dee5d7683e5f6697 |
|
||
| 仓库外固定版本安装、构建、HTTP smoke 与校验和 | 空模块缓存、GOWORK=off、无 replace；两个模块精确解析为 v0.1.1，全部退出 0 |
|
||
|
||
## 版本约定
|
||
|
||
服务端 `v0.1.1`、SDK `sdk/go/v0.1.1`、Outbox `adapters/outbox/mysql/v0.1.1` 对齐同一个发布提交。既有 v0.1.0 标签保留，不强推或覆盖。
|
||
|
||
轻量示例及适配包 go.mod 保留 SDK 最低兼容依赖 v0.1.0；在仓库中通过 go.work 测试本地 SDK，在 GOWORK=off 下验证已发布最低依赖。业务安装当前 v0.1.1，不依赖本地 replace。三个业务示例中的 replace 只用于仓库内开发联调。
|
||
|
||
## 边界
|
||
|
||
上述检查验证示例迁移、当前平台链路和远端发布，不等同于目标生产容量或跨故障域验收。历史 API smoke 不冒充全协议跨标签矩阵，具体矩阵见[兼容说明](../sdk/compatibility.md)。归档继续保留源数据，不承诺源数据删除或其他数据库适配。
|
||
|
||
## 远端发布证据
|
||
|
||
发布提交为 `81e56bd633cfe9f7669b4243dee5d7683e5f6697`。通过 `git ls-remote --symref origin` 核对默认分支为 main，平台/SDK/Outbox 三组标签解引用到同一提交。随后仅补充本验证记录，既有标签不移动。远端 main 的根 README 与 examples/README 原文逐字节核对一致。
|
||
|
||
在仓库外新建 `example.com/orbit-release-consumer`，使用全新 GOPATH/GOMODCACHE、`GOWORK=off`，执行：
|
||
|
||
```sh
|
||
go get git.yuntuo.hk/k2safe/orbit/sdk/go@v0.1.1 git.yuntuo.hk/k2safe/orbit/adapters/outbox/mysql@v0.1.1
|
||
go mod tidy
|
||
go build ./...
|
||
go run .
|
||
go mod verify
|
||
```
|
||
|
||
测试程序通过远端 SDK 调用本地 httptest 服务的健康接口，并读取远端 Outbox SchemaSQL 核对表名及零外键；这一步验证远端包安装与可用性，真实数据库事务/HTTP 业务链路由上方全量回归覆盖。实际输出：
|
||
|
||
```text
|
||
remote_sdk_http_smoke=passed outbox_schema_smoke=passed
|
||
all modules verified
|
||
remote_versions=v0.1.1 no_replace=true checksum_verification=enabled
|
||
```
|
||
|
||
验证进程使用 `GOPROXY=https://goproxy.cn,direct`，仅在该进程沿用主机已有网络代理；`GOSUMDB=sum.golang.org` 保持开启，未关闭校验和、未设置私有模块例外、未修改全局 Go/Git 配置。解析结果：
|
||
|
||
```text
|
||
git.yuntuo.hk/k2safe/orbit/sdk/go v0.1.1 h1:xikN6Frz7HJsHdh4e3iHG9sX4cJNlRjKh0Wn/ApN3XI=
|
||
git.yuntuo.hk/k2safe/orbit/sdk/go v0.1.1/go.mod h1:9KlMW7Gy+EGaDoEwr3wHHFY47mnAymSfYeQpMS7h4ag=
|
||
git.yuntuo.hk/k2safe/orbit/adapters/outbox/mysql v0.1.1 h1:oqRfqtAq6Q1CWss4RFH1jnGu8S+2xr5e+QmeC5zfMPE=
|
||
git.yuntuo.hk/k2safe/orbit/adapters/outbox/mysql v0.1.1/go.mod h1:G+8DIXGFFssSeQ9T1HahnKUyoKNlF2GQDB21ENO3xqk=
|
||
```
|