解决Jenkins使用 Git 参数插件拉取 commit 列表缓慢问题

Jenkins使用 Git 参数插件拉取 commit 列表缓慢问题

项目问题

• 在 Jenkins 中使用 Git 参数插件 进行参数化构建，具有多方面的重要性和好处。这不仅提高了构建的灵活性和透明度，还能大大提升开发和运维效率。以下是使用 Jenkins commit 列表的一些关键好处和其重要性：

1. 灵活性和精确性：- 选择特定版本构建：开发人员和运维人员可以选择特定的 Git commit、标签或分支进行构建。这对于需要回滚到之前的稳定版本、验证特定提交或进行分支构建非常重要。- 精确调试和测试：在调试或测试时，可以精确选择导致问题的提交进行构建和测试，迅速定位问题所在。
2. 增强透明度和可追溯性：- 可见的版本控制：所有的提交记录都可以在 Jenkins 中显示和选择，这使得版本控制更加透明，任何人都可以看到和选择构建哪个版本。- 构建历史记录：每次构建都与特定的 commit 关联，方便回溯和查看每个构建的来源和变化内容。
3. 提高开发效率：- 快速验证和集成：开发人员可以在 Jenkins 中选择提交后立即进行构建和测试，快速验证代码的正确性和集成效果。- 减少重复劳动：通过选择特定 commit 进行构建，减少了手动下载代码、切换分支和提交的繁琐步骤，提高了开发效率。
4. 方便回归测试和部署：- 回归测试：在发现新版本存在问题时，可以迅速回退到之前的稳定版本进行回归测试，确保问题得到有效解决。- 版本部署：运维人员可以选择特定的 commit 进行部署，确保部署的版本是经过验证和测试的，降低了发布风险。
5. 支持复杂的构建需求：- 多分支构建：支持对多个分支进行并行构建和测试，满足复杂的开发和集成需求。- 多环境构建：通过选择不同的 commit 或分支，分别构建和部署到不同的环境（如开发、测试、生产），确保各个环境的版本一致性和稳定性。

问题描述

• 在 Jenkins 中，如果使用 Git 参数插件（Git Parameter Plugin）来选择 Git 标签或修订号进行参数化构建，有时可能会遇到拉取 commit 列表非常慢的问题。这通常是因为在拉取这些信息时，需要克隆整个项目，特别是当你的连接速度较慢或项目很大的时候，这个过程会非常耗时。

解决方案

在大多数情况下，我们只需要部署最新的 commit 版本，只有在需要回滚时才会采用以前的 commit。因此，可以通过提供按 commit 版本和最新分支两种构建方式，提高部署效率和灵活性。以下是优化后的详细描述：

提供按 Commit 版本和最新分支两种构建方式的好处

1. 部署最新版本的效率：- 直接部署最新版本：在大多数情况下，开发和运维团队只需要部署最新的代码版本。在这种情况下，通过 Jenkins 可以直接选择最新 分支进行构建和部署，而不需要等待加载完整的 commit 列表。这种方式大大减少了部署的等待时间，提升了部署效率。- 实时性和及时性：直接使用最新版本进行部署，确保最新的功能和修复能够及时发布，满足快速迭代和持续交付的需求。
2. 版本回滚的灵活性：- 选择特定 commit 版本：在需要进行版本回滚时，可以通过 Jenkins 提供的 commit 列表选择特定的 commit 进行构建和部署。这种方式确保在出现问题时，能够迅速回退到之前的稳定版本，减少对生产环境的影响。- 问题定位和修复：通过选择特定的 commit 版本，可以精确定位和验证引入问题的提交，快速进行修复和重新部署。

具体实现

在 Jenkins 中，采用 Extended Choice Parameter 插件，可以实现按需选择构建最新 commit 或从 commit 列表中选择特定版本的功能。通过设置选项 LatestCommit，当选中该按钮时，可以直接选择构建最新 commit，无需等待列表获取；未选中时，则使用 commit 列表拉取的方式。以下是具体的实现方法：

1. 安装 Extended Choice Parameter 插件

• 登录到 Jenkins 的管理界面，导航到 “Manage Jenkins” -> “Manage Plugins”。
• 在 “Available” 标签页中搜索 “Extended Choice Parameter” 插件并安装。

1. 配置构建参数

• 在需要配置的 Jenkins Job 中，导航到 “配置”（Configure）页面。
• 在 “This project is parameterized” 部分，添加一个 “Extended Choice Parameter” 类型的参数。

1. 配置 LatestCommit 选项

• Name：设置参数名称，例如 LatestCommit。
• Description：设置描述，例如 选择 true 构建最新 commit，无需等待列表获取；选择 false 使用 commit 列表。
• Parameter Type：选择 Boolean Choice Parameter。
• Value Choices：添加两个值：true 和 false。
• Default Value：可以设置默认值为 false。

1. 安装 Git Parameter 插件

• 登录 Jenkins 管理界面，导航到 “Manage Jenkins” -> “Manage Plugins”。
• 在 “Available” 标签页中搜索 “Git Parameter” 插件并安装。

1. 配置选择 commit 版本的参数

• 添加一个 Git Parameter 类型的参数。
• Name：设置参数名称，例如 commit。
• Description：设置描述，例如 选择提交仓库的commit版本。
• Type：选择 修订（commit）。
• Branch：指定要拉取 commit 的分支，例如 origin/test。

1. pipeline脚本

pipeline {
    agent any
    
    environment {// 仓库地址和ID
        credentialsId ='xxxxxxxxxxxxxxx'
        url ='http://xxxxx/xxxx/xxxxxxx.git'// git分支名称
        branch ='master'}
    
    
    stages {stage('拉取代码'){
            steps {
                script {
                    def branchesConfig
                    // 判断是否是最新提交if("${LatestCommit}"=="true"){
                        branchesConfig =[[name:"refs/heads/${branch}"]]// 使用分支}else{
                        branchesConfig =[[name:"${commit}"]]// 使用特定的提交}// 执行 Git 拉取操作checkout([$class:'GitSCM',
                         branches: branchesConfig,
                         doGenerateSubmoduleConfigurations:false,
                         extensions:[],
                         userRemoteConfigs:[[credentialsId:"$credentialsId", url:"$url"]]])}}}}}

1. 优化后的效果