jenkins部署版本号控制

### Jenkins 中实现版本号控制的最佳实践

在持续集成和部署过程中，版本号管理对于追踪变更至关重要。通过合理配置 Jenkins Pipeline 可以有效管理和自动化版本号的生成与更新过程。

#### 使用 Git Tag 进行版本标记

Git tag 是一种记录特定提交点的方法，在每次发布新版本时创建标签有助于维护清晰的历史记录[^1]。可以在 Jenkinsfile 中定义构建阶段来自动打上相应的 git tag：

stage('Tagging') {
    steps {
        script {
            def version = env.BUILD_NUMBER // 或者其他自定义逻辑获取版本号
            sh "git config --global user.name 'Jenkins CI'"
            sh "echo ${version} > VERSION"
            sh "git add VERSION"
            sh "git commit -m 'Bump version to ${version}'"
            sh "git tag v${version}"
            sh "git push origin master && git push origin --tags"
        }
    }
}

#### 利用环境变量传递版本信息

为了在整个流水线中保持一致性和灵活性，可以利用 Jenkins 的内置或自定义环境变量存储并传播版本号。这使得后续步骤能够轻松访问当前使用的具体版本编号。

pipeline {
    environment {
        APP_VERSION = "${env.BRANCH_NAME}-${env.BUILD_ID}" // 组合分支名和构建ID作为版本标识符
    }
    stages {
        stage('Build'){
            ...
        }
        stage('Deploy'){
            when { expression { return params.DEPLOY } }
            steps{
                echo "Deploying application with version: ${APP_VERSION}"
                // 执行实际部署操作...
            }
        }
    }
}

#### 结合 Maven/SBT 等工具设置项目版本

如果正在使用像 Apache Maven 或 SBT 这样的构建工具，则可以通过修改 `pom.xml` 文件中的 `<version>` 字段或者 sbt 设置文件里的相应属性来进行更细粒度的版本控制。借助插件如 maven-release-plugin 能够简化这一流程，并确保发布的制品带有正确的版本标签。

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-release-plugin</artifactId>
      <configuration>
          <!-- 自动增加小版本 -->
          <autoVersionSubmodules>true</autoVersionSubmodules>
          <!-- 发布后回滚到开发版 -->
          <developmentVersion>${project.version}-SNAPSHOT</developmentVersion>
      </configuration>
    </plugin>
  </plugins>
</build>