bookstore/ci-cd-optimization.md

CI/CD 性能优化方案

当前问题分析

• GitHub Actions 下载耗时: checkout, setup-java 等每次都要重新下载
• Maven 依赖下载重复: 每次构建都重新下载相同的依赖
• Docker 镜像构建重复: 没有有效利用缓存层

优化方案

方案 1: 创建本地 Actions 缓存镜像

# 优化后的 workflow
- name: 📥 检出代码
  uses: actions/checkout@v4
  with:
    path: bookstore

# 使用预缓存的 Java 环境
- name: ☕ Setup Java
  uses: ./.github/actions/setup-java-cached
  with:
    java-version: '21'
    distribution: 'temurin'
    cache: 'maven'

方案 2: Maven 依赖缓存优化

- name: 📦 Maven 依赖缓存
  uses: actions/cache@v3
  with:
    path: |
      ~/.m2/repository
      ~/.m2/wrapper
    key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
    restore-keys: |
      ${{ runner.os }}-m2-

方案 3: 并行化构建

jobs:
  # 并行执行测试和构建准备
  prepare-cache:
    runs-on: ubuntu-latest
    steps:
      - name: 预热缓存
        # 下载常用依赖到缓存

  build-and-test:
    needs: prepare-cache
    runs-on: ubuntu-latest
    steps:
      - name: 使用缓存构建

方案 4: Runner 配置优化

# runner-config.yaml
runner:
  capacity: 2  # 增加并发能力
  timeout: 1h0m0s

container:
  # 预装常用工具的镜像
  default_image: "192.168.1.83:8443/bookstore/ci-base:latest"
  # 启用构建缓存
  options: |
    --mount type=volume,src=maven-cache,target=/root/.m2
    --mount type=volume,src=actions-cache,target=/opt/actions

方案 5: 轻量级 Workflow

name: Fast CI/CD

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  quick-build:
    runs-on: ubuntu-latest
    timeout-minutes: 15  # 设置超时

    steps:
      - name: 🚀 快速检出
        uses: actions/checkout@v4
        with:
          fetch-depth: 1  # 浅克隆，只取最新提交

      - name: ☕ 使用缓存 Java
        uses: actions/setup-java@v4
        with:
          java-version: '21'
          distribution: 'temurin'
          cache: 'maven'

      - name: 🔧 增量构建
        run: |
          # 只编译变更的模块
          ./mvnw compile -DskipTests -o

      - name: 🧪 智能测试
        run: |
          # 只运行相关的测试
          ./mvnw test -Dtest="*Test" -fail-never

方案 6: 预构建 CI 基础镜像

# Dockerfile.ci-base
FROM 192.168.1.83:8443/bookstore/ubuntu-ci-proxy:latest

# 预装 Java 21
RUN apt-get update && apt-get install -y openjdk-21-jdk maven

# 预下载常用 Actions
RUN mkdir -p /opt/actions && \
    git clone https://github.com/actions/checkout /opt/actions/checkout && \
    git clone https://github.com/actions/setup-java /opt/actions/setup-java

# 预热 Maven 仓库
RUN mvn dependency:resolve -DrepositoryId=central

# 设置 Maven 本地仓库路径
ENV M2_HOME=/usr/share/maven
ENV MAVEN_HOME=/usr/share/maven
ENV M2_REPO=/root/.m2/repository
VOLUME ["/root/.m2"]

WORKDIR /workspace

推荐实施顺序

1. 立即实施: Maven 缓存优化 (方案 2)
2. 短期实施: 轻量级 workflow (方案 5)
3. 中期实施: 预构建 CI 基础镜像 (方案 6)
4. 长期实施: 并行化构建 (方案 3)

预期效果

• Maven 缓存: 减少 60-80% 的依赖下载时间
• 浅克隆: 减少 90% 的代码检出时间
• 预构建镜像: 减少 50% 的环境准备时间
• 并行化: 减少 30-50% 的总执行时间

监控指标

• GitHub Actions 下载时间
• Maven 依赖下载时间
• Docker 镜像构建时间
• 整体 CI/CD 执行时间