dockcross/manylinux1-x64

manylinux-scikit-build镜像文档

镜像概述

本镜像基于manylinux标准构建，专为在Linux x86_64/amd64架构下构建Python wheel包设计。集成scikit-build工具，简化包含C/C++扩展的Python项目构建流程，确保生成的wheel包符合PEP规范，可在多种Linux发行版中兼容运行。

核心功能和特性

• 遵循manylinux标准：符合PEP 513/571/600规范，确保wheel包跨主流Linux发行版（如Ubuntu、CentOS、Debian等）兼容性
• 架构支持：专注于x86_64/amd64架构，满足主流服务器和桌面环境需求
• 集成scikit-build：内置scikit-build工具链，简化C/C++扩展的Python包构建流程，支持CMake集成
• 完整构建环境：预安装GCC、CMake、Python开发库等必要依赖，开箱即可使用
• 多Python版本支持：通常包含Python 3.6+等主流版本，可通过环境变量指定目标版本

使用场景和适用范围

• 开发包含C/C++扩展模块的Python库，需要构建跨Linux发行版兼容的wheel包
• 科学计算、机器学习等领域依赖底层C/C++代码的Python项目构建
• CI/CD流程中自动化构建Python wheel包的场景
• 需要标准化构建环境以确保构建一致性的团队开发

使用方法和配置说明

基本使用流程

1. 拉取镜像（假设镜像名为manylinux-scikit-build:latest）：

   bash
   docker pull manylinux-scikit-build:latest
   

2. 运行容器构建wheel包：

   bash
   docker run -it --rm \
     -v $(pwd):/workspace \  # 挂载当前项目目录到容器内/workspace
     -w /workspace \         # 设置工作目录为/workspace
     manylinux-scikit-build:latest \
     bash -c "python setup.py bdist_wheel"  # 执行wheel构建命令
   

指定Python版本

通过PYTHON_VERSION环境变量指定构建使用的Python版本：

bash
docker run -it --rm \
  -e PYTHON_VERSION=3.9 \  # 指定Python 3.9
  -v $(pwd):/workspace \
  -w /workspace \
  manylinux-scikit-build:latest \
  bash -c "python setup.py bdist_wheel"

自定义CMake参数

通过CMAKE_ARGS环境变量传递额外的CMake构建参数：

bash
docker run -it --rm \
  -e CMAKE_ARGS="-DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local" \
  -v $(pwd):/workspace \
  -w /workspace \
  manylinux-scikit-build:latest \
  bash -c "python setup.py bdist_wheel"

输出目录配置

通过WHEELHOUSE环境变量指定wheel包输出目录：

bash
docker run -it --rm \
  -e WHEELHOUSE=/workspace/dist \  # 指定输出到项目dist目录
  -v $(pwd):/workspace \
  -w /workspace \
  manylinux-scikit-build:latest \
  bash -c "python setup.py bdist_wheel"

docker-compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  wheel-builder:
    image: manylinux-scikit-build:latest
    environment:
      - PYTHON_VERSION=3.8
      - CMAKE_ARGS="-DCMAKE_BUILD_TYPE=Release"
      - WHEELHOUSE=/workspace/dist
    volumes:
      - ./:/workspace
    working_dir: /workspace
    command: bash -c "python setup.py bdist_wheel"

运行构建：

bash
docker-compose up

环境变量说明