jfalcou/compilers

compilers 镜像文档

镜像概述

compilers是一个基于Ubuntu的Docker镜像，专为C++20交叉编译设计。它集成了多种编译器、构建工具和跨架构编译环境，旨在为开发者提供统一、便捷的多平台C++20项目编译解决方案。

核心功能与特性

基础工具链

• 编译器：g++-10、clang++-10（支持C++20标准）
• 构建工具：cmake 3.19.3、ninja
• 辅助工具：python3、git

交叉编译支持

提供以下架构的交叉编译器：

• ARM
• AARCH64
• POWERPC
• POWERPC64
• POWERPC64LE

使用场景与适用范围

• 需为多架构（如ARM嵌入式设备、PowerPC服务器）开发C++20应用的场景
• 需要统一编译环境以消除"本地环境差异"的团队协作项目
• 需在单一环境中完成多平台构建的CI/CD流程集成
• C++20新特性验证与跨编译器兼容性测试

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull [镜像仓库地址]/compilers:latest

运行容器

bash
docker run -it --rm -v /path/to/your/project:/workspace compilers:latest

• -v /path/to/your/project:/workspace：将本地项目目录挂载到容器内的/workspace目录
• --rm：容器退出后自动删除
• -it：交互式终端模式

交叉编译示例

以ARM架构为例，在容器内执行以下命令进行项目构建：

bash
# 进入工作目录
cd /workspace

# 创建构建目录
mkdir build && cd build

# 使用cmake配置（指定ARM交叉编译器）
cmake .. -DCMAKE_CXX_COMPILER=arm-linux-gnueabihf-g++-10 -G Ninja

# 执行编译
ninja

其他架构的交叉编译只需替换对应的编译器：

• AARCH64：aarch64-linux-gnu-g++-10
• POWERPC：powerpc-linux-gnu-g++-10
• POWERPC64：powerpc64-linux-gnu-g++-10
• POWERPC64LE：powerpc64le-linux-gnu-g++-10

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  compiler:
    image: [镜像仓库地址]/compilers:latest
    volumes:
      - ./project:/workspace
    command: /bin/bash

启动容器：

bash
docker-compose up -it

注意事项

• 镜像中已预配置各架构交叉编译器路径，可直接通过编译器名称调用
• 建议将项目源代码通过卷挂载方式传入容器，避免在容器内直接修改文件
• 如需持久化构建结果，可在docker run或docker-compose中额外挂载构建输出目录