kurento/kurento-buildpackage

kurento-buildpackage

镜像源码：https://github.com/Kurento/kurento/blob/main/docker/kurento-buildpackage/Dockerfile

镜像概述

该Docker镜像用于从Kurento项目生成Debian/Ubuntu软件包（.deb文件），通过在配置正确的系统中运行https://github.com/Kurento/kurento/blob/main/ci-scripts/kurento-buildpackage.sh%E8%84%9A%E6%9C%AC%E5%AE%9E%E7%8E%B0%E3%80%82%E5%AE%83%E8%83%BD%E8%87%AA%E5%8A%A8%E5%AE%89%E8%A3%85%E6%9E%84%E5%BB%BA%E6%89%80%E9%9C%80%E7%9A%84%E6%89%80%E6%9C%89%E4%BE%9D%E8%B5%96%EF%BC%8C%E7%84%B6%E5%90%8E%E7%BC%96%E8%AF%91%E9%A1%B9%E7%9B%AE%E5%B9%B6%E7%94%9F%E6%88%90%E8%BD%AF%E4%BB%B6%E5%8C%85%E3%80%82

核心功能与特性

• 自动安装构建依赖：通过apt-get自动安装所有必要的构建依赖
• 灵活的依赖管理：可基于指定版本或 nightly 版本的Kurento依赖进行构建
• 支持本地依赖文件：可从本地目录安装.deb格式的依赖文件
• 自定义输出目录：指定生成的.deb包存放路径
• 支持代理配置：可通过HTTP代理加速apt-get下载

使用场景

• 构建Kurento Media Server模块的Debian/Ubuntu软件包
• 为特定版本的Kurento依赖构建兼容的模块包
• 在CI/CD流程中自动化生成Kurento项目的软件包

使用方法

示例用法

构建开发版本（依赖从预构建仓库下载）

构建https://github.com/Kurento/kurento/tree/main/server/module-core%E7%9A%84%E5%BD%93%E5%89%8D%E5%BC%80%E5%8F%91%E7%89%88%E6%9C%AC%EF%BC%8C%E4%BE%9D%E8%B5%96%E4%BB%8E%E9%A2%84%E6%9E%84%E5%BB%BA%E5%8C%85%E4%BB%93%E5%BA%93%E4%B8%8B%E8%BD%BD%EF%BC%9A

bash
git clone https://github.com/Kurento/kurento.git
cd kurento/server/module-core/
docker run --rm \
    --mount type=bind,src="$PWD",dst=/hostdir \
    kurento/kurento-buildpackage:focal \
    --install-kurento nightly

基于特定版本依赖构建

与上述相同，但基于特定版本（如7.0.0）的依赖构建：

将--install-kurento nightly改为--install-kurento 7.0.0。

获取更多使用方式

调用工具的--help参数查看详细使用说明：

bash
docker run --rm kurento/kurento-buildpackage:focal --help

帮助输出

$ docker run --rm kurento/kurento-buildpackage:focal --help

Kurento Debian/Ubuntu打包脚本。

此脚本用于构建所有Kurento Media Server模块，并从中生成Debian/Ubuntu软件包文件（.deb）。它会通过`apt-get`自动安装所有 required依赖，然后构建项目。

此脚本必须在Git仓库内调用。


参数
---------

--install-kurento <KurentoVersion>

  安装构建软件包所需的依赖，使用Kurento软件包仓库获取需要的包。这对于快速构建Kurento的特定组件（如"kurento-module-core"）而无需同时构建其所有依赖非常有用。

  <KurentoVersion>指定用于下载软件包的Kurento仓库版本。例如："7.0.0"，或"dev"表示 nightly 构建。通常，使用'--release'时应提供实际版本号，否则使用"dev"。

  apt-get所需的Kurento仓库行必须已存在于/etc/apt/下的某个".list"文件中。要让此脚本自动添加所需的仓库行，请使用'--apt-add-repo'。

  可选。默认：禁用。
  另见：
    --install-files
    --apt-add-repo

--install-files [FilesDir]

  安装构建软件包所需的特定依赖文件。

  [FilesDir]为可选参数，默认为当前工作目录。它指定所有.deb文件的位置，以便进行安装。

  此参数在增量构建中非常有用，此时依赖已预先构建但尚未通过`apt-get`提供（例如CI流水线中的前序任务产物）。

  '--install-files'可与'--install-kurento'一起使用。如果未提供任何'--install-*'参数，则假定所有非系统依赖均已安装。

  可选。默认：禁用。
  另见：
    --install-kurento

--srcdir <SrcDir>

  指定脚本工作的子目录。如果未指定，所有操作将在脚本调用时的当前目录中执行。

  <SrcDir>必须包含带有所有Debian文件的'debian/'目录，用于定义如何构建项目和生成软件包。

  此参数对包含子模块的Git仓库有用。直接从子模块目录运行时，如果git-buildpackage无法将子模块识别为正确的Git仓库，可能会出现问题。

  可选。默认：当前工作目录。

--dstdir <DstDir>

  指定构建完成后生成的Debian软件包文件（*.deb）的存放位置。

  可选。默认：当前工作目录。

--allow-dirty

  允许从存在未暂存和/或未提交源代码更改的工作目录构建软件包。如果未提供此选项，工作目录必须是干净的。

  注意：此选项会让`dpkg-buildpackage`跳过调用`dpkg-source`并构建仅二进制包。这便于创建测试包，但从长远来看，目标是创建符合Debian/Ubuntu策略的正式有效软件包，因此最终发布构建不应使用此选项。

  可选。默认：禁用。

--release

  构建用于发布的软件包。如果未提供此选项，软件包将构建为nightly快照版本。

  可选。默认：禁用。

--timestamp <Timestamp>

  使用提供的时间戳而非脚本运行时的日期和时间。

  <Timestamp>必须是十进制数字。理想情况下，它表示构建完成的日期和时间，也可以是任意数字。

  可选。默认：当前日期和时间，通过命令`date --utc +%Y%m%d%H%M%S`获取。

--apt-add-repo

  编辑系统配置以添加Kurento的apt-get仓库行。

  此选项会添加或编辑文件"/etc/apt/sources.list.d/kurento.list"，确保`apt-get`能够从Kurento仓库下载并安装所有 required软件包（如果该仓库行尚未存在）。

  使用此参数时，必须同时使用'--install-kurento'。

--apt-proxy <ProxyUrl>

  为apt-get使用指定的HTTP代理。这在已设置代理的环境中很有用，可节省从官方系统仓库传输数据的成本。

  <ProxyUrl>会被设置为Apt选项"Acquire::http::Proxy"。

  文档：https://manpages.ubuntu.com/manpages/man1/apt-transport-http.1.html

依赖树

• git-buildpackage
  • Python 3（pip、setuptools、wheel）
  • debuild（包'devscripts'）
    • dpkg-buildpackage（包'dpkg-dev'）
    • lintian
  • git
    • openssh-client（用于Git SSH访问）
• mk-build-deps（包'devscripts'）
  • equivs
• nproc（包'coreutils'）
• realpath（包'coreutils'）

依赖安装

bash
sudo apt-get update ; sudo apt-get install --no-install-recommends \
    python3 python3-pip python3-setuptools python3-wheel \
    devscripts \
    dpkg-dev \
    lintian \
    git \
    openssh-client \
    equivs \
    coreutils
sudo python3 -m pip install --upgrade gbp