Jenkins如何检测Commit中修改的描述文件以触发对应项目部署？

针对你的场景，我整理了两种实用的实现方式——用官方插件快速搭建，或者用自定义脚本灵活定制，都能满足「只检测修改的descriptor.txt并触发对应项目部署」的需求：

一、插件方案（推荐，快速上手） #

1. Git + Pipeline组合实现 #

Jenkins自带的Git插件已经支持检测Git提交的变更文件，搭配Pipeline插件就能轻松实现你的需求：

• 先确认Jenkins已经安装了Git Plugin和Pipeline Plugin（一般默认都有装）。
• 新建一个Pipeline任务，用下面的脚本作为核心逻辑：

pipeline {
    agent any
    stages {
        stage('检测变更并部署') {
            steps {
                script {
                    // 获取本次构建与上一次构建的差异文件列表
                    def changedFiles = sh(
                        script: 'git diff --name-only ${GIT_PREVIOUS_COMMIT} ${GIT_COMMIT}',
                        returnStdout: true
                    ).trim().split('\n')
                    
                    // 过滤出被修改的descriptor.txt文件
                    def updatedDescriptors = changedFiles.findAll { it.endsWith('descriptor.txt') }
                    
                    if (updatedDescriptors.isEmpty()) {
                        echo "没有检测到descriptor.txt的修改，终止本次构建"
                        currentBuild.result = 'ABORTED'
                        return
                    }
                    
                    // 逐个处理每个修改的项目
                    updatedDescriptors.each { descriptorPath ->
                        // 从路径中提取项目名称，比如从abc_project1/descriptor.txt拿到abc_project1
                        def projectName = descriptorPath.split('/')[0]
                        echo "开始处理项目：${projectName}"
                        
                        // 读取descriptor.txt里的目标版本号
                        def targetVersion = readFile(descriptorPath).trim()
                        echo "项目${projectName}要部署的版本：${targetVersion}"
                        
                        // 从Nexus拉取对应版本的压缩包（记得替换成你的Nexus地址和凭证）
                        withCredentials([usernamePassword(credentialsId: 'nexus-credential', usernameVariable: 'NEXUS_USER', passwordVariable: 'NEXUS_PASS')]) {
                            sh "curl -u ${NEXUS_USER}:${NEXUS_PASS} -O http://your-nexus-domain/repository/your-repo/${projectName}/${targetVersion}/${projectName}-${targetVersion}.zip"
                        }
                        
                        // 这里添加部署到远程服务器的逻辑，比如用scp+ssh，或者调用Ansible
                        sh "scp ${projectName}-${targetVersion}.zip deploy-user@your-server:/opt/deploy-temp/"
                        sh "ssh deploy-user@your-server 'unzip /opt/deploy-temp/${projectName}-${targetVersion}.zip -d /opt/apps/${projectName}/ && systemctl restart ${projectName}.service'"
                    }
                }
            }
        }
    }
}

这个脚本会自动识别本次提交中所有被修改的descriptor.txt，然后逐一处理对应项目的拉包和部署，完全不需要手动干预。

2. 辅助插件优化触发逻辑 #

如果需要更精准的构建触发控制，可以搭配：

• Generic Webhook Trigger Plugin：配置GitHub的Webhook，当有提交时把变更文件信息传给Jenkins，直接在触发阶段过滤只处理descriptor.txt的修改。不过这种方式需要配置GitHub侧的Webhook，适合有一定Jenkins配置经验的用户。
• 路径限制功能：在自由风格项目的Git源码管理设置里，添加路径限制*/descriptor.txt，这样只有当这些文件变更时才会触发构建。但这种方式会触发整个任务，还是需要额外逻辑判断具体哪个项目的文件被改了，适合简单场景。

二、自定义Shell脚本方案（灵活度更高） #

如果你不想依赖太多插件，直接在Jenkins任务里加一段Shell脚本就能搞定：

# 获取本次提交与上一次提交的差异文件
CHANGED_FILES=$(git diff --name-only $GIT_PREVIOUS_COMMIT $GIT_COMMIT)

# 处理首次构建的情况（上一次提交为空）
if [ -z "$GIT_PREVIOUS_COMMIT" ]; then
    CHANGED_FILES=$(git ls-files)
fi

# 遍历所有变更文件
for FILE in $CHANGED_FILES; do
    if [[ $FILE == */descriptor.txt ]]; then
        # 提取项目名称
        PROJECT_NAME=$(dirname "$FILE")
        # 读取版本号
        TARGET_VERSION=$(cat "$FILE")
        echo "开始部署项目：$PROJECT_NAME，版本：$TARGET_VERSION"
        
        # 从Nexus拉取包（建议用Jenkins凭证管理存密码，不要硬编码）
        curl -u $NEXUS_USER:$NEXUS_PASS -O "http://your-nexus-domain/repository/your-repo/$PROJECT_NAME/$TARGET_VERSION/$PROJECT_NAME-$TARGET_VERSION.zip"
        
        # 部署到远程服务器
        scp "$PROJECT_NAME-$TARGET_VERSION.zip" deploy-user@your-server:/opt/deploy-temp/
        ssh deploy-user@your-server << EOF
unzip /opt/deploy-temp/$PROJECT_NAME-$TARGET_VERSION.zip -d /opt/apps/$PROJECT_NAME/
systemctl stop $PROJECT_NAME.service
cp -r /opt/apps/$PROJECT_NAME/* /opt/run/$PROJECT_NAME/
systemctl start $PROJECT_NAME.service
rm /opt/deploy-temp/$PROJECT_NAME-$TARGET_VERSION.zip
EOF
    fi
done

把这段脚本加到Jenkins任务的「构建步骤」里就行，记得提前配置好Jenkins服务器到GitHub、Nexus和部署服务器的访问权限（比如SSH免密登录），还有用Jenkins的凭证管理来存储Nexus的账号密码。

三、几个关键注意点 #

• 首次构建时GIT_PREVIOUS_COMMIT变量是空的，所以脚本里要加兼容逻辑，避免报错。
• 绝对不要把Nexus或者服务器的密码硬编码在脚本里，用Jenkins的凭证管理来安全存储和调用。
• 如果部署流程比较复杂（比如需要备份旧版本、滚动重启），建议把部署逻辑封装成单独的脚本或者用Ansible、SaltStack等配置管理工具，Jenkins只负责触发调用就行。

内容的提问来源于stack exchange，提问作者Arunan