DEB Package CI/CD

本文档说明了 chsrc 项目的 DEB 包自动构建和发布流程。

自动触发

DEB 包构建 CI 会在以下情况下自动触发：

Release 事件: 当创建新的 release 时自动构建并上传 DEB 包到 release assets
手动触发: 可以在 GitHub Actions 页面手动触发构建

支持的架构

当前支持以下架构的 DEB 包构建：

amd64 (x86_64)
arm64 (aarch64)
armhf (ARMv7)

构建产物

每次构建会生成：

DEB 包文件: chsrc_<version>-1_<arch>.deb
仓库元数据: Packages 和 Packages.gz 文件用于创建 APT 仓库

本地测试

构建 DEB 包

# 准备构建环境
sudo apt-get install build-essential debhelper devscripts fakeroot

# 构建包
make deb-build

# 清理构建产物
make deb-clean

测试安装

# 安装生成的包
sudo dpkg -i ../chsrc_*.deb
sudo apt-get install -f  # 修复依赖问题

# 运行测试
./test/deb-test.sh

# 卸载
sudo apt-get remove chsrc

文件结构

debian/
├── changelog      # 版本更新日志
├── compat         # debhelper 兼容性版本
├── control        # 包控制信息和依赖
├── copyright      # 版权信息
├── postinst       # 安装后脚本
├── prerm          # 卸载前脚本
└── rules          # 构建规则

手动发布流程

确保所有代码已合并到主分支
更新版本号和 changelog
创建并推送 git tag: git tag v1.2.3 && git push origin v1.2.3
在 GitHub 上创建 release
CI 将自动构建并上传 DEB 包

故障排查

常见问题

构建失败: 检查 debian/control 中的依赖是否正确
交叉编译失败: 确认目标架构的工具链已正确安装
安装测试失败: 检查 postinst 脚本是否有错误

调试构建

# 启用详细输出
DEB_BUILD_OPTIONS="nocheck" debuild -us -uc -b

# 检查构建日志
less ../chsrc_*.build

# 检查包内容
dpkg-deb --contents chsrc_*.deb

2.2 KiB Raw Blame History

DEB Package CI/CD

自动触发

支持的架构

构建产物

本地测试

构建 DEB 包

测试安装

文件结构

手动发布流程

故障排查

常见问题

调试构建

相关文件

2.2 KiB

Raw Blame History