Debian Golang打包流程是什么

Debian Golang 打包流程

一 准备环境与工具

• 安装构建工具与 Go：sudo apt update && sudo apt install -y build-essential debhelper dh-golang golang-go（或 golang-any）。
• 准备项目：确保代码在 $GOPATH 或模块模式下可构建，建议使用 Go Modules 管理依赖。
• 选择构建策略：常规推荐 dh-golang + gc 编译器；若需与系统库深度集成，可考虑 gcc-go（生成动态链接二进制）。

二 标准流程 dh-golang（推荐）

• 在项目根目录创建打包骨架：dh_make --createorig -p 包名_版本，按向导选择单二进制包等。
• 关键文件与要点：
  • debian/control：设置 Source/Package、Maintainer、Build-Depends: dh-golang, golang-go (或 golang-any)、Architecture: any（单二进制通常如此）、Description。
  • debian/rules：最简示例
    #!/usr/bin/make -f
    %::
    dh $@ --with golang
  • debian/compat：设置 debhelper 兼容级别（如 12/13）。
  • debian/install（可选）：声明安装映射，例如
    your-go-app /usr/bin/
    config.toml /etc/your-go-app/
    static/ /usr/share/your-go-app/static/
  • debian/changelog、debian/copyright：按 Debian 规范填写版本变更与许可证。
• 构建与检查：
  • 构建：debuild -us -uc（或 dpkg-buildpackage -us -uc -b）。
  • 安装测试：sudo dpkg -i …/包名_版本_amd64.deb；运行时检查可执行文件、配置与静态资源路径是否正确。

三 备选方案 二进制封装与 lintian 处理

• 适用场景：已有预编译二进制、或希望快速封装。
• 基本做法：
  • 准备目录结构（debian/control 等），在 debian/rules 中仅做“安装”动作（不触发编译）。
  • 直接构建：dpkg-buildpackage -us -uc -b（不运行 lintian）；或 debuild -us -uc 并在需要时配合 lintian overrides。
• 注意：该方法可绕过部分静态链接导致的 lintian 警告，但长期维护与合规性不如 dh-golang 方案。

四 常见要点与最佳实践

• 架构与依赖：单文件 CLI 工具常用 Architecture: any；若包含架构相关文件可用 Architecture: amd64。运行时依赖通常仅需 ${misc:Depends}；若使用 gcc-go 或依赖 C 库，再补充相应 Depends。
• 许可证与版权：debian/copyright 需覆盖项目代码与所有 Go 模块依赖 的许可证；确保 LICENSE 等文件随包安装。
• 静态链接与 lintian：Go 默认静态链接，可能触发某些 lintian 警告；优先用 dh-golang 的标准流程与推荐做法，必要时使用 lintian overrides 精确忽略特定告警。
• 资源与配置：通过 debian/install 精确放置可执行文件、配置与静态资源，避免将 整个模块缓存 打入包中。
• 持续集成：在干净环境执行构建与 lintian 检查，确保可复现构建与合规交付。