Debian Golang打包流程是怎样的

Debian Golang 打包流程

一准备与工具

安装构建工具与 Go：sudo apt update && sudo apt install -y build-essential devscripts dh-golang golang-go（或 golang-any）。
准备项目：确保使用 Go Modules（go.mod），可执行文件名称与上游一致，版本号遵循 Debian 版本规范（如：1.2.3-1）。
选择打包方式：
- 推荐：使用 dh-golang 在打包环境中从源码构建，符合 Debian 规范。
- 备选：预编译二进制后封装为 .deb（适合内部交付或上游未提供源码构建的场景）。

二推荐方式使用 dh-golang 从源码构建

生成打包骨架：在项目根目录执行 dh_make -p your-go-app_1.0.0-1 --createorig（或按团队模板复制 debian/ 目录）。
关键文件要点：
- debian/control（示例）
  - Source: your-go-app
  - Section: utils
  - Priority: optional
  - Maintainer: Your Name you@example.com
  - Build-Depends: debhelper-compat (= 13), dh-golang, golang-go
  - Standards-Version: 4.5.0
  - Homepage: https://github.com/youruser/your-go-app
  - Package: your-go-app
    Architecture: amd64（或依据实际选择，如 arm64；纯 Go 程序常为 amd64/arm64/…）
    Depends: ${misc:Depends}
    Description: Short desc.
    Long desc.
- debian/rules（最小化示例）
  - #!/usr/bin/make -f
    %:
    dh $@ --with golang
  - override_dh_auto_install:
    dh_golang_install
    如有静态资源：dh_install -p your-go-app path/in/src /usr/share/your-go-app/
- 其他常见文件：debian/copyright、debian/changelog、debian/install（如需显式安装文件）。
构建与检查：
- 构建二进制包：debuild -us -uc（或 dpkg-buildpackage -us -uc -b）。
- 安装测试：sudo dpkg -i …/your-go-app_1.0.0-1_amd64.deb；运行时检查二进制架构与权限。
- 质量检查：lintian …/your-go-app_1.0.0-1_amd64.changes，必要时添加 debian/lintian-overrides/ 条目抑制误报。

三备选方式预编译二进制封装为 deb

交叉编译为静态可执行文件（在构建机或 CI 中）：
- CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o your-go-app ./cmd/your-go-app
- 其他架构同理（如 arm64）。静态链接可避免运行时依赖问题。
准备 debian/ 目录与元数据（至少包含 debian/control），在 debian/rules 中跳过构建步骤，仅做安装：
- override_dh_auto_build override_dh_auto_test: # 空
- override_dh_auto_install:
  dh_install -p your-go-app your-go-app /usr/bin/
构建与安装：debuild -us -uc 或 dpkg-buildpackage -us -uc -b；sudo dpkg -i 安装并测试。

四常见要点与排错

架构与构建参数：纯 Go 程序常用 amd64/arm64；跨编译时使用 CGO_ENABLED=0 生成静态二进制，避免外部 C 库依赖。
版本与变更：debian/changelog 使用 dch -i 递增版本；遵循 Debian 版本规则（上游版本-修订号）。
依赖处理：dh-golang 会解析模块依赖，但打包时仍需在 Build-Depends 中声明必要的构建工具（如 dh-golang、golang-go）。
Lintian 警告：对 Go 静态二进制常见的 “binary-without-manpage”“hardening-no-relro” 等，可通过 debian/lintian-overrides/ 合理抑制，并在 README 或说明中给出理由。
资源与系统整合：配置文件、静态网页、systemd 单元等用 debian/install 或 override_dh_auto_install 安装到 /etc/your-go-app/、/usr/share/your-go-app/、/lib/systemd/system/ 等标准路径。

如有静态资源：dh_install -p your-go-app path/in/src /usr/share/your-go-app/