zhongruoyu/llvm-ports

LLVM Ports Docker镜像文档

镜像概述与主要用途

LLVM Ports Docker镜像项目旨在将LLVM Project移植到最新的Debian和Ubuntu发行版。该镜像提供预编译的LLVM工具链，同时包含对应Debian/Ubuntu发行版的默认GCC、最新版GNU Binutils（当前版本2.42）及CMake（当前版本3.29.1）。镜像托管于https://hub.docker.com/r/zhongruoyu/llvm-ports%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E5%9C%A8%E7%89%B9%E5%AE%9ADebian/Ubuntu%E7%8E%AF%E5%A2%83%E4%B8%AD%E4%BD%BF%E7%94%A8LLVM%E5%B7%A5%E5%85%B7%E9%93%BE%E7%9A%84%E5%BC%80%E5%8F%91%E3%80%81%E7%BC%96%E8%AF%91%E5%8F%8A%E8%87%AA%E5%8A%A8%E5%8C%96%E5%9C%BA%E6%99%AF%E3%80%82

核心功能与特性

完整的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拉取镜像：

bash
# 示例：拉取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工具版本

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

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

2. 编译本地项目

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

bash
# 假设项目代码位于当前目录的./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：

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

运行编译：

bash
docker-compose up

注意事项

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

许可证

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