Hermes Memory 四:部署管理与发布流水线

第四篇。详解 dev-deploy-pipeline、版本号门禁和 CHANGELOG 铁律。

核心原则

所有 /vol1/1000/dev/ 下的项目上线,必须走三级部署流程。这是不可跳过的硬性门禁。

DEV ──→ STAGING ──→ PROD
                    ↕
              版本号 + CHANGELOG
                    ↑
                 铁律门禁

三级部署流程

步骤详解

Step 1: DEV → 编辑代码
  /vol1/1000/dev/<project>/

Step 2: DEV → 编译/构建
  go build / npm run build / docker build

Step 3: STAGING → 部署测试
  HK VPS(或其他隔离环境)
  ↓ 失败则回退 Step 1

Step 4: 📋 版本号 + CHANGELOG(硬性门禁)
  bump 版本号 + 更新 CHANGELOG.md

Step 5: PROD → 部署生产
  /vol1/1000/Docker/<project>/

Step 6: 生产验证
  curl 健康检查 / 功能测试

Step 7: 📋 部署日志
  写入 dev 项目目录的 deploy-logs/

Step 8: 清理 Staging

铁律

规则 违反后果
禁止跳过 Staging 直上生产 回滚 + 强制补测
没 bump 版本号、没写 CHANGELOG 禁止上生产 拒绝发布
生产保留最新 .bak 文件用于回滚 发布前自动备份
非 dev 项目不受此约束 仅约束 dev 目录下的开发项目

版本管理

版本号规范

格式:v<major>.<minor>.<patch>

含义 例子
major 重大架构变更 v2.0.0
minor 功能新增 v0.2.0
patch 修复/小调整 v0.1.17

当前项目版本:

项目 最新版本
Go-TeBlog v0.1.17
Hermes v0.18.0

CHANGELOG 规范

每次发布必须更新 CHANGELOG.md,记录:

## [v0.1.17] - 2026-07-05

### Added
- 新功能描述

### Changed
- 变更说明

### Fixed
- 修复了什么

### Security
- 安全更新

典型发布流程(Go-TeBlog 为例)

# 1. DEV 编译
cd /vol1/1000/dev/Go-TeBlog-dev
go build -o go-teblog .

# 2. STAGING 部署
scp go-teblog HK-618:/tmp/
# 在 HK-618 上验证

# 3. 更新版本号
echo "0.1.18" > VERSION

# 4. 更新 CHANGELOG
echo "## [v0.1.18] - 2026-07-13" >> CHANGELOG.md

# 5. PROD 部署
cp go-teblog /vol1/1000/Docker/Go-Blog/go-teblog
docker restart go-teblog

# 6. 验证
curl https://blog.w-tx.cn/blog/

# 7. 写部署日志
cat > deploy-logs/deploy-0.1.18-20260713.md

# 8. 清理
rm /tmp/go-teblog

部署日志格式

每次部署在 deploy-logs/ 下创建:

# Deploy v0.1.18 - 2026-07-13

## 变更
- 修复了什么 bug
- 新增了什么功能

## 验证
- curl 返回 HTTP 200
- 文章列表正常加载
- 评论功能正常

## 回滚方案
- /vol1/1000/Docker/Go-Blog/go-teblog.bak 保留

监控与健康检查

每天 cron 自动巡检三台机器:

检查项 频率 告警方式
Docker 容器运行状态 每天 08:00 企微推送
磁盘使用率 每天 08:00 企微推送
内存使用率 每天 08:00 企微推送
博客 HTTP 200 每天 08:00 企微推送
三机 SSH 可达性 每 5 分钟 企微推送

异常时发送企业微信通知,确保第一时间响应。


一句话总结

代码改好 → 测试环境验证 → 写版本号 + CHANGELOG → 上线 → 验证 → 记录日志。没写 CHANGELOG 的门禁,不开。

没有这个流水线的项目(如脚本工具、一次性任务)不受约束,但所有 dev 目录下的正式项目都必须遵守。


下一篇:Memory 五 — 决策框架与 PAOS,详解七步决策法和个人 AI 操作系统路线图。

标签: none

暂无评论

评论已关闭

此文章的评论功能已关闭。