如何让Jenkins归档软链接指向的文件真实内容而非软链接本身？

刚好碰到过类似的场景，给你几个靠谱的解决方案，完美适配你用软链指向最新版本文件、批量归档的需求：

方案1：Shell预处理软链接，复制真实文件后归档 #

Jenkins默认的归档任务不会自动解析软链接，所以我们可以先在归档前加一步Shell脚本，把软链指向的真实文件复制到固定目录，再归档这个目录：

1. 在Jenkins任务中添加「Execute shell」步骤（Windows环境用「Execute Windows batch command」或PowerShell）
2. 写入以下脚本（以Linux为例）：

# 创建临时目录，用来存放要归档的真实文件
mkdir -p ./target_artifacts

# 假设你的软链接是./latest_build，获取它指向的真实文件绝对路径
REAL_FILE_PATH=$(readlink -f ./latest_build)

# 把真实文件复制到临时目录，也可以根据需求重命名
cp -r $REAL_FILE_PATH ./target_artifacts/

3. 后续在「Archive the artifacts」任务中，设置归档路径为 target_artifacts/**

如果是Windows环境，PowerShell脚本可以这么写：

# 创建临时目录
New-Item -ItemType Directory -Path ./target_artifacts -Force

# 获取软链接指向的真实路径
$realFilePath = (Get-Item -Path ./latest_build).Target

# 复制文件到目标目录
Copy-Item -Path $realFilePath -Destination ./target_artifacts/ -Recurse

方案2：利用Jenkins归档的原生参数（Pipeline专属） #

如果你用Jenkins Pipeline，archiveArtifacts 指令支持 followSymlinks 参数，开启后会自动解析软链接并归档真实内容：

pipeline {
    agent any
    stages {
        // 你的构建步骤...
    }
    post {
        always {
            // 直接归档软链接，开启followSymlinks参数
            archiveArtifacts artifacts: 'latest_build', followSymlinks: true
        }
    }
}

⚠️ 注意：这个参数只能解析工作区内的软链接，如果软链指向工作区外的文件，可能会因为权限问题失败，建议让软链始终指向工作区内的文件。

方案3：Pipeline动态解析软链路径归档 #

如果你的软链结构比较复杂，也可以用脚本先动态获取真实文件路径，再直接归档该路径：

pipeline {
    agent any
    stages {
        // 构建步骤...
    }
    post {
        always {
            script {
                // Linux环境获取真实路径
                def realPath = sh(script: 'readlink -f ./latest_build', returnStdout: true).trim()
                // 归档真实文件
                archiveArtifacts artifacts: realPath
            }
        }
    }
}

通用注意事项 #

• 确保Jenkins运行的Agent用户有访问真实文件的权限，避免复制或归档时出现权限报错
• 如果软链接指向的是目录，记得在归档路径中加上 ** 来递归归档所有子内容
• Windows环境下的软链处理和Linux不同，要对应使用PowerShell或批处理的命令来解析

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