3. CI/CD 基础回顾：Jenkins/GitLab CI/GitHub Actions 核心概念与 Pipeline 即代码

在深入 Helm 与服务网格的集成之前，必须夯实 CI/CD 流水线的基础。本章回顾三种主流 CI/CD 工具的核心概念，并重点阐述 Pipeline 即代码（Pipeline as Code） 这一现代 DevOps 实践。理解这些基础，是后续构建“流量拓扑驱动”交付流水线的关键前提。

3.1 三种主流 CI/CD 工具核心概念对比

Jenkins、GitLab CI 和 GitHub Actions 分别代表了传统自托管、平台原生集成和云原生生态三种范式。下表从关键维度进行对比：

3.2 Pipeline 即代码：核心价值与实现模式

Pipeline 即代码（Pipeline as Code）将流水线配置作为版本控制的一部分，与应用程序代码共存。这带来了以下核心价值：

• 版本化与可追溯： 每次流水线变更都记录在 Git 历史中，支持回滚和审计。
• 一致性： 开发、测试、生产环境使用相同的流水线定义，消除“在我机器上能跑”的问题。
• 代码审查： 流水线变更可以通过 Merge Request / Pull Request 进行审查，提升质量。
• 可复用性： 通过模板、函数、共享库实现流水线组件的复用。

下图展示了 Pipeline 即代码在 CI/CD 流程中的核心位置与数据流：

3.3 三种 Pipeline 定义示例

以下分别展示三种工具中一个典型“构建-测试-部署”流水线的核心定义片段。注意其语法差异与设计哲学。

3.3.1 Jenkins Declarative Pipeline (Jenkinsfile)

pipeline {
    agent any
    stages {
        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 {
            mail to: 'team@example.com', subject: 'Pipeline Failed'
        }
    }
}

3.3.2 GitLab CI (.gitlab-ci.yml)

stages:
  - build
  - test
  - deploy

build-job:
  stage: build
  script:
    - mvn clean compile
  artifacts:
    paths:
      - target/

test-job:
  stage: test
  script:
    - mvn test
  artifacts:
    reports:
      junit: target/surefire-reports/TEST-*.xml

deploy-job:
  stage: deploy
  script:
    - mvn deploy
  only:
    - main

3.3.3 GitHub Actions (.github/workflows/ci.yml)

name: CI Pipeline
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up JDK 17
        uses: actions/setup-java@v4
        with:
          java-version: '17'
      - name: Build
        run: mvn clean compile
      - name: Test
        run: mvn test
      - name: Deploy
        if: github.ref == 'refs/heads/main'
        run: mvn deploy

3.4 流水线最佳实践与避坑指南

在将 Helm 集成到 CI/CD 之前，请确保你的流水线已经遵循以下实践：