Jenkins Kubernetes Pipeline DSL无法读取自定义容器配置问题求助

直接根因 #

你当前的配置存在两个语法级错误，直接导致自定义配置未被识别：

1. 参数使用错误：yamlFile参数用于读取Jenkins工作区中的YAML文件路径，你直接传入内联YAML内容，需要改用yaml参数。
2. Pod YAML结构错误：
   • containers、volumes字段属于spec层级，你错误写在了metadata层级下，Kubernetes无法识别
   • namespace是metadata的一级字段，你错误写在了labels子层级下

修正后的配置示例 #

pipeline {
    agent {
        kubernetes {
            cloud 'apps-dev'
            // 内联YAML使用yaml参数
            yaml '''
apiVersion: v1
kind: Pod
metadata:
  # namespace是metadata一级字段
  namespace: jenkins-jobs
  labels:
    jenkins/label: jenkins-apps-dev-agent
spec:
  # containers必须放在spec下
  containers:     
    - name: mavenjdk11
      image: maven:3.8.2-adoptopenjdk-11
      resources:
        limits:
          memory: "512Mi"
          cpu: "500m"
        requests:
          memory: "256Mi"
          cpu: "100m"
      command:
        - sleep
      args:
        - 99d 
  # volumes也放在spec下
  volumes:
    - name: sharedvolume
      emptyDir: {}                             
'''
        }
    }
    stages {
        stage('执行Cucumber测试') {
            steps {
                // 必须指定在自定义容器内执行命令，否则默认运行在jnlp容器
                container('mavenjdk11') {
                    sh 'mvn test'
                }
            }
        }
    }
}

其他排查点（如果修正后仍有问题） #

• 检查Jenkins Kubernetes插件中apps-dev云的配置，是否开启了禁止用户自定义Pod模板的限制，部分企业级配置会强制使用全局预设模板，不允许Pipeline内自定义
• 确认apps-dev集群中绑定给Jenkins的服务账号，有jenkins-jobs命名空间下的Pod创建、管理权限
• 如果需要合并全局预设模板和自定义配置，可添加inheritFrom: '你的全局模板名'和merge: true参数，确保自定义配置不会被全局模板覆盖

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