publitas/circleci

CircleCI集成Docker容器

镜像概述

本Docker容器专为CircleCI持续集成平台设计，提供与CircleCI无缝对接的运行环境，支持自动化构建、测试、部署等CI/CD全流程集成。通过标准化容器环境，确保CircleCI任务在一致的配置下执行，提升开发团队持续集成效率。

核心功能与特性

• CircleCI平台集成：支持与CircleCI API对接，实现任务触发、状态同步与结果反馈
• CI/CD流程自动化：内置基础工具链，支持代码拉取、依赖安装、构建测试、部署发布等自动化流程
• 环境一致性：提供标准化运行环境，消除"本地可运行，CI失败"的环境差异问题
• 配置灵活性：支持自定义CircleCI配置文件挂载，适配不同项目的构建需求
• 轻量级设计：基于精简基础镜像构建，启动快速且资源占用低

使用场景与适用范围

• 开发团队使用CircleCI进行持续集成/持续部署时的标准化执行环境
• 需要在隔离容器中运行CircleCI任务，避免宿主环境污染
• 多项目共享统一CI/CD工具链，简化环境配置与维护
• 本地调试CircleCI配置文件，复现远程CI环境问题

使用方法与配置说明

基本使用（docker run命令）

bash
docker run -d \
  --name circleci-integration \
  -v /local/circleci/config:/etc/circleci \  # 挂载本地CircleCI配置文件
  -v /local/project:/workspace \          # 挂载项目工作目录
  -e CIRCLECI_API_TOKEN="your_api_token" \ # CircleCI API密钥
  -e CIRCLECI_PROJECT_USERNAME="your_username" \ # 项目所属用户名/组织名
  -e CIRCLECI_PROJECT_REPONAME="your_repo" \     # 项目仓库名
  circleci-integration:latest

环境变量配置

持久化配置

通过挂载本地目录实现配置与数据持久化：

• 挂载CircleCI配置目录：-v /local/circleci/config:/etc/circleci，容器将使用本地config.yml执行CI流程
• 挂载项目工作目录：-v /local/project:/workspace，确保构建产物与中间文件可持久化存储

docker-compose配置示例

yaml
version: '3.8'
services:
  circleci-integration:
    image: circleci-integration:latest
    container_name: circleci-integration
    restart: unless-stopped
    volumes:
      - ./circleci-config:/etc/circleci
      - ./project-code:/workspace
    environment:
      - CIRCLECI_API_TOKEN=ghp_xxxxxxxxxxxxxxxx
      - CIRCLECI_PROJECT_USERNAME=my-org
      - CIRCLECI_PROJECT_REPONAME=my-project
      - WORKSPACE_DIR=/workspace
      - LOG_LEVEL=info
    networks:
      - ci-network

networks:
  ci-network:
    driver: bridge

注意事项

• 确保CircleCI API令牌具有足够权限（至少包含repo与ci作用域）
• 本地挂载的配置文件需符合CircleCI配置规范（参考CircleCI官方文档）
• 容器运行需要网络连接，确保可访问CircleCI API（[***]