opxhub/gbp

gbp-docker（Debian构建打包环境）

gbp-docker是一个基于git-buildpackage和Docker的Debian构建与开发环境容器，提供 opinionated（有明确设计理念）的打包工作流。

镜像概述

该镜像整合了git-buildpackage工具和Debian环境，旨在简化Debian软件包的构建、开发和调试过程，支持将构建产物输出到本地目录，便于共享和后续使用。

核心功能

1. 快速构建Debian软件包：通过简单命令即可基于本地debian/目录构建包
2. 开发调试环境：提供交互式开发容器，支持快速重建和清理操作
3. 灵活的依赖管理：可通过环境变量添加额外APT源，满足特殊依赖需求
4. 产物共享：构建产物自动存入本地pool目录，方便后续使用

使用场景

• 开发者构建Debian软件包并共享产物
• 调试Debian包构建过程中的问题
• 基于第三方APT源构建依赖特定包的Debian软件

配置说明

环境变量

• UID/GID：指定容器内运行用户的UID和GID，避免文件权限问题
• EXTRA_SOURCES：添加额外的APT源，用于解决构建依赖
• DIST：指定Debian发行版（如stretch、buster）

挂载卷

• 本地工作目录挂载到/mnt：用于传递源代码和接收构建产物
• 本地.gitconfig挂载到/etc/skel/.gitconfig：同步git配置

部署示例

快速构建

假设本地./src目录包含debian/目录，执行以下命令构建：

bash
docker run -it --rm -v "$(pwd):/mnt" -e UID=$(id -u) -e GID=$(id -g) opxhub/gbp:stretch build src

构建产物将存入./pool/stretch-amd64/src/目录。

开发环境启动

启动交互式开发容器：

bash
docker run -it --rm \
  --name=${USER}-dbp-$(basename $(pwd)) \
  --hostname=stretch \
  -v "$(pwd):/mnt" \
  -v "$HOME/.gitconfig:/etc/skel/.gitconfig:ro" \
  -e UID=$(id -u) \
  -e GID=$(id -g) \
  -e EXTRA_SOURCES \
  opxhub/gbp:stretch-dev

容器内可使用gbp buildpackage、fakeroot debian/rules build等命令进行开发调试。

添加额外APT源

例如，添加OpenSwitch源构建依赖：

bash
export DIST=stretch
export EXTRA_SOURCES="
deb     http://deb.openswitch.net/stretch stable opx opx-non-free
deb-src http://deb.openswitch.net/stretch stable opx
"
docker run -it --rm \
  --name=${USER}-dbp-$(basename $(pwd)) \
  --hostname=${DIST} \
  -v "$(pwd):/mnt" \
  -v "$HOME/.gitconfig:/etc/skel/.gitconfig:ro" \
  -e UID=$(id -u) \
  -e GID=$(id -g) \
  -e EXTRA_SOURCES \
  opxhub/gbp:${DIST}-dev

构建镜像本身

1. 从模板生成Dockerfile：

bash
make update

2. 构建特定发行版镜像：

bash
make DIST=stretch
make DIST=buster