46 lines
1.3 KiB
Markdown
46 lines
1.3 KiB
Markdown
# 开发与运维
|
||
|
||
## 配置
|
||
|
||
配置路径规则为：
|
||
|
||
<BSM_Prefix>/etc/<serviceKey>_<BSM_RuntimeMode>.yaml
|
||
|
||
all 的 serviceKey 来自 --workspace，默认 default。BSM_RuntimeMode 默认 dev，BSM_SERVICES 可覆盖聚合服务列表。
|
||
|
||
## 验证
|
||
|
||
Windows：
|
||
|
||
./scripts/verify-workspace.ps1
|
||
|
||
Linux/macOS：
|
||
|
||
./scripts/verify-workspace.sh
|
||
|
||
脚本对每个 module 执行 go vet 和 go test，并检查 gofmt。依赖真实服务的测试应使用 integration tag。
|
||
|
||
## 构建
|
||
|
||
scripts/build-all-linux.sh 构建 module 下独立服务到 .builds。all 可单独构建：
|
||
|
||
cd all
|
||
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -o ../.builds/all ./cmd/main
|
||
|
||
## 发布检查
|
||
|
||
1. workspace 验证通过。
|
||
2. git diff --check 通过。
|
||
3. 配置不存在 CHANGE_ME。
|
||
4. 数据库迁移已在预发布验证。
|
||
5. Services 仅包含计划发布服务。
|
||
6. TLS、访问控制、日志脱敏和监控已配置。
|
||
7. 已准备二进制及数据库回滚方案。
|
||
|
||
## 排障
|
||
|
||
- 配置不存在：检查工作目录、BSM_Prefix、BSM_RuntimeMode 和 workspace 文件名。
|
||
- 服务未注册：检查 Services 与 BSM_SERVICES。
|
||
- 启动失败：检查端口、DSN、Redis、etcd 和迁移权限。
|
||
- gateway 404：确认 proto gateway 注册；Gin 只在 gateway 404 后接管。
|