noos-docker-images/circleci 镜像文档

镜像概述

该镜像为基于CircleCI平台的CI/CD流水线提供基础执行环境，旨在标准化和简化自动化构建、测试与部署流程。作为基础镜像，它包含运行CI/CD任务所需的核心工具链和环境配置，确保流水线执行的稳定性与一致性。

主要用途

作为CI/CD流水线的底层支撑环境，用于在CircleCI平台上执行代码拉取、依赖安装、自动化测试、构建打包及部署等关键CI/CD环节。

核心功能与特性

• 标准化执行环境：提供统一的CI/CD运行时环境，消除因环境差异导致的流水线执行问题
• 预配置工具链：集成常用CI/CD工具（如Git、Docker客户端、构建工具等），减少环境准备时间
• 多场景适配：支持多种项目类型（如Web应用、后端服务、移动应用等）的构建需求
• 轻量级优化：通过精简镜像体积和优化启动速度，提升流水线执行效率

使用场景与适用范围

• CircleCI平台上的项目自动化构建、测试、部署流程
• 需要统一CI/CD环境配置的团队或组织
• 对流水线执行效率和稳定性有较高要求的场景
• 多项目共享基础CI/CD环境的场景

使用方法与配置说明

获取镜像

从GitHub镜像仓库拉取最新版本：

docker pull github.com/noosenergy/noos-docker-images/circleci:latest

基本使用（Docker Run）

在本地或CI环境中执行基础CI任务：

docker run --rm \
  -v $(pwd):/workspace \
  github.com/noosenergy/noos-docker-images/circleci:latest \
  sh -c "cd /workspace && circleci build -c .circleci/config.yml"

Docker Compose配置示例

version: '3.8'
services:
  ci-worker:
    image: github.com/noosenergy/noos-docker-images/circleci:latest
    volumes:
      - ./:/workspace  # 挂载项目代码目录
      - /var/run/docker.sock:/var/run/docker.sock  # 如需在容器内使用Docker
    environment:
      - CIRCLE_PROJECT_REPONAME=my-project  # 项目名称
      - CIRCLE_BUILD_NUM=1001  # 构建编号
    command: ["circleci", "build", "-c", "/workspace/.circleci/config.yml"]

关键配置说明

• 数据卷挂载：通过-v参数挂载项目代码目录（如/workspace），确保容器内可访问项目文件
• 环境变量：支持CircleCI标准环境变量（如CIRCLE_PROJECT_REPONAME、CIRCLE_BUILD_NUM等），用于流水线元数据传递
• 配置文件：需配合项目根目录下的.circleci/config.yml文件定义具体CI/CD流程

注意事项

• 建议根据项目需求指定具体镜像标签（如v1.0.0），避免使用latest标签导致环境变更
• 敏感信息（如API密钥、访问令牌）应通过环境变量或密钥管理工具注入，避免硬编码
• 如需在容器内使用Docker功能（如构建镜像），需挂载Docker守护进程套接字（/var/run/docker.sock）并确保权限配置正确