版本发布管理

版本命名规范

常见的版本命名方式

1. 语义化版本控制（Semantic Versioning）：

   • 格式：MAJOR.MINOR.PATCH
   • 示例：1.0.0
   • 规则：
     • MAJOR：做了不兼容的API修改。
     • MINOR：新增了向下兼容的功能。
     • PATCH：做了向下兼容的问题修正。

2. 日期版本控制：

   • 格式：YYYY.MM.DD
   • 示例：2023.06.17
   • 适用场景：每日构建或持续发布。

版本标记

使用Git标签（Tag）来标记特定的版本，便于追踪和回滚。

# 创建标签
git tag -a v1.0.0 -m "Release version 1.0.0"
# 推送标签
git push origin v1.0.0

发布流程

准备发布

1. 代码冻结：在发布前一段时间，冻结代码库，只修复关键问题，不再添加新功能。
2. 检查依赖：确保所有依赖项的版本都是稳定的，避免使用未发布的依赖。

创建发布分支

创建一个新的发布分支，用于进行最终测试和发布准备。

git checkout -b release-v1.0.0

版本标记

在发布分支上创建版本标签，标记当前发布版本。

git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0

生成发布包

生成可分发的发布包，例如压缩包、安装包或Docker镜像等。

# 示例：生成压缩包
tar -czvf release-v1.0.0.tar.gz source-code/

测试与验证

在测试环境中部署生成的发布包，进行全面的回归测试，确保功能正常。

# 示例：部署到测试环境
scp release-v1.0.0.tar.gz user@testing-server:/path/to/deploy

发布到生产环境

在生产环境中部署经过测试的发布包，确保更新顺利进行。

# 示例：部署到生产环境
scp release-v1.0.0.tar.gz user@production-server:/path/to/deploy

版本回滚

在发布过程中，如果遇到重大问题，需要能够快速回滚到之前的稳定版本。

# 示例：回滚到上一个版本
git checkout v0.9.0

自动化发布

使用CI/CD工具（如Jenkins、GitLab CI、GitHub Actions）实现自动化发布流程。

# 示例：GitHub Actions配置文件
name: Release
on:
  push:
    tags:
      - 'v*.*.*'
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Set up Node.js
      uses: actions/setup-node@v2
      with:
        node-version: '14'
    - name: Install dependencies
      run: npm install
    - name: Build
      run: npm run build
    - name: Create Release
      run: npm run release

最佳实践

1. 自动化测试：在发布前自动执行单元测试和集成测试，确保代码质量。
2. 持续集成：使用CI工具自动构建和测试，减少人工操作的错误。
3. 发布前检查：建立发布检查清单，确保所有步骤都已完成。
4. 版本回滚计划：制定详细的回滚计划，确保在问题发生时能够快速响应。
5. 记录发布日志：记录每次发布的变更日志，方便回溯和审计。

示例

示例1：使用Jenkins进行版本发布

1. 创建Jenkins任务：

   • 配置Git仓库地址。
   • 配置构建触发器，如Git标签创建时触发。
   • 配置构建步骤，包括代码构建、测试、打包和部署。

2. 配置构建步骤：

   # 拉取代码
   git checkout $GIT_TAG
   
   # 构建项目
   npm install
   npm run build
   
   # 生成发布包
   tar -czvf release-$GIT_TAG.tar.gz dist/
   
   # 部署到测试环境
   scp release-$GIT_TAG.tar.gz user@testing-server:/path/to/deploy
   
   # 测试通过后，部署到生产环境
   scp release-$GIT_TAG.tar.gz user@production-server:/path/to/deploy
   

示例2：使用GitLab CI进行版本发布

1. 配置.gitlab-ci.yml文件：

   stages:
     - build
     - test
     - release
   
   build:
     stage: build
     script:
       - npm install
       - npm run build
   
   test:
     stage: test
     script:
       - npm run test
   
   release:
     stage: release
     script:
       - tar -czvf release-${CI_COMMIT_TAG}.tar.gz dist/
       - scp release-${CI_COMMIT_TAG}.tar.gz user@production-server:/path/to/deploy
     only:
       - tags
   

注意事项

1. 备份数据：在发布新版本前，备份数据库和关键数据。
2. 通知相关人员：发布前通知相关开发人员和运维团队，确保有足够的支持。
3. 监控发布过程：发布后监控系统运行状态，及时发现和解决问题。
4. 用户通知：如果发布涉及重大变更，提前通知用户，并提供升级指南。

版本发布管理是确保软件稳定可靠发布的重要环节。通过合理的版本命名规范、系统化的发布流程和自动化工具，可以提高发布效率，减少风险。制定详细的回滚计划和最佳实践，确保在问题发生时能够迅速应对。