如何在Jenkins共享库中执行Shell脚本文件

核心问题修正方向 #

你当前的代码存在两个关键问题：

1. 未正确读取共享库resources目录下的脚本内容，直接写resources/foo.sh会被识别为无效变量
2. PipelineUtils类未持有Jenkins Pipeline上下文对象，无法调用pipeline.sh这类Pipeline方法

正确实现步骤 #

1. 重构PipelineUtils工具类 #

需要通过构造方法传入Pipeline上下文，并使用libraryResource方法读取脚本内容：

class PipelineUtils implements Serializable {
    def pipeline

    // 构造方法接收Pipeline上下文
    PipelineUtils(def pipeline) {
        this.pipeline = pipeline
    }

    def shell() {
        // 读取resources目录下的foo.sh脚本内容
        def scriptContent = pipeline.libraryResource('foo.sh')
        // 执行读取到的脚本
        pipeline.sh(
            script: scriptContent,
            returnStdout: true
        )
    }
}

2. 修正流水线调用逻辑 #

创建PipelineUtils实例时，必须传入当前Pipeline的上下文（即this）：

@Library('libraryFoo') _
import f1.org.pipeline.PipelineUtils

pipeline {
    agent any
    stages {
        stage('Tag SCM') {
            steps {
                script {
                    def utils = new PipelineUtils(this)
                    // 可选：接收脚本执行的输出内容
                    def scriptOutput = utils.shell()
                    echo scriptOutput
                }
            }
        }
    }
}

3. 确认共享库目录结构 #

确保你的共享库目录层级完全符合Jenkins规范：

libraryFoo/
├── resources/
│   └── foo.sh       # 目标Shell脚本
└── src/
    └── f1/
        └── org/
            └── pipeline/
                └── PipelineUtils.groovy  # 工具类文件

关键说明 #

• libraryResource是Jenkins共享库内置方法，专门用于读取resources目录下的文件，参数只需传入相对于resources目录的路径
• 必须传递Pipeline上下文到工具类，所有Jenkins Pipeline核心方法（如sh、echo）都依赖该上下文才能正常执行
• 如果需要给foo.sh传递参数，可以在读取脚本内容后做字符串替换，或者给shell方法添加参数实现动态脚本拼接

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