boomanaiden154/freecad

镜像概述

本Docker镜像基于Debian系统构建，内置FreeCAD软件，专为CI（持续集成）流水线环境设计。旨在提供一个即开即用的FreeCAD运行环境，避免在CI服务器上手动安装配置FreeCAD及其依赖，确保跨平台环境一致性，简化自动化工作流。

核心功能与特性

• 稳定基础：基于Debian系统，提供可靠的底层运行环境
• 预配置FreeCAD：内置完整FreeCAD软件，包含全部核心功能模块
• CI优化：支持非交互式运行模式，适配自动化脚本执行
• 轻量级设计：精简镜像体积，减少CI环境资源占用
• 广泛兼容：适配主流CI平台（GitHub Actions、GitLab CI、Jenkins等）

使用场景与适用范围

• 自动化FreeCAD模型文件验证与格式检查
• CI流程中的设计文件批量处理与转换
• 开源项目中FreeCAD相关功能的自动化测试
• 跨平台FreeCAD任务执行，确保开发与生产环境一致性
• 教育或科研场景中的FreeCAD自动化脚本运行

使用方法与配置说明

基本使用

通过docker run命令直接调用FreeCAD命令行工具：

bash
docker run --rm [镜像名称] freecad --help

在CI流水线中集成

GitHub Actions示例

在.github/workflows目录下创建工作流文件（如freecad-ci.yml）：

yaml
name: FreeCAD CI Task
on: [push]

jobs:
  freecad-validation:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run FreeCAD validation
        uses: docker://[镜像名称]
        with:
          entrypoint: freecad
          args: -c "import FreeCAD; print('FreeCAD version:', FreeCAD.Version())"

GitLab CI示例

在项目根目录创建.gitlab-ci.yml：

yaml
freecad-test:
  image: [镜像名称]
  script:
    - freecad -c "import FreeCAD; print('FreeCAD version:', FreeCAD.Version())"

挂载本地文件

将本地FreeCAD项目文件挂载到容器中进行处理：

bash
docker run --rm -v $(pwd):/workspace [镜像名称] freecad /workspace/your-model.FCStd

执行Python脚本

通过FreeCAD执行自定义Python脚本（例如批量处理模型）：

bash
docker run --rm -v $(pwd)/scripts:/scripts [镜像名称] freecad -c "exec(open('/scripts/process_models.py').read())"

环境变量

目前镜像未定义特殊环境变量，如需自定义配置，可通过-e参数传递：

bash
docker run --rm -e "FC_DEBUG=1" [镜像名称] freecad -c "import FreeCAD; print(FreeCAD.ConfigGet('Debug'))"