如何为参数化Jenkins项目创建归档目录链接并按参数访问构建产物？

AI 小北

2026-5-14

针对你的Jenkins参数化项目归档需求，我整理了几个实用的方案，完美解决「按client-环境分类归档+项目页面添加可浏览目录链接」的问题：

方案1：Shell脚本手动归档+用描述插件添加自定义链接（无额外插件依赖）

这个方案最灵活，完全靠Shell和轻量插件实现：

第一步：用Shell按client-env归档产物

在你的构建步骤里添加一个Shell执行步骤，把构建产物复制到按client-environment命名的归档目录里。建议把归档目录放在Jenkins的全局归档路径下，方便统一管理：

# 定义归档根目录，用Jenkins内置变量确保路径正确
ARCHIVE_ROOT="$JENKINS_HOME/archives/${JOB_NAME}"
# 生成当前构建对应的client-env目录名
TARGET_DIR="${ARCHIVE_ROOT}/${client}-${environment}"

# 创建目录（如果不存在）
mkdir -p "${TARGET_DIR}"
# 复制你的构建产物到目标目录，替换成实际的产物路径
cp -r "${WORKSPACE}/file1" "${WORKSPACE}/file2" "${TARGET_DIR}/"

第二步：给项目页面添加可浏览的归档链接

安装Description Setter Plugin（Jenkins插件市场直接搜就能装），然后在构建后步骤里添加「Set build description」，选择用Groovy脚本生成动态链接：

// 生成归档目录的访问URL
def archiveUrl = "${JENKINS_URL}job/${JOB_NAME}/../archives/${JOB_NAME}/${client}-${environment}/"
// 返回带链接的HTML内容，会显示在项目描述里
return """<a href="${archiveUrl}" target="_blank">📂 ${client}-${environment} 归档目录</a>"""

每次构建完成后，项目页面的描述区域会新增这个链接，点击就能直接浏览对应目录的文件列表（需要先在Jenkins全局配置里开启「Directory browsing」，路径：Manage Jenkins → Configure Global Security → 勾选Agent下的Directory browsing）。

方案2：用HTML Publisher插件生成友好的文件索引页

如果不想直接暴露Jenkins的原始目录，这个方案可以生成带样式的静态索引页，更美观：

第一步：Shell生成目录索引HTML

在之前的Shell脚本末尾加上一行，用tree命令生成HTML格式的目录结构（如果服务器没装tree，用apt install tree或yum install tree安装）：

# 在归档目录生成index.html索引页
tree -H "." -L 2 -o "${TARGET_DIR}/index.html" "${TARGET_DIR}"

第二步：用HTML Publisher发布索引页

安装HTML Publisher Plugin，在构建后步骤里添加「Publish HTML reports」，配置如下：

HTML directory to archive：填写${TARGET_DIR}（或者相对路径，根据你的实际情况调整）
Index page[s]：填写index.html
Report title：自定义标题，比如${client}-${environment} 归档文件列表

配置完成后，项目页面会新增一个带标题的链接，点击后就能看到带样式的文件列表，体验更好。

方案3：进阶自定义项目首页，展示所有归档目录

如果想在项目首页直接列出所有已存在的client-env归档目录，可以用Groovy脚本嵌入到项目描述里：

确保Jenkins开启了允许在描述中执行脚本（路径：Manage Jenkins → Configure Global Security → 勾选「Enable script security for Job/Item descriptions」，并添加允许的脚本内容）
进入项目的「Configure」页面，在「Description」里添加以下HTML+Groovy代码：

<div style="padding:10px; border:1px solid #ccc; border-radius:4px;">
  <h3>所有归档目录</h3>
  <ul>
    <% 
      def archiveRoot = new File("${JENKINS_HOME}/archives/${JOB_NAME}")
      if (archiveRoot.exists() && archiveRoot.isDirectory()) {
        archiveRoot.eachDir { dir ->
          def dirName = dir.name
          def url = "${JENKINS_URL}job/${JOB_NAME}/../archives/${JOB_NAME}/${dirName}/"
          out.println("<li><a href='${url}' target='_blank'>${dirName}</a></li>")
        }
      } else {
        out.println("<li>暂无归档目录</li>")
      }
    %>
  </ul>
</div>

保存后，项目首页会自动遍历并展示所有已归档的client-env目录，点击就能直接访问。

几个注意事项

权限：确保Jenkins运行用户对ARCHIVE_ROOT目录有读写权限，避免构建时出现权限错误。
磁盘清理：可以在Shell脚本里添加清理旧归档的逻辑，比如删除30天前的目录：

find "${ARCHIVE_ROOT}" -type d -mtime +30 -exec rm -rf {} \;

安全：如果Jenkins对外暴露，建议用方案2的HTML Publisher方式，避免直接暴露Jenkins的内部目录结构。

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

如何为参数化Jenkins项目创建归档目录链接并按参数访问构建产物？

方案1：Shell脚本手动归档+用描述插件添加自定义链接（无额外插件依赖） #

第一步：用Shell按client-env归档产物 #

第二步：给项目页面添加可浏览的归档链接 #

方案2：用HTML Publisher插件生成友好的文件索引页 #

第一步：Shell生成目录索引HTML #

第二步：用HTML Publisher发布索引页 #

方案3：进阶自定义项目首页，展示所有归档目录 #

几个注意事项 #