2026-05-10 15:53:17 +08:00
|
|
|
|
# Changelog: @go/starter
|
|
|
|
|
|
|
2026-06-08 00:19:53 +08:00
|
|
|
|
## v1.5.3 (2026-06-07)
|
|
|
|
|
|
- **重大架构更迭: 引入 Start/Wait 编排模式与生命周期钩子**:
|
|
|
|
|
|
- **废弃 `Run()`**: 彻底移除黑盒式的 `Run()` 方法，改为显式的 `Start()` (解析与非阻塞启动) 与 `Wait()` (阻塞与信号处理) 模式。
|
|
|
|
|
|
- **生命周期钩子**: `Register` 现返回 `*managedService` 指针，支持链式注册 `OnStarting`, `OnStarted`, `OnStopping`, `OnStopped` 回调。
|
|
|
|
|
|
- **中间状态编排**: 允许开发者在 `Start()` 之后、`Wait()` 之前执行自定义初始化逻辑（如跨服务的业务对齐）。
|
|
|
|
|
|
|
2026-06-05 08:37:22 +08:00
|
|
|
|
## v1.5.2 (2026-06-05)
|
|
|
|
|
|
- **可观测性升级: 中心化生命周期审计与 TraceID 链路追踪**:
|
|
|
|
|
|
- **TraceID 分层**: 为 `starter` 编排层引入了独立的长短 ID 体系。
|
|
|
|
|
|
- Starter 级（8位短 ID）：代表整个启动/停止批次的编排上下文。
|
|
|
|
|
|
- 服务级（10位长 ID）：自动派发给每个子服务的 `Start` 方法，确保服务内部日志能与 Starter 状态精准关联。
|
|
|
|
|
|
- **状态聚合**: 所有的 `service [name] starting / started / stopping / stopped` 日志现由 `starter` 统一负责，并显式记录跨层级的 `trace` ID。
|
|
|
|
|
|
- **语义统一**: 所有 Starter 核心消息增加 `[starter]` 前缀标识。
|
|
|
|
|
|
- **架构清理**: 移除了内部对 `log-writer` 的自动注册逻辑，将核心组件的启停权责彻底交还给应用开发者。
|
|
|
|
|
|
|
|
|
|
|
|
## v1.5.1 (2026-06-04)
|
|
|
|
|
|
- **依赖升级**: 全面对接 `@go` 基础设施 v1.5.1。
|
|
|
|
|
|
|
|
|
|
|
|
## v1.5.0 (2026-05-10)
|
|
|
|
|
|
- **基础设施对齐**: 全局对齐至 v1.5.0。
|
|
|
|
|
|
|
2026-05-12 14:59:17 +08:00
|
|
|
|
## v1.0.1 (2026-05-12)
|
|
|
|
|
|
|
|
|
|
|
|
### 🚀 Features
|
|
|
|
|
|
- **Secure IPC**: Token-based authentication using **SHA256** (of secret + PID) for Unix Domain Socket communication.
|
|
|
|
|
|
- **Precise Signaling**: `kill <svc_name> <signal_num>` command for targeted service signaling.
|
|
|
|
|
|
- **Trace ID Propagation**: Automatically generates and propagates a shared Trace ID for all service startup logs.
|
|
|
|
|
|
- **Enhanced `status`**: Detailed health reporting secured by IPC token.
|
|
|
|
|
|
|
|
|
|
|
|
### 🧹 Cleanup
|
|
|
|
|
|
- **Minimalist API**: Finalized the core API: `Register`, `Run`, `AddCommand`, and `SetAppInfo`.
|
|
|
|
|
|
- **Automated PID**: Refined PID management in system temp directory.
|
|
|
|
|
|
|
|
|
|
|
|
### 🛠 Improvements
|
|
|
|
|
|
- **Race Condition Fix**: IPC server now starts only after all services are successfully initialized to prevent concurrent access panics.
|
|
|
|
|
|
- **Infrastructure Alignment**: Fully aligned with `@go` modules, including `cast.To[T]`, `timer.Retry`, and `id`.
|
|
|
|
|
|
|
2026-05-10 15:53:17 +08:00
|
|
|
|
## v1.0.0 (2026-05-10)
|
|
|
|
|
|
|
|
|
|
|
|
### 🚀 Features
|
|
|
|
|
|
- **Initial Release**: Migrated from `ssgo/starter` to `apigo.cc/go/starter`.
|
|
|
|
|
|
- **Background Mode**: Supports running services in the background with `-log` redirection.
|
|
|
|
|
|
- **PID Management**: Automatic PID file creation and cleanup.
|
|
|
|
|
|
- **Signal Handling**: Graceful shutdown on `SIGINT`/`SIGTERM`, reload support on `SIGHUP`.
|
|
|
|
|
|
- **Infrastructure Alignment**: Integrated with `go/file` and `go/log`.
|
