Jenkins CI/CD 自动化：Pipeline as Code 实践

FreeGuideOnline 最新 2026-06-12

Jenkins 持续集成与交付流水线

什么是持续集成与持续交付（CI/CD）

持续集成（CI）是将开发人员的代码变更高频次地合并到主干分支，并通过自动化构建与测试快速发现问题的实践。持续交付（CD）则在此基础上，确保软件可以随时可靠地部署到生产环境。Jenkins 作为一款开源的自动化服务器，通过丰富的插件生态，能够灵活构建 CI/CD 流水线，让构建、测试、部署这些重复性工作全自动运行。

Jenkins 中的 Pipeline as Code

Jenkins Pipeline 是一套运行在 Jenkins 上的工作流框架，它将原本独立运行的单个任务串联起来，实现从代码提交到生产部署的复杂流程编排。而“Pipeline as Code”的核心思想是将流水线的定义写入一个文本文件（通常命名为 Jenkinsfile），并和项目源代码一起纳入版本管理。这样做的好处有：

  • 可重复且可审查：流水线和代码一起进行版本控制，任何修改都有记录。
  • 团队协作：开发、测试、运维人员可以在同一个文件中定义和维护构建、测试、部署步骤。
  • 可编程化：支持条件判断、循环、并行执行等逻辑，能够应对复杂场景。

声明式与脚本式流水线

Jenkins Pipeline 提供两种语法：声明式（Declarative）和脚本式（Scripted）。声明式语法更结构化，入门门槛低，是官方推荐的方式；脚本式语法基于 Groovy，提供了更高的灵活性。

声明式 Pipeline 基本结构

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean compile'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }
        stage('Deliver') {
            steps {
                sh 'mvn package'
            }
        }
    }
}
  • pipeline：最外层块，代表整个流水线。
  • agent：指定执行环境，any 表示任意可用代理。
  • stages：包含一个或多个 stage，用于划分不同阶段。
  • steps：每个阶段内的具体操作。

编写你的第一个 Jenkinsfile

假设我们有一个 Java Maven 项目，目标是在代码推送后自动构建、单元测试、打包并归档制品。我们将以下内容保存为项目根目录下的 Jenkinsfile。

pipeline {
    agent any

    tools {
        maven 'maven-3.8'        // 在 Jenkins 全局工具配置中定义的 Maven 名称
    }

    stages {
        stage('Checkout') {
            steps {
                git url: 'https://github.com/yourname/your-repo.git', branch: 'main'
            }
        }

        stage('Build & Test') {
            steps {
                sh 'mvn clean verify'
            }
            post {
                always {
                    junit '**/target/surefire-reports/*.xml'
                }
            }
        }

        stage('Package') {
            steps {
                sh 'mvn package -DskipITs'
            }
        }

        stage('Archive Artifact') {
            steps {
                archiveArtifacts artifacts: 'target/*.jar', fingerprint: true
            }
        }
    }

    post {
        success {
            echo 'Pipeline 执行成功！'
        }
        failure {
            echo 'Pipeline 执行失败，请检查日志。'
        }
    }
}

关键步骤详解

环境配置（tools）

在声明式流水线中，可以通过 tools 指令自动安装并配置指定工具（如 JDK、Maven、Gradle、NodeJS 等），前提是你在 Jenkins 的 Manage Jenkins → Tools 中已经完成了对应工具的配置。

源码管理

首选通过 checkout scm 方式自动拉取源码，但如果需要更精确的控制，也可以直接使用 git 步骤指定仓库地址和分支。

构建与测试

利用 sh（Linux）或 bat（Windows）执行 Maven 命令。verify 阶段会同时运行单元测试，通过 junit 步骤收集测试报告，让 Jenkins 可以展示测试趋势图表。

制品归档

使用 archiveArtifacts 将构建产物（如 jar、war 包）保存到 Jenkins 主节点上，并可通过指纹追踪。这些制品在后续的部署阶段或手动下载时非常有用。

post 条件处理

post 块可以根据流水线或阶段的执行结果执行特定操作，例如构建失败时发送邮件通知、成功时清理临时文件等。常用条件有 always、success、failure、unstable、changed。

将 Jenkinsfile 集成到项目中

  1. 在 Jenkins 中创建一个 Pipeline 类型的任务。
  2. 在流水线定义处选择 Pipeline script from SCM。
  3. 选择 SCM 类型为 Git，填写仓库地址和分支。
  4. 指定脚本路径（默认为 Jenkinsfile）。
  5. 保存后，Jenkins 会自动拉取仓库中的 Jenkinsfile 并执行。

此后每次推送代码，只要触发 Webhook 或轮询检测到变更，流水线就会自动运行。

高级实践：多环境交付流水线

在实际项目中，往往需要依次部署到开发、测试、生产环境。可以通过 when 条件判断分支名称，实现仅当合并到特定分支时才执行部署。

pipeline {
    agent any
    parameters {
        choice(name: 'ENV', choices: ['dev', 'staging', 'prod'], description: '请选择部署环境')
    }
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
        stage('Deploy to Dev') {
            when {
                branch 'develop'
            }
            steps {
                sh './deploy.sh dev'
            }
        }
        stage('Deploy to Production') {
            when {
                branch 'main'
                beforeAgent true
            }
            input {
                message '是否继续部署到生产环境？'
                ok '确认部署'
                submitter 'admin,release-team'
            }
            steps {
                sh './deploy.sh prod'
            }
        }
    }
}
  • parameters 允许手动选择部署环境。
  • when { branch 'develop' } 只有当分支为 develop 时才执行该阶段。
  • input 在部署生产前暂停流水线，等待授权人员确认，避免误操作。

并行执行与可视化

对于拥有多个子模块的项目，可以让构建或测试阶段并行执行，缩短整体耗时。使用 parallel 块即可：

stage('Parallel Tests') {
    parallel {
        stage('Unit Tests') {
            steps {
                sh 'mvn test'
            }
        }
        stage('Integration Tests') {
            steps {
                sh 'mvn verify -P integration'
            }
        }
    }
}

Jenkins 的 Blue Ocean 插件提供了现代化的流水线可视化界面，能够直观展示每个阶段的执行状态、耗时和日志，推荐安装使用。

常见问题与调试技巧

  • 语法错误：使用“流水线语法”生成器（Pipeline Syntax）页面快速构建步骤片段，或使用 replay 特性即时修改流水线脚本重放运行。
  • 环境变量：可通过 env.WORKSPACE、env.BUILD_NUMBER 获取，或用 withEnv 设置临时变量。
  • 凭证管理：敏感信息（如密码、Token）应存储在 Jenkins 凭据库中，通过 credentials() 方法引用，切忌硬编码。
  • 日志定位：点击任意构建号，进入 Console Output 查看完整执行日志；Blue Ocean 界面也会高亮显示失败步骤。

总结

将流水线以代码方式管理是 DevOps 文化的重要体现。通过 Jenkins Pipeline 和 Jenkinsfile，你可以拥有完全版本化、可复现、可审查的 CI/CD 流程。从简单的自动编译，到复杂的多分支多环境交付，Jenkins 都能胜任。现在就在你的项目中添加一个 Jenkinsfile，迈出持续集成与持续交付的关键一步。