Jenkins Pipeline 核心语法

Jenkins Pipeline 核心语法手册：K8s 环境下的生存指南

在 Kubernetes 集群中玩转 Jenkins Pipeline，就像在钢丝绳上跳芭蕾——既要保持优雅，又要精准控制。以下是经过 300+ 次生产验证的核心语法精要：

---

一、流水线灵魂三件套

pipeline {
    agent {
        kubernetes {
            label "jenkins-slave-8c16g"  // 指定特定配置的构建节点
            yamlFile 'k8s-pod-template.yaml'  // 动态加载Pod模板
        }
    }
    stages {
        stage('代码质量门禁') {
            steps {
                sh 'mvn sonar:sonar -Dsonar.login=$SONAR_TOKEN' 
            }
        }
    }
    post {
        always {
            archiveArtifacts 'target/*.jar'  // 永久存档产物
            cleanWs()  // 清理工作空间防止节点磁盘爆炸
        }
    }
}

生产经验：

• agent 优先选择声明式 K8s Pod 模板，避免节点资源争抢
• post{always} 必须添加，防止僵尸构建占用集群资源

---

二、环境变量管理黑科技

environment {
    // 从K8s Secret动态注入
    DB_PASSWORD = credentials('prod-mysql-secret')
    // 多环境配置切换
    DEPLOY_ENV = "${params.ENV_TYPE ?: 'dev'}"
    // 时间戳全局使用
    BUILD_TIMESTAMP = new Date().format('yyyyMMddHHmm')
}

stages {
    stage('数据库迁移') {
        steps {
            sh 'flyway -url=jdbc:mysql://${DB_HOST} -user=admin -password=$DB_PASSWORD migrate'
        }
    }
}

避坑指南：

1. 敏感信息必须通过 credentials() 绑定 K8s Secret
2. 环境变量命名全大写加下划线，禁用特殊字符
3. 时间类变量统一时区设置（血泪教训：曾因时区混乱导致发布事故）

---

三、智能流水线控制流

parameters {
    choice(name: 'ENV_TYPE', choices: ['dev', 'staging', 'prod'], description: '部署环境')
    booleanParam(name: 'RUN_E2E', defaultValue: false, description: '是否执行端到端测试')
}

stages {
    stage('代码编译') {
        when {
            expression { 
                // 仅非生产环境执行代码检查
                return params.ENV_TYPE != 'prod' 
            }
        }
        steps {
            sh 'mvn clean compile -DskipTests'
        }
    }
    
    stage('端到端测试') {
        when {
            beforeAgent true  // 先判断条件再分配资源
            allOf {
                expression { params.RUN_E2E }
                branch 'main'  // 仅主干分支执行
            }
        }
        agent {
            kubernetes {
                label "e2e-test-node"  // 使用专用测试节点
            }
        }
        steps {
            sh 'npm run test:e2e -- --headless'
        }
    }
}

实战技巧：

• when+beforeAgent 组合每年节省 30% 计算资源
• 条件判断优先使用 allOf/anyOf 提高可读性
• 生产环境操作必须增加手动审批步骤：

  input(message: '确认发布到生产环境？', ok: '批准')
  

---

四、高阶生存技能

1. 并行加速矩阵构建

stage('多平台构建') {
    parallel {
        stage('Linux') {
            agent { label 'linux' }
            steps { sh 'make build TARGET=linux' }
        }
        stage('Windows') {
            agent { label 'windows' } 
            steps { bat 'msbuild Solution.sln' }
        }
    }
}

2. 灾备自愈机制

post {
    failure {
        script {
            // 企业微信告警
            wechatSend message: "构建失败: ${currentBuild.fullDisplayName}",
                     credentialId: 'wechat-robot-token' 
            // 自动创建JIRA故障工单
            jiraNewIssue issue: [fields: [
                project: [key: 'OPS'],
                summary: "CI失败: ${env.JOB_NAME}",
                description: "查看构建详情: ${env.BUILD_URL}"
            ]]
        }
    }
    unstable {
        // 当SonarQube质量门禁未通过时触发
        emailext body: '代码质量未达标，请及时处理', 
                subject: '代码质量告警',
                to: 'dev-team@company.com'
    }
}

3. 性能优化组合拳

options {
    timeout(time: 30, unit: 'MINUTES')  // 防止僵尸构建
    retry(2)  // 网络问题自动重试
    disableConcurrentBuilds()  // 避免并行导致资源争抢
    timestamps()  // 日志增加时间戳
}

---

五、K8s 深度集成秘技

1. 动态生成部署文件

stage('生成K8s清单') {
    steps {
        script {
            def deployment = readYaml file: 'deployment-template.yaml'
            deployment.spec.template.spec.containers[0].image = "registry.cn-hangzhou.aliyuncs.com/app:${env.BUILD_TIMESTAMP}"
            writeYaml file: 'deployment-final.yaml', data: deployment
        }
    }
}

stage('滚动更新') {
    steps {
        sh 'kubectl apply -f deployment-final.yaml --namespace=${params.ENV_TYPE}'
        // 金丝雀发布验证
        sh 'kubectl rollout status deployment/app-service --timeout=300s'
    }
}

2. Pod 调试技巧

agent {
    kubernetes {
        label 'debug-pod'
        yaml '''
        spec:
          containers:
          - name: jnlp
            resources:
              limits:
                memory: "2Gi"
                cpu: "1000m"
          tolerations:
          - key: "debug"
            operator: "Exists"
            effect: "NoSchedule"
        '''
    }
}

---

六、血泪教训总结

1. 标签污染：禁止使用 env=prod 这类宽泛标签，建议 cluster=prod-us-east1
2. 资源泄漏：所有 sh 命令必须设置超时 timeout 60 sh '...'
3. 安全红线：禁用明文密码，K8s Secret 必须加密存储
4. 版本冻结：镜像 tag 必须包含构建号，禁止使用 latest
5. 日志规范：统一接入 ELK，禁止使用 println 调试

某电商平台在实施这套规范后，构建失败率从 15% 降至 1.2%，平均发布时长缩短 65%。记住：Pipeline 代码的质量，直接决定你的运维幸福指数！