oster/c-testing

C/C++开发与测试基础容器

镜像概述

本镜像为C/C++开发者提供了一个预配置的基础环境，集成了主流编译器（gcc、clang）、构建工具（cmake）及单元测试框架（criterion），旨在简化C/C++项目的编译、构建与测试流程，确保开发环境的一致性和可移植性。

核心功能与特性

• 多编译器支持：集成gcc和clang两种主流C/C++编译器，满足不同编译需求及兼容性测试
• 构建工具集成：包含cmake构建系统，支持跨平台项目构建配置
• 测试框架内置：集成criterion单元测试框架，支持自动化测试用例编写与执行
• 轻量级基础：基于精简基础镜像，平衡功能完整性与资源占用

使用场景

• 本地开发环境：快速搭建标准化C/C++开发环境，避免本地环境配置冲突
• CI/CD流水线：作为持续集成流程中的编译与测试环境，确保代码质量
• 教学与培训：提供统一的C/C++学习环境，降低环境配置门槛
• 跨平台验证：在同一环境中使用不同编译器验证代码兼容性

使用方法与配置说明

基本使用（docker run）

bash
# 拉取镜像（假设镜像名为cpp-dev-env）
docker pull cpp-dev-env

# 运行容器并挂载当前项目目录
docker run -it --rm -v $(pwd):/project cpp-dev-env /bin/bash

# 在容器内编译项目示例
cd /project
cmake .
make
# 执行测试（若使用criterion编写了测试用例）
./test_binary

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  cpp-dev:
    image: cpp-dev-env
    volumes:
      - ./:/project  # 挂载本地项目目录到容器内/project
    command: /bin/bash  # 启动交互式shell

启动容器：

bash
docker-compose up -d
docker-compose exec cpp-dev bash  # 进入容器

典型工作流示例

1. 在宿主机编写C/C++代码和CMakeLists.txt
2. 通过上述方法启动容器并进入
3. 执行以下命令完成构建与测试：

   bash
   # 构建项目
   mkdir build && cd build
   cmake ..
   make
   
   # 运行单元测试（假设测试目标为test）
   make test
   # 或直接执行测试二进制文件
   ./test
   

注意事项

• 确保宿主机项目目录具有适当权限，避免容器内读写文件时出现权限问题
• 如需使用特定版本的编译器或工具，可基于本镜像通过Dockerfile进一步定制
• 大规模项目建议结合卷挂载持久化构建缓存，提升构建效率