3. 流水线集成基础：CI/CD流水线概念、Jenkins/GitLab CI核心组件、流水线阶段划分

3.1 CI/CD流水线核心概念

持续集成与持续交付（CI/CD）是现代软件交付的基石。流水线（Pipeline）将代码从提交到部署的整个过程自动化、标准化，确保每次变更都能快速、可靠地到达目标环境。

3.2 流水线阶段划分与流程

一个标准的生产级流水线通常划分为以下阶段，每个阶段都有明确的入口条件与出口标准：

1. 代码检出（Checkout）：从Git仓库拉取指定分支的源代码。
2. 静态分析（Static Analysis）：执行代码规范检查、安全漏洞扫描（SAST）。
3. 单元测试（Unit Test）：运行开发者编写的单元测试用例，确保函数级正确性。
4. 构建与打包（Build & Package）：编译代码，生成Docker镜像或JAR/WAR包。
5. 镜像推送（Image Push）：将构建产物推送至制品仓库（如Harbor、Nexus）。
6. 集成测试（Integration Test）：在预发布环境部署，执行API测试、契约测试。
7. 部署准备（Deploy Prep）：准备蓝绿环境、更新配置、执行数据库迁移。
8. 生产部署（Production Deploy）：执行蓝绿切换或滚动更新。
9. 健康检查与回滚（Health Check & Rollback）：验证服务健康，失败时自动触发回滚。

3.3 Jenkins核心组件与架构

Jenkins作为最成熟的CI/CD引擎，其核心组件构成了流水线执行的基础设施：

// Jenkins Declarative Pipeline 示例（蓝绿发布片段）
pipeline {
    agent any
    environment {
        BLUE_ENV = 'blue-cluster'
        GREEN_ENV = 'green-cluster'
        ACTIVE_ENV = "${env.ACTIVE_ENV ?: 'blue'}"
    }
    stages {
        stage('Checkout') {
            steps { git 'https://git.example.com/app.git' }
        }
        stage('Build & Push') {
            steps {
                sh 'docker build -t app:${BUILD_NUMBER} .'
                sh 'docker push registry.example.com/app:${BUILD_NUMBER}'
            }
        }
        stage('Deploy to Inactive') {
            steps {
                script {
                    def targetEnv = (ACTIVE_ENV == 'blue') ? GREEN_ENV : BLUE_ENV
                    sh "kubectl apply -f k8s/${targetEnv}/deployment.yaml"
                }
            }
        }
        stage('Health Check') {
            steps {
                timeout(time: 5, unit: 'MINUTES') {
                    sh 'curl -f http://inactive-app.example.com/health'
                }
            }
        }
        stage('Switch Traffic') {
            input { message '确认切换流量？' }
            steps {
                sh 'kubectl patch service app -p \'{"spec":{"selector":{"env":"green"}}}\''
            }
        }
    }
    post {
        failure {
            echo '触发回滚流程...'
            sh 'kubectl rollout undo deployment/app'
        }
    }
}

3.4 GitLab CI核心组件与架构

GitLab CI将CI/CD能力深度集成在代码仓库中，其核心组件与Jenkins形成互补：

# .gitlab-ci.yml 示例（蓝绿发布片段）
stages:
  - build
  - test
  - deploy-blue
  - deploy-green
  - switch
  - rollback

variables:
  DOCKER_IMAGE: registry.example.com/app:${CI_COMMIT_SHORT_SHA}

build:
  stage: build
  script:
    - docker build -t ${DOCKER_IMAGE} .
    - docker push ${DOCKER_IMAGE}
  artifacts:
    paths:
      - k8s/

unit-test:
  stage: test
  script:
    - npm test
  needs: [build]

deploy:blue:
  stage: deploy-blue
  script:
    - kubectl apply -f k8s/blue/deployment.yaml
  environment:
    name: blue
    url: https://blue.app.example.com
  only:
    - main

deploy:green:
  stage: deploy-green
  script:
    - kubectl apply -f k8s/green/deployment.yaml
  environment:
    name: green
    url: https://green.app.example.com
  only:
    - main

switch:production:
  stage: switch
  script:
    - kubectl patch service app -p '{"spec":{"selector":{"env":"green"}}}'
  environment:
    name: production
    url: https://app.example.com
  when: manual
  only:
    - main

rollback:
  stage: rollback
  script:
    - kubectl rollout undo deployment/app
  when: on_failure

3.5 Jenkins与GitLab CI对比

3.6 流水线集成最佳实践

• 阶段门禁（Stage Gate）：每个阶段设置明确的准入准出条件，例如单元测试覆盖率必须≥80%才能进入构建阶段。
• 制品版本化：使用语义化版本号或Git Commit SHA标记构建产物，确保可追溯性。
• 环境隔离：开发、测试、预发布、生产环境使用独立的Kubernetes命名空间或集群，避免相互影响。
• 幂等性部署：确保同一版本多次部署结果一致，避免因环境状态差异导致部署失败。
• 回滚自动化：在流水线中预定义回滚步骤，当健康检查失败时自动执行，减少人工介入时间。
• 审计日志：记录每次部署的版本、时间、操作人、审批记录，满足合规要求。