seznam/dbuilder

seznam/dbuilder镜像说明

镜像概述

seznam/dbuilder镜像旨在通过Docker为多个发行版构建具有干净依赖的软件包，确保构建环境的一致性与可靠性，无需手动配置复杂的依赖环境。所有镜像可从Docker Hub获取。

核心功能

1. 支持多种发行版标签（如debian_jessie），自动拉取对应镜像；
2. 可添加额外软件包到本地仓库，供构建过程使用（仅支持apt-based镜像）；
3. 提供预安装钩子机制，在处理构建依赖前执行自定义脚本；
4. 通过环境变量灵活控制构建参数（如子目录、并发数等）。

使用场景

• 开发人员为Debian等发行版构建软件包，需干净无干扰的依赖环境；
• 在不同发行版环境中测试软件包构建的场景；
• 需要自定义构建流程（如添加预安装脚本、额外依赖包）的场景。

配置说明

可选参数

1. 额外软件包：将deb包放入指定目录，挂载到/dbuilder/additional_packages卷，镜像会创建包含这些包的本地仓库；
2. 预安装钩子：将可执行脚本放入目录，挂载到/dbuilder/preinstall.d卷，脚本按数字排序执行。

环境变量

• 通用变量：
  • DBUILDER_SUBDIR：构建前切换到的子目录；
  • NCPUS：并发数；
• apt-based镜像变量：
  • DBUILDER_BUILD_CMD：默认值为dpkg-buildpackage -j${NCPUS}；
  • LOCAL_REPO_PRIORITY：设置本地仓库的Pin-Priority值。

部署示例

基础构建

bash
docker run --rm -v `pwd`:/dbuilder/sources seznam/dbuilder:debian_jessie

构建后的.deb包会出现在当前目录。

添加额外软件包

bash
# 复制额外包到deps目录
cp mypackage_1.0.9.8.2_amd64.deb ./deps/
mkdir ./deps/otherpackage_subdir/
cp otherpackage_0.22.4_all.deb ./deps/otherpackage_subdir/

# 构建并使用额外包
docker run --rm \
    -v `pwd`/deps:/dbuilder/additional_packages \
    -v `pwd`/src:/dbuilder/sources \
    seznam/dbuilder:debian_jessie

使用预安装钩子

bash
# 准备钩子脚本
cp 00-my-fixer.sh 10-prepare-environment.py ./preinstall.d/
chmod +x ./preinstall.d/*

# 执行构建
docker run --rm \
    -v `pwd`/preinstall.d:/dbuilder/preinstall.d \
    -v `pwd`/src:/dbuilder/sources \
    seznam/dbuilder:debian_jessie