trussworks/circleci

TrussWorks CircleCI任务处理镜像

镜像概述

本Docker镜像专为TrussWorks项目设计，旨在提供统一、可靠的执行环境，用于处理常见的CircleCI任务。通过预配置必要的工具和依赖，简化CI/CD流程中的任务执行，确保不同环境下任务的一致性和可重复性。

核心功能与特性

• 预配置工具链：集成CircleCI执行常见任务所需的工具和依赖，无需额外安装
• 任务标准化：统一TrussWorks项目的CI任务执行环境，减少环境差异导致的问题
• 兼容性保障：针对TrussWorks项目特点优化，确保与团队常用工作流兼容
• 轻量级设计：精简镜像体积，提高任务启动和执行效率

使用场景与适用范围

• TrussWorks团队在CircleCI中执行日常构建、测试、代码质量检查等任务
• 需要标准化CI环境，确保不同项目或分支任务执行一致性的场景
• 简化CI配置，减少重复的环境配置步骤

使用方法与配置说明

基本使用（docker run）

bash
docker run --rm -v $(pwd):/workspace trussworks/circleci-jobs:latest [任务命令]

参数说明：

• -v $(pwd):/workspace：将当前工作目录挂载到容器内的/workspace目录，用于任务执行
• [任务命令]：指定要执行的CircleCI任务命令（如构建、测试等）

环境变量配置

可通过环境变量调整镜像行为：

示例：

bash
docker run --rm -v $(pwd):/workspace -e LOG_LEVEL=DEBUG trussworks/circleci-jobs:latest test

Docker Compose配置

yaml
version: '3'
services:
  circleci-job:
    image: trussworks/circleci-jobs:latest
    volumes:
      - ./:/workspace
    environment:
      - CI_PROJECT_DIR=/workspace
      - LOG_LEVEL=INFO
    command: build

运行：

bash
docker-compose up

注意事项

• 确保挂载的工作目录包含任务执行所需的配置文件（如.circleci/config.yml）
• 根据任务需求选择合适的镜像标签，建议使用固定版本标签而非latest以确保稳定性
• 大型任务可能需要调整容器资源限制（如--memory、--cpus参数）