LLVM Ports Docker镜像文档

镜像概述与主要用途

LLVM Ports Docker镜像项目旨在将LLVM Project移植到最新的Debian和Ubuntu发行版。该镜像提供预编译的LLVM工具链，同时包含对应Debian/Ubuntu发行版的默认GCC、最新版GNU Binutils（当前版本2.42）及CMake（当前版本3.29.1）。镜像托管于Docker Hub，适用于需要在特定Debian/Ubuntu环境中使用LLVM工具链的开发、编译及自动化场景。

核心功能与特性

完整的LLVM工具链

镜像包含以下LLVM核心组件：

• LLVM Core库
• Clang编译器
• Extra Clang Tools
• LLD链接器
• LLDB调试器
• MLIR中间表示框架
• Polly优化器
• compiler-rt运行时库
• libc++、libc++ ABI标准库
• libunwind unwind库
• OpenMP并行编程支持

多版本与多发行版支持

支持的LLVM版本

支持的Debian/Ubuntu发行版

镜像变体

提供"slim"变体，通过动态链接LLVM和Clang库显著减小镜像体积，但可能导致性能损失。详细说明参见LLVM官方文档。

使用场景与适用范围

• LLVM工具链开发：需要特定LLVM版本进行编译器开发或调试
• C/C++项目编译：使用Clang/LLVM编译跨平台或发行版特定项目
• CI/CD环境集成：在自动化流程中提供一致的LLVM工具链环境
• 教育与实验：快速测试不同LLVM版本或发行版下的代码行为
• 资源受限环境：使用"slim"变体在存储空间有限的场景中部署

使用方法与配置说明

镜像标签格式

镜像标签遵循version[-variant]-codename格式，各部分含义：

• version：LLVM版本（如15.0.7、14）
• variant（可选）：变体标识，当前仅支持slim
• codename：Debian/Ubuntu发行版代号（如jammy、bullseye）

示例：

• 15.0.7-jammy：Ubuntu 22.04 (Jammy) 上的LLVM 15.0.7
• 14-slim-bullseye：Debian 11 (Bullseye) 上的LLVM 14最新版"slim"变体

获取镜像

从Docker Hub拉取镜像：

# 示例：拉取Ubuntu 22.04上的LLVM 18.1.3
docker pull zhongruoyu/llvm-ports:18.1.3-jammy

# 示例：拉取Debian 11上的LLVM 14 "slim"变体
docker pull zhongruoyu/llvm-ports:14-slim-bullseye

运行容器示例

1. 检查LLVM工具版本

# 查看Clang版本
docker run --rm zhongruoyu/llvm-ports:17-jammy clang --version

# 查看LLD版本
docker run --rm zhongruoyu/llvm-ports:16-bullseye lld --version

2. 编译本地项目

挂载本地代码目录到容器中编译：

# 假设项目代码位于当前目录的./src
docker run -it --rm -v $(pwd)/src:/app zhongruoyu/llvm-ports:18-bookworm bash

# 在容器内编译（示例）
cd /app
clang main.c -o main -fopenmp  # 使用Clang编译并链接OpenMP

3. 使用docker-compose配置

创建docker-compose.yml：

version: '3'
services:
  llvm-build:
    image: zhongruoyu/llvm-ports:15-slim-focal
    volumes:
      - ./project:/workspace
    command: bash -c "cd /workspace && cmake . && make"

运行编译：

docker-compose up

注意事项

• "slim"变体因动态链接可能导致编译/运行性能下降，生产环境建议优先使用默认变体
• 不同LLVM版本可能与特定发行版存在兼容性差异，建议参考LLVM官方兼容性文档
• 完整镜像标签列表参见Docker Hub Tags

许可证

本项目采用GPL-3.0许可证。