如何透明重载Jenkins Pipeline的node块？支持Kubernetes模板自定义

当然可以！这正是Jenkins共享Pipeline库发挥威力的场景——你完全能透明重载node{}代码块，既给用户提供开箱即用的Kubernetes DinD slave默认配置，又保留他们自定义的灵活性。下面是具体的实现方案：

1. 利用共享库全局变量覆盖原生步骤 #

Jenkins允许你在隐式加载的共享库的vars目录下创建同名全局变量，直接覆盖原生的node步骤。用户在Jenkinsfile里写的node{}会自动调用你定义的版本，完全不需要他们修改代码，完美实现透明性。

核心实现代码（共享库vars/node.groovy） #

// 处理带参数的调用：比如 node('2-core') {} 或 node(yaml: '自定义YAML') {}
def call(Map args = [:], Closure body) {
    // 兼容字符串参数（比如node('2-core')）转成map格式
    if (args instanceof String) {
        args = [label: args]
    }

    // 预设默认DinD低资源Pod模板
    def defaultPodYaml = '''
apiVersion: v1
kind: Pod
spec:
  containers:
  - name: jnlp
    image: jenkins/inbound-agent:latest
    resources:
      requests:
        cpu: "0.5"
        memory: "512Mi"
      limits:
        cpu: "1"
        memory: "1Gi"
  - name: dind
    image: docker:dind
    securityContext:
      privileged: true
    resources:
      requests:
        cpu: "0.5"
        memory: "512Mi"
      limits:
        cpu: "1"
        memory: "1Gi"
'''

    // 预设可选模板映射表：用户传label即可切换
    def presetTemplates = [
        '2-core': '''
apiVersion: v1
kind: Pod
spec:
  containers:
  - name: jnlp
    image: jenkins/inbound-agent:latest
    resources:
      requests:
        cpu: "1"
        memory: "1Gi"
      limits:
        cpu: "2"
        memory: "2Gi"
  - name: dind
    image: docker:dind
    securityContext:
      privileged: true
'''
    ]

    // 确定最终使用的Pod YAML：用户参数优先，否则用默认
    def finalYaml = defaultPodYaml
    if (args.label && presetTemplates[args.label]) {
        finalYaml = presetTemplates[args.label]
    }
    // 支持用户直接传入yaml完全覆盖
    if (args.yaml) {
        finalYaml = args.yaml
    }

    // 调用Kubernetes插件的podTemplate+node组合，执行用户的代码块
    podTemplate(yaml: finalYaml, label: "dynamic-slave-${UUID.randomUUID()}") {
        node(podTemplate().label) {
            body()
        }
    }
}

// 兼容无参数的node{}调用
def call(Closure body) {
    call([:], body)
}

2. 三种支持的使用场景（完全兼容用户习惯） #

• 默认场景：用户写node{} → 自动使用你预设的DinD低资源Pod模板
• 切换预设模板：用户写node('2-core'){} → 加载你定义的2核高资源模板
• 完全自定义：用户写node(yaml: '自定义Pod YAML内容'){} → 直接使用用户提供的模板

3. 关键注意事项 #

• 透明性保障：确保共享库被配置为全局隐式加载（Jenkins全局配置里设置为"Allow default version"并勾选"Load implicitly"），这样所有Pipeline都会自动加载你的重载逻辑
• 参数优先级：一定要让用户传入的参数（比如yaml或label）优先于默认配置，避免强制用户使用固定模板
• 兼容性：覆盖所有原生node的调用方式（无参数、字符串label、map参数），避免用户代码报错
• 调试友好：可以在代码里添加日志（比如echo "Using Pod template: ${finalYaml}"），方便排查问题

4. 进阶优化建议 #

• 把Pod模板文件放在共享库的resources目录下，用libraryResource('templates/default-dind.yaml')加载，方便集中维护和版本控制
• 支持通过Jenkins全局配置或环境变量修改默认模板的资源参数（比如默认CPU限制）
• 添加参数校验逻辑，比如检查用户传入的YAML格式是否合法

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