dockcross/manylinux1-x86

manylinux Python Wheel构建镜像

镜像概述

本Docker镜像基于manylinux标准构建，专为在Linux x86_64/amd64架构下使用scikit-build工具链构建Python wheel包设计。它集成了构建Python C/C++扩展所需的完整环境，简化跨Linux发行版兼容的wheel包构建流程。

核心功能与特性

• 遵循manylinux标准：确保构建的wheel包兼容主流Linux发行版（如CentOS、Ubuntu、Debian等）
• 架构支持：专注于x86_64/amd64架构，满足主流服务器与桌面环境需求
• scikit-build集成：预配置scikit-build工具，简化基于CMake的Python扩展构建
• 完整工具链：包含gcc、cmake、ninja、Python开发库等构建依赖
• 多Python版本支持：根据manylinux版本预设多个Python版本（通常包含3.6+系列）

使用场景与适用范围

• 开发包含C/C++扩展模块的Python项目
• 构建需在多种Linux发行版上运行的Python wheel包
• 开源Python库发布过程中的标准化wheel构建
• 企业内部Python应用依赖的统一打包流程

使用方法与配置说明

基本使用（docker run）

bash
docker run -it --rm -v $(pwd):/workspace manylinux-scikit-build:latest \
  bash -c "cd /workspace && python setup.py bdist_wheel"

环境变量配置

构建示例

1. 挂载项目目录到容器工作区：

bash
docker run -v $(pwd):/project -w /project manylinux-scikit-build:latest

2. 使用特定Python版本构建：

bash
docker run -e PYTHON_VERSION=3.9 -v $(pwd):/project -w /project manylinux-scikit-build:latest \
  bash -c "python setup.py bdist_wheel"

3. 带额外CMake参数的构建：

bash
docker run -e CMAKE_ARGS="-DCMAKE_BUILD_PARALLEL_LEVEL=4" -v $(pwd):/project -w /project manylinux-scikit-build:latest \
  bash -c "python setup.py bdist_wheel"

docker-compose配置示例

yaml
version: '3'
services:
  wheel-builder:
    image: manylinux-scikit-build:latest
    volumes:
      - ./:/project
    working_dir: /project
    environment:
      - PYTHON_VERSION=3.10
      - BUILD_TYPE=Release
    command: bash -c "python setup.py bdist_wheel"

注意事项

• 构建产物位于项目目录下的dist/文件夹
• 确保项目根目录包含有效的setup.py或pyproject.toml配置文件
• 对于复杂依赖项目，可能需要在构建前安装额外系统库