celiangarcia/gcc7-cmake

CMake-gcc7镜像文档

镜像概述

本镜像基于官方gcc 7镜像构建，集成了CMake构建工具与gcc 7编译器，提供完整的C/C++项目编译构建环境。旨在为需要稳定gcc 7编译器版本的开发场景提供便捷的工具链支持，简化项目构建流程。

核心功能与特性

• 基于官方gcc 7镜像：确保编译器环境的稳定性与兼容性，符合官方标准配置
• 集成CMake构建工具：内置CMake，支持C/C++项目的跨平台构建配置
• 完整工具链：包含gcc、g++、make等编译工具，满足从源码到可执行文件的全流程构建需求
• 轻量级设计：在保证功能完整的前提下，最小化镜像体积，提升运行效率

使用场景与适用范围

• 需要gcc 7编译器的C/C++项目构建
• 依赖特定CMake版本（与gcc 7兼容）的项目开发
• CI/CD流程中的自动化编译环节
• 本地开发环境快速部署（无需手动配置gcc 7与CMake）

使用方法与配置说明

基本使用示例

1. 启动容器并运行CMake

将本地项目目录挂载至容器内，执行CMake配置：

bash
docker run --rm -v $(pwd):/project -w /project [镜像名称] cmake .

2. 执行项目构建

在完成CMake配置后，运行make命令进行编译：

bash
docker run --rm -v $(pwd):/project -w /project [镜像名称] make

3. 一次性完成配置与构建

bash
docker run --rm -v $(pwd):/project -w /project [镜像名称] sh -c "cmake . && make"

参数说明

• --rm：容器退出后自动删除，避免残留临时文件
• -v $(pwd):/project：将当前目录（项目根目录）挂载至容器内/project路径
• -w /project：设置容器工作目录为/project（项目挂载路径）
• [镜像名称]：实际使用的Docker镜像名称（需替换为具体镜像标签）
• cmake .：在项目目录执行CMake配置，生成Makefile
• make：执行编译构建

高级配置

如需指定CMake版本或自定义编译参数，可在运行时添加对应选项：

bash
# 指定CMake生成器（如Unix Makefiles）
docker run --rm -v $(pwd):/project -w /project [镜像名称] cmake -G "Unix Makefiles" .

# 添加编译参数（如优化级别）
docker run --rm -v $(pwd):/project -w /project [镜像名称] cmake -DCMAKE_CXX_FLAGS="-O2" .

注意事项

• 确保本地项目目录具有正确的CMakeLists.txt文件
• 若项目依赖外部库，需通过挂载或在Dockerfile中预安装相关依赖
• 如需持久化构建产物，建议通过挂载目录保留编译结果