simplelogin/app-ci

镜像概述与主要用途

本镜像为通过CI（持续集成）流程自动构建的Docker镜像，旨在替代传统手动构建方式，实现Docker镜像构建的自动化、标准化与流程化。其核心用途是集成至CI/CD流水线中，作为自动化构建环节的产物，确保每次镜像构建过程可追溯、环境一致，并提升团队开发与部署效率。

核心功能与特性

自动化构建能力

• 无需人工干预，通过CI触发器（如代码推送、合并请求、定时任务等）自动触发镜像构建流程
• 构建过程完全由CI配置定义，减少人为操作失误

标准化构建环境

• 基于预定义的CI配置文件（如.github/workflows/docker-build.yml、.gitlab-ci.yml等）执行构建，确保每次构建的依赖、参数与步骤完全一致
• 避免因本地环境差异导致的"在我机器上能运行"问题

CI工具兼容性

• 支持主流CI/CD平台，包括但不限于：GitHub Actions、GitLab CI/CD、Jenkins、CircleCI、Travis CI等
• 可通过CI平台原生能力（如Docker Buildx、镜像缓存）优化构建速度

构建可追溯性

• 镜像版本、构建日志与CI任务、代码提交记录直接关联，便于追溯构建来源与问题排查
• 支持自动打标签（如基于Git commit hash、分支名、语义化版本）

使用场景与适用范围

适用团队与项目

• 需要频繁迭代并构建Docker镜像的开发团队
• 采用CI/CD流程进行持续开发、测试、部署的项目
• 对构建一致性、可重复性有严格要求的场景（如生产环境镜像）
• 多人协作开发，需统一构建标准的团队

典型应用场景

• 开发阶段：代码提交后自动构建测试镜像，用于单元测试或集成测试
• 预发布阶段：合并至release分支后自动构建预发布镜像，供QA测试
• 生产阶段：发布标签推送后自动构建生产镜像并推送至私有仓库
• 基础镜像更新：当基础镜像（如FROM指令中的镜像）更新时，自动触发依赖项目的镜像重构

使用方法与配置说明

CI配置示例（以GitHub Actions为例）

在项目根目录创建.github/workflows/docker-build.yml，配置自动构建流程：

yaml
name: Auto Build Docker Image

on:
  push:
    branches: [ main, develop ]  # 触发分支
    tags: [ 'v*' ]  # 标签触发（如v1.0.0）
  pull_request:
    branches: [ main ]  # PR触发（可选）

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Login to Docker Registry
        uses: docker/login-action@v3
        with:
          registry: ${{ secrets.DOCKER_REGISTRY }}  # 镜像仓库地址（如https://index.docker.io/v1/）
          username: ${{ secrets.DOCKER_USERNAME }}  # 仓库用户名
          password: ${{ secrets.DOCKER_PASSWORD }}  # 仓库密码/令牌

      - name: Extract metadata
        id: meta
        uses: docker/metadata-action@v5
        with:
          images: ${{ secrets.DOCKER_REGISTRY }}/${{ github.repository }}  # 镜像完整名称
          tags: |
            type=ref,event=branch
            type=sha,format=short
            type=semver,pattern={{version}},event=tag

      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ${{ steps.meta.outputs.tags }}
          cache-from: type=gha
          cache-to: type=gha,mode=max

核心环境变量说明

在CI配置中通常需定义以下环境变量（以密钥形式存储于CI平台）：

构建产物使用示例

构建完成后，可通过以下方式拉取并使用镜像：

bash
# 拉取镜像（需先登录仓库）
docker pull ${DOCKER_REGISTRY}/${IMAGE_NAME}:${IMAGE_TAG}

# 运行镜像（根据镜像功能调整命令）
docker run -d --name my-app ${DOCKER_REGISTRY}/${IMAGE_NAME}:${IMAGE_TAG}

注意事项

1. CI配置需确保构建环境包含Docker引擎或Docker Buildx
2. 敏感信息（如仓库凭证）必须通过CI平台的密钥管理功能存储，避免明文暴露
3. 建议启用镜像缓存（如GitHub Actions的type=gha缓存）以加速构建
4. 构建标签策略需提前规划（如语义化版本、commit hash、分支名），避免标签冲突