如何在Jenkins Pipeline中解压.7z格式的7zip文件

1. 自定义Utility Steps插件支持.7z解压 #

• 核心逻辑：扩展插件的解压格式判断与处理模块，加入7z格式支持
• 操作步骤：
  • 获取Utility Steps插件源码，找到负责解压的核心类（如处理Zip的ZipArchiver相关实现）
  • 引入支持7z解析的依赖（推荐org.apache.commons:commons-compress，该库原生支持7z格式）
  • 修改格式识别逻辑：当文件后缀为.7z时，切换为7z解压逻辑，调用Commons Compress的SevenZFile API处理
  • 编译打包自定义插件包，上传至Jenkins实例完成安装
• 注意：需熟悉Jenkins插件开发规范，确保修改后的逻辑兼容原有Zip解压功能

2. 修复CMD解压.7z命令 #

首先确认Jenkins节点已安装7-Zip工具，可通过两种方式调用：

环境变量已配置7z路径 #

7z x "path/to/target/file.7z" -o"path/to/output/folder" -y

指定7z完整安装路径 #

"C:\Program Files\7-Zip\7z.exe" x "path/to/target/file.7z" -o"path/to/output/folder" -y

• 参数说明：
  • x：保留原目录结构解压
  • -o：指定输出目录，注意-o与目录路径之间无空格
  • -y：自动确认所有交互提示，避免阻塞Pipeline
• 常见问题排查：
  • 命令报错“7z不是内部或外部命令”：检查7-Zip是否安装，或是否将其路径加入系统环境变量
  • 路径解析错误：路径含空格时必须用双引号包裹
  • 输出目录不存在：提前用mkdir创建目录，示例：

    mkdir "path/to/output/folder" && "C:\Program Files\7-Zip\7z.exe" x "path/to/target/file.7z" -o"path/to/output/folder" -y
    

3. 其他可行解决方案 #

直接在Pipeline中调用系统命令（最快捷） #

无需额外插件，通过bat（Windows）或sh（Linux）步骤执行7z命令：

pipeline {
    agent any
    stages {
        stage('Unpack 7z Archive') {
            steps {
                // Windows节点
                bat '''
                    "C:\\Program Files\\7-Zip\\7z.exe" x "your-archive.7z" -o"unpacked-dir" -y
                '''
                // Linux节点（需预先安装p7zip-full）
                // sh '7z x your-archive.7z -ounpacked-dir -y'
            }
        }
    }
}

使用Groovy代码直接解压（无需外部工具） #

借助Apache Commons Compress库，在Pipeline中编写Groovy脚本完成解压：

@Grab('org.apache.commons:commons-compress:1.24.0')
import org.apache.commons.compress.archivers.sevenz.SevenZFile
import org.apache.commons.compress.utils.IOUtils
import java.io.File

def unpack7z(String sourcePath, String destDir) {
    def sevenZFile = new SevenZFile(new File(sourcePath))
    def destDirectory = new File(destDir)
    destDirectory.mkdirs()
    
    def entry
    while ((entry = sevenZFile.getNextEntry()) != null) {
        if (!entry.isDirectory()) {
            def outputFile = new File(destDirectory, entry.getName())
            outputFile.getParentFile().mkdirs()
            def outputStream = new FileOutputStream(outputFile)
            IOUtils.copy(sevenZFile, outputStream)
            outputStream.close()
        }
    }
    sevenZFile.close()
}

pipeline {
    agent any
    stages {
        stage('Extract 7z File') {
            steps {
                script {
                    unpack7z('path/to/your/archive.7z', 'path/to/extract/folder')
                }
            }
        }
    }
}

• 注意：若Jenkins安全策略禁止@Grab，需在全局脚本审批中允许相关操作，或提前在节点部署Commons Compress依赖

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