2000cubits/debian-packaging

Debian Packaging Docker镜像文档

1. 镜像概述

本Docker镜像专为Debian/Ubuntu系统的软件包（.deb）构建设计，集成了完整的Debian打包工具链和依赖环境。通过容器化方式提供隔离、一致的打包环境，避免主机系统配置冲突，简化从源码到.deb包的构建流程，适用于开发者、CI/CD流水线及软件发布场景。

2. 核心功能与特性

2.1 完整工具链集成

• 包含Debian打包核心工具：dpkg-dev、debhelper、dh-make、fakeroot、build-essential
• 支持源码打包工具：dpkg-source、dpkg-buildpackage、pbuilder
• 依赖管理工具：apt-get、aptitude、equivs

2.2 环境隔离与一致性

• 基于官方Debian/Ubuntu基础镜像构建，确保环境一致性
• 独立于主机系统的依赖环境，避免版本冲突
• 支持多版本Debian/Ubuntu发行版（如buster、bullseye、jammy等）

2.3 灵活的构建支持

• 支持多架构打包（需配合QEMU模拟，如armhf、arm64）
• 可自定义构建参数（如编译选项、依赖版本）
• 集成打包验证工具（lintian、piuparts）

2.4 易用性优化

• 预设工作目录，支持挂载外部源码
• 环境变量配置支持（如维护者信息、构建架构）
• 轻量级设计，基础镜像大小<500MB

3. 使用场景

3.1 软件开发者

• 本地快速构建.deb包，无需在主机安装全套打包工具
• 测试不同Debian/Ubuntu版本兼容性（通过指定基础镜像标签）

3.2 CI/CD流水线集成

• 自动化构建流程：从源码拉取、依赖安装到.deb包输出
• 配合GitLab CI、GitHub Actions等平台实现持续打包

3.3 多版本/架构打包测试

• 在单一主机环境下测试不同Debian版本（如Stretch、Bullseye）的打包兼容性
• 通过QEMU模拟非x86架构（如ARM）的软件包构建

4. 使用方法

4.1 基础使用（docker run）

4.1.1 构建当前目录源码包

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  debian-packaging \
  dpkg-buildpackage -us -uc

• -v $(pwd):/workspace：挂载主机当前目录到容器工作目录
• -w /workspace：设置工作目录为/workspace
• dpkg-buildpackage -us -uc：跳过签名（适合测试构建）

4.1.2 指定Debian版本（通过镜像标签）

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  debian-packaging:bullseye \  # 使用Debian 11 (Bullseye)环境
  dpkg-buildpackage -us -uc

4.2 docker-compose配置示例

yaml
version: '3'
services:
  deb-builder:
    image: debian-packaging:jammy  # Ubuntu 22.04环境
    volumes:
      - ./src:/workspace  # 挂载源码目录
      - ./output:/output  # 挂载输出目录（存放生成的.deb包）
    working_dir: /workspace
    environment:
      - DEBEMAIL=dev@example.com  # 维护者邮箱
      - DEBFULLNAME="Package Maintainer"  # 维护者名称
    command: bash -c "dpkg-buildpackage -us -uc && cp ../*.deb /output/"

启动构建：

bash
docker-compose up

5. 配置参数

5.1 环境变量

5.2 挂载点

6. 注意事项

• 首次运行可能需要较长时间（需拉取基础镜像并安装依赖）
• 非x86架构构建需提前在主机安装QEMU（apt-get install qemu-user-static）
• 生产环境建议添加GPG签名（移除-us -uc参数并挂载密钥文件）