如何创建同时支持参数与代码块的Jenkins共享库？

我刚好做过类似的Jenkins共享库封装，其实Groovy本身就支持方法同时接收命名参数和代码块（闭包），官方文档可能没把这个场景单独拎出来讲，但实现起来很直接。

实现步骤： #

1. 创建共享库的vars文件
   在你的Jenkins共享库项目中，新建vars/kPod.groovy文件——这是Jenkins共享库定义自定义步骤的标准位置。

2. 编写kPod方法
   利用Groovy的特性，让方法同时接收一个参数Map和一个闭包作为参数。闭包会作为最后一个参数，这样用户调用时就能用kPod(label: label) { body }的语法：

def call(Map params = [:], Closure body) {
    // 提取传入的label参数，添加默认值防止空值报错
    def podLabel = params.label ?: "default-kpod-template"

    // 封装成你需要的podTemplate结构
    podTemplate(
        label: podLabel,
        containers: [
            containerTemplate(
                name: 'jnlp',
                image: 'someImage',
                args: '${computer.jnlpmac} ${computer.name}'
            )
        ],
        volumes: [
            hostPathVolume(
                hostPath: '/var/run/docker.sock',
                mountPath: '/var/run/docker.sock'
            )
        ]
    ) {
        // 执行用户传入的业务代码块
        body()
    }
}

使用方式： #

在你的Jenkinsfile中，先加载共享库（如果未配置全局自动加载的话），然后直接调用kPod：

@Library('your-shared-library-name') _

pipeline {
    agent none
    stages {
        stage('Test kPod') {
            steps {
                kPod(label: 'my-custom-label') {
                    // 这里写你的业务逻辑，比如构建、测试等
                    sh 'echo "Running inside the pod!"'
                }
            }
        }
    }
}

关键说明： #

• Groovy允许方法将闭包作为最后一个参数，调用时可以把闭包放在括号外面，这就是你想要的kPod(label: label) { body }语法。
• 用Map params = [:]作为第一个参数，方便后续扩展更多参数（比如自定义镜像、挂载路径等），不需要修改方法签名。
• 加入默认值params.label ?: "default-kpod-template"可以避免用户忘记传label导致的错误。

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