4. CI/CD 流水线核心概念与声明式/脚本式对比

CI/CD 流水线是现代 DevOps 实践的自动化骨架。本章从核心概念出发，对比两种主流的流水线定义方式——声明式流水线与脚本式流水线，帮助你在实际项目中做出正确的技术选型。

4.1 CI/CD 流水线核心概念

一条完整的 CI/CD 流水线通常包含以下核心阶段与概念：

4.2 声明式流水线 vs 脚本式流水线

以 Jenkins Pipeline 为例，两种定义方式在语法结构、灵活性和可维护性上存在显著差异。下表从多个维度进行对比：

4.3 声明式流水线示例

以下是一个典型的声明式流水线，包含检出代码、构建、测试和部署四个阶段：

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean compile'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
            post {
                always {
                    junit 'target/surefire-reports/*.xml'
                }
            }
        }
        stage('Deploy') {
            when {
                branch 'main'
            }
            steps {
                sh 'mvn deploy'
            }
        }
    }
    post {
        failure {
            echo '流水线失败，触发告警'
        }
        success {
            echo '流水线成功完成'
        }
    }
}

4.4 脚本式流水线示例

同样的流程用脚本式实现，需要显式管理阶段和错误处理：

node {
    try {
        stage('Checkout') {
            checkout scm
        }
        stage('Build') {
            sh 'mvn clean compile'
        }
        stage('Test') {
            sh 'mvn test'
            junit 'target/surefire-reports/*.xml'
        }
        if (env.BRANCH_NAME == 'main') {
            stage('Deploy') {
                sh 'mvn deploy'
            }
        }
    } catch (Exception e) {
        echo "流水线失败: ${e.message}"
        currentBuild.result = 'FAILURE'
        throw e
    } finally {
        echo '清理临时资源'
    }
}

4.5 流水线执行流程对比图

下图展示了声明式与脚本式流水线在执行流程上的核心差异：

4.6 混合使用策略

在实际项目中，两种方式并非互斥。推荐采用以下混合策略：

• 主体使用声明式：利用其结构化语法和内置错误处理，保证流水线可读性和可维护性。
• 关键逻辑用脚本式：在 script { } 块中嵌入 Groovy 代码，处理动态参数、API 调用或复杂条件。
• 共享库统一封装：将重复的脚本逻辑提取到 Shared Library 中，声明式流水线通过 @Library 注解调用。

pipeline {
    agent any
    stages {
        stage('Dynamic Config') {
            steps {
                script {
                    // 脚本式块处理动态逻辑
                    def envName = env.BRANCH_NAME == 'main' ? 'prod' : 'dev'
                    env.DEPLOY_TARGET = envName
                }
            }
        }
        stage('Deploy') {
            steps {
                // 声明式步骤调用共享库
                deployToKubernetes(namespace: env.DEPLOY_TARGET)
            }
        }
    }
}

4.7 流水线核心概念关系图

下图展示了 CI/CD 流水线中各核心概念之间的依赖与数据流关系：

4.8 选型决策矩阵

根据团队规模、项目复杂度和维护成本，以下矩阵可辅助你快速决策：