Merge branch 'main' of https://gitea.airlabs.art/zyc/video-shuoshan

docs/release-workflow.md

@@ -0,0 +1,92 @@
+# 版本发布与回滚操作文档
+
+## 流程概览
+
+```
+开发新版本 → 创建版本分支 → 推送到远程 → 合并到 main → 推送 main 触发滚动发布
+```
+
+## 操作步骤
+
+### 1. 切换到 main 分支，拉取最新代码
+
+```bash
+git checkout main
+git pull origin main
+```
+
+### 2. 创建版本分支
+
+```bash
+# 命名规范：release/vX.Y.Z
+git checkout -b release/v2.0.0
+```
+
+### 3. 在版本分支上开发、提交
+
+```bash
+git add <files>
+git commit -m "feat: 新功能描述"
+```
+
+### 4. 推送版本分支到远程
+
+```bash
+git push origin release/v2.0.0
+```
+
+### 5. 合并到 main
+
+```bash
+git checkout main
+git pull origin main
+git merge release/v2.0.0
+```
+
+### 6. 推送 main，触发 CI/CD 滚动发布
+
+```bash
+git push origin main
+```
+
+CI/CD 会自动构建 Docker 镜像并部署到 K8s 集群。
+
+## 版本回滚
+
+如果新版本上线后出现问题，回滚到上一个稳定版本：
+
+### 方式一：代码回滚（推荐）
+
+```bash
+git checkout main
+git revert --no-commit HEAD..release/v1.0.0
+git commit -m "revert: 回滚到 v1.0.0"
+git push origin main
+```
+
+> revert 会生成新提交，不会丢失任何历史代码，新版本随时可以恢复。
+
+### 方式二：K8s 快速回滚（最快）
+
+```bash
+# 回滚到上一个部署版本
+kubectl rollout undo deployment/<deployment-name> -n <namespace>
+
+# 或指定具体版本
+kubectl rollout undo deployment/<deployment-name> --to-revision=<N> -n <namespace>
+```
+
+## 分支命名规范
+
+| 类型 | 命名格式 | 示例 |
+|------|---------|------|
+| 主分支 | `main` | `main` |
+| 版本分支 | `release/vX.Y.Z` | `release/v1.0.0` |
+| 功能分支 | `feature/功能名` | `feature/user-auth` |
+| 修复分支 | `hotfix/vX.Y.Z` | `hotfix/v1.0.1` |
+
+## 当前版本分支
+
+| 分支 | 状态 | 说明 |
+|------|------|------|
+| `v1.0.0` | 稳定 | 首个正式版本 |