jconstam/esp32-xtensa-ci

esp32-xtensa-ci镜像说明

镜像概述

本镜像为ESP32嵌入式C/C++项目提供完整的持续集成（CI）工具链，集成了编译、静态检查、单元测试、文档生成等核心功能所需的工具，帮助开发者快速搭建自动化构建与验证环境。

核心功能

• 编译工具：包含gcc-arm-none-eabi、cmake、ninja-build等嵌入式开发编译工具
• CI辅助工具：Mongoose OS工具mos（源码构建）、AWS CLI（亚马逊官方提供）
• 代码质量工具：cppcheck、clang-tidy、uncrustify、sloccount等静态分析与代码规范工具
• 测试工具：ceedling（单元测试框架）、pytest（Python测试）、gcovr（覆盖率分析）
• 文档工具：doxygen、graphviz、pandoc等文档生成工具
• 其他辅助工具：git、wget、zip、shellcheck等常用工具

使用场景

• ESP32嵌入式项目的自动化编译与构建流程
• 代码静态质量检查与规范验证
• 单元测试执行与覆盖率报告生成
• 项目文档自动化生成
• CI/CD流水线中的环境标准化

配置说明

1. 挂载项目目录：将本地ESP32项目目录挂载到容器内，便于工具访问源码
2. 环境变量：可根据需求设置时区（TZ）、工具路径等环境变量
3. 权限设置：确保挂载目录的读写权限与容器用户匹配

部署示例

Docker Run命令

bash
docker run -v $(pwd)/your-esp32-project:/project \
           -e TZ=Asia/Shanghai \
           jconstam/esp32-xtensa-ci \
           sh -c "cd /project && make build && cppcheck src/ && ceedling test"

Docker Compose示例

yaml
version: '3'
services:
  esp32-ci:
    image: jconstam/esp32-xtensa-ci
    volumes:
      - ./your-esp32-project:/project
    environment:
      - TZ=Asia/Shanghai
    command: sh -c "cd /project && doxygen Doxyfile && gcovr --html-details coverage.html"