研发日记 | 开源软件 Goreleaser X CGO 最佳实践是如何诞生的

godownloader:尽可能快速,轻松地下载Go二进制文件 警告:这不再是主动维护的。 有关详情,请参见 。 下载器 尽可能快速,轻松地下载Go二进制文件。 这是的反。 读取goreleaser的YAML文件并创建一个自定义的shell脚本,该脚本可以为现有机器下载正确的软件包和正确的版本。 如果您已经使用goreleaser,它将创建适合“ curl bash”样式下载的脚本。 在goreleaser.yaml文件上运行godownloader 将godownloader.sh文件添加到您的godownloader.sh 告诉您的用户使用进行安装 这在CI / CD系统(例如 )中也很有用。 然后比“开始获取”快得多(有时高达100倍) 确保您的本地环境(macOS)和CI环境(Linux)使用的Go二进制文件版本完全相同。 CI / CD示例 假设您将与静态网站生成器一起使用。 您的旧.travis.yml文件可能有 inst 立即下载

本篇比较详细地记录了 Bytebase 从遇到问题最后到如何使用 goreleaser X CGO 的经过。

背景

在实现 SQL Review for PG 时,我们引入了 pg_query_go 作为 PG parser。pg_query_go 通过 C Bind 的方式使用原生的 PG parser 编译,自然就需要 CGO 的支持。

在 1.2.1 版本发布时,我们发现 goreleaser 无法正常工作,其报错信息直指 pg_query_go。幸运的是,我们的发布版本不需要使用 pg_query_go, 因此先通过添加 ”!release“ 的 Go tag 来保证正常发布,之后就开始了与 goreleaser 和 CGO 斗争的漫漫长路上。

线索一

“build constraints exclude all Go files in /go/pkg/mod/github.com/pganalyze/pg_query_go/v2@2.1.2/parser”

这个错误信息虽然看起来有点莫名其妙,不过它精确指向了出问题的地方。那就让我们前往 “pg_query_go/parser” 一探究竟。

实际上,“pg_query_go/parser” 这个包里只有一个 Go 文件 parser.go,除此之外都是 C 代码。并且,parser.go 是一个 import “C” 的 CGO 文件。容易猜到,可能是没有设置 CGO_ENABLED=1 导致忽略了这个文件。

Google 或者手动验证一下我们都可以轻松验证这个猜想的正确性。由此我们获得了前往下一个路口的指引:在 goreleaser 中设置 CGO_ENABLED=1

线索二

在 goreleaser 中打开 CGO 只需要在 goreleaser 配置文件中将 “CGO_ENABLED=1” 加入到对应的 env 项中即可

让我们重试:

这个错误看起来就比较奇怪了,只能知道是 cgo 出了问题,莫非 goreleaser 不支持 CGO?抱着怀疑的心情前去 gorelaser 文档搜索了一下,果然如此。

goreleaser 中提到的「This project」实际上是 goreleaser/goreleaser-cross。那么,下一步我们就一起前往 goreleaser-cross 吧

线索三

goreleaser-cross 的内容并不复杂,这个仓库实际上是为了提供一个 docker image,这个 docker image 中主要包括的内容是 goreleaser 和一些 C/C++ 的交叉编译工具链(cross compiler)。

了解交叉编译的同学可能知道,交叉编译的使用场景是需要在平台A上编译能够直接执行在平台B上的二进制文件,例如,在嵌入式、操作系统等开发场景,我们的开发机器往往是 x64 架构的 Linux 环境,但运行环境可能是 arm/arm64 架构的 Linux 环境,此时就需要一个对应的交叉工具链来进行编译。

那为什么我们需要这个呢,仔细的同学可能已经发现,我们在 goreleaser 的配置文件中指定了四个目标平台:

而我们的编译环境实际上是在 Github Action 的 Ubuntu x64 上。在打开 CGO 之前,我们只需要处理跨平台编译 Go 时的参数即可,而这一步实际上 Go 语言编译器和 goreleaser 已经帮我们处理好了。但在引入 CGO 之后,我们还需要编译 C/C++ 代码,所以就需要对应的 C/C++ 交叉编译工具链了。

也就是说,此时我们需要一共四个目标平台的交叉编译工具链,幸运的是,goreleaser-cross 都可以支持。

现在看起来问题似乎得以解决,但实际上并不完美,仍然有一些问题,相较于 goreleaser 拥有 10k+ 的 stars,goreleaser-cross 只有 26 stars。这意味 goreleaser-cross 很少被使用,可能有一些风险。

如果交叉编译工具链都是良好维护的,那么这个风险实际上也比较小,主要的问题在于目标平台是 Darwin 时。尝试过从 Linux 交叉编译到 Darwin 上的同学都知道,这是一件极其困难的事情。主要困难的点在于没有现成的、良好维护的交叉编译工具链可以使用,往往需要自行构建交叉工具链。自行构建的交叉编译工具链又往往难以验证兼容性和维护,需要消耗大量精力。实际上,goreleaser-cross 使用的 o64-clang/oa64-clang 交叉编译工具链就是基于 osxcross 自行编译的。

那么是否有办法规避这个风险呢?确实有的。

分岔路

之前提到我们在 Github Action 上使用的编译环境是 Ubuntu x64。想要不使用交叉编译工具链,最简单的办法就是在相同平台上编译即可。那 Github Action 是否提供了其他环境呢?有的!

注意,这里的 macOS 都是 x64 架构的。虽然还是需要跨架构,但是好在不用跨平台了!

那么,接下来的思路就变成了:在 Linux 平台上编译 Linux 两个架构的 binary,在 macOS 平台上编译 Darwin 两个架构的 binary。

对于 Linux 平台来说,x64 -> x64 就是我们日常编译所使用的工具链 gcc/g++ 即可,x64 -> arm64 在 Linux 平台是有良好维护的工具链,对 Ubuntu 来讲,直接通过包管理器即可获得:

sudo apt-get -y install gcc-aarch64-linux-gnu

对于 Darwin 来说,就更简单了,clang 就原生支持跨架构,感谢 LLVM!

一番操作之后,Github Action 配置变成了这样:

两个 job 分别用来编译不同平台上的二进制文件。

对于 Darwin 平台的 goreleaser 配置文件,只需要修改打开 CGO 然后去掉 Linux 平台即可。

对于 Linux 平台的 goreleaser 配置文件,稍微复杂,我们需要给对应的架构使用对应的编译工具链。

这里使用了 goreleaser 的 overrides 功能来实现这个目的。

到此为止,我们已经能够使用 goreleaser 在 CGO 开启时进行编译了,但是故事还没有结束,goreleaser 的最终目的是发布,若是按照目前这样 release 两次就会有两次 release 信息。不过这一步就比较轻松了。

release!

这里的主要思路很简单,build 和 release 分离。在 job1 中 build linux binaries;在 job2 中 build macOS binaries;job3 依赖 job1 和 job2,进行发布。

build 时通过 skip-publish 参数跳过 release,而 release 时通过 build skip 来跳过 build,并且通过 extra_files 设置将 job1 和 job2 中生成的文件设置为发布内容。

故事完结!

一则趣事

实际上在此之前,Bytebase 已经依赖了 go-sqlite3,这也是一个依赖 CGO 的包,那为什么之前没出问题呢。实际上,在此之前 goreleaser 环境中并没有打开 CGO,而 go-sqlite3 在没打开 CGO 时做了一个 mock,也就是说,没打开 CGO 时编译出来的 go-sqlite3 是一个空包。

那为什么没有遇到问题呢,因为在引入 goreleaser 之前,Bytebase 已经从 从 SQLite 迁移到了 PostgreSQL, 所以确实没有使用 go-sqlite3, 只是有这个依赖而已。

后记

- 不到万不得已,不要尝试引入交叉编译工具链,他会带来额外的验证和维护成本。

- 跨架构会让事情变得复杂,而跨平台会让你变得不幸,尽可能远离它!!!

- 感谢 LLVM-Clang

Go-GoReleaser为多个平台构建Go二进制文件创建一个GitHub发布版本 GoReleaser 为多个平台构建Go二进制文件,创建一个GitHub发布版本.尽可能快捷地交付Go二进制文件 立即下载

相关推荐

xcgo:使用CGo和其他工具的Golang跨平台构建器docker映像

neilotoole / xcgo xcgo是一个最大化的Docker映像,用于交叉编译和发布/分发启用CGo的Go / Golang应用程序。 目前,它可以为arch amd64构建和发布macOS,Windows和Linux CGo项目。 xcgo有gophers渴望的东西: go 1.15 OSX SDK卡塔利娜/ macOS 10.15 docker snapcraft goreleaser golangci-lint mage zsh 和其他一些东西。 文档的用于主源xcgo是。 从那里开始。 有一个附带的示例项目( )被明确创建以展示xcgo :它展示了xcgo的全部功能,并展示了如何释放到brew , scoop , snap ,Docker Hub,GitHub等。 neilotoole/xcgo映像已发布到 。 注意:尚未做出任何努力来为诸如3

【亲测免费】 推荐使用GoReleaser:快速便捷地发布Go二进制文件

推荐使用GoReleaser:快速便捷地发布Go二进制文件 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目地址: https://g...

gitblog_00080的博客 804

使用Metasploit生成木马控制Windows系统

使用Metasploit生成木马控制Windows系统

weixin_56956399的博客 2509

【亲测免费】 GoReleaser安装与配置指南

GoReleaser安装与配置指南 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目地址: http...

gitblog_01114的博客 1374

无人机通信电台--XBee-PRO 900HP (S3B)

XBee PRO S3B也称为XBee-900HP无线模块,它是一款工作在频段900~928MHz之间,基于FHSS跳频技术的远距离无线数传电台核心模块。常用型号如下: 类别 型号 开发套件 XKB9-DMT-UHP XBee-PRO 900HP (S3B) DigiMesh模块,200Kbps,软天线 XBP9B-DMWT-002 XBee-PRO 900HP (S3B)...

low米的博客 4507

多组学联合高级Mantel-test热图

对应的是「metabo」中物质间的相关性热图,单元格色块颜色表示相关系数大小,橙色表示+相关,绿色表示-相关;单元格内的数值表示相关性值大小,星号表示显著性。双组学(微生物组/ 转录组/代谢组等两两组合)关联分析,可视化组学特征间的关联显著性、强度及相关方向。表示<trans>与<metabo>中物质的Mantel test结果。表示整体相关的系数,连线颜色表示相关系数的显著性检验结果。宿主-微生物互作、疾病多组学机制、环境-生物多组学关联。为物质名称,不允许存在空值、重复值。

多组・学・多组学 371

GoReleaser 技术文档

GoReleaser 技术文档 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目地址: https:...

gitblog_01248的博客 984

WPF在特定领域的应用:打造一款专业的图像编辑工具

WPF在特定领域的应用:打造一款专业的图像编辑工具,在软件开发的广阔领域中,Windows Presentation Foundation(WPF)以其强大的图形渲染能力和丰富的用户界面控件,为开发者提供了构建高性能、美观应用程序的平台。图像编辑工具作为一种对图形处理要求极高的应用类型,WPF 的特性使其成为理想的选择。本文将深入探讨如何使用 WPF 打造一款专业的图像编辑工具,涵盖从基础概念到实际代码实现的各个方面。

不踩坑,不知道坑有多深;不总结,踩过的坑白踩。 6万+

goreleaser 自动打包发布

交叉编译:支持构建多个操作系统和架构的二进制文件。打包:将构建的二进制文件打包成归档文件,如.tar.gz.zip等。发布:自动将构建的制品发布到 GitHub Releases、GitLab 等平台。生成校验和:为发布的制品生成校验和文件,确保文件完整性。生成 Homebrew 公式:方便 macOS 用户通过 Homebrew 安装。生成 Snap 包:支持在 Linux 系统上通过 Snap 安装。

gopher123的博客 1278

系统架构设计(以飞控系统、航电系统、机电管理系统、电子电气架构为例)

系统架构涉及对系统的结构和行为进行高层次的描述。它包括系统的组成部分、这些部分之间的关系、与外部环境的交互方式,以及满足特定功能和非功能性需求的方法。系统架构定义了系统的总体设计蓝图,指导系统的开发、集成、部署和维护。系统架构设计的目的是通过合理的结构和设计原则,确保系统能够高效、稳定、安全地运行,满足当前和未来的需求,同时具备良好的维护性、扩展性和可持续性。良好的系统架构不仅能够提高系统的开发效率和运行性能,还能降低长期的维护和运营成本,支持系统的持续演进和技术更新。

qq_41854911的博客 3056

YOLOv11涨点改进| TPAMI 2026 |独家创新首发、Conv改进篇| 引入LPM 局部先验特征增强模块,更加聚焦于目标区域并抑制背景干扰,助力目标检测、图像分割、图像恢复、图像增强有效涨点

🔥本文提出了一种改进YOLOv11网络的LPM(局部先验特征增强)模块,通过构建重要性图引导特征提取过程,使模型更聚焦目标区域并抑制背景干扰。LPM模块通过注意力机制强化关键区域信息,优化特征分布,提升小目标和复杂场景下的检测性能。实验表明,该模块在保持轻量结构的同时,显著提高了检测精度和鲁棒性。文章详细介绍了LPM的结构原理、核心代码实现方法,并提供了4种改进配置方案(yolov11n_LPM.yaml等),指导用户如何集成该模块到YOLOv11网络中。这些改进方案通过多阶段特征融合逐步强化细节表达.

Ai缝合怪、助力小伙伴高效发论文 128

go项目的打包部署

1.go项目在window下编译简易打包     1).在windows下直接编译生成main.exe文件         在项目main.go同级目录下执行以下命令 go build main.go     2).将当前目录下的main.go打包成gotest.exe文件(在windows下可以直接执行)    &

k393393的博客 1万+

肖特基二极管选型参数,结构原理,工艺与注意问题总结

肖特基二极管(Schottky Diode)是一种特殊的二极管,也被称为肖特基势垒二极管。它是利用金属与半导体接触形成的金属-半导体结原理制成的。与传统的PN结二极管相比,肖特基二极管具有更低的正向压降、更高的开关速度、更高的反向恢复时间以及更好的温度稳定性等特点。本文对肖特基二极管的工作原理,结构特点,工艺流程,选型参数及设计注意事项进行总结。

fydar的博客 815

快速上手GoReleaser:完整配置与实战指南

GoReleaser是一个强大的发布工程自动化工具,专门为Go语言项目设计,同时也支持Rust、Zig、TypeScript和Python等多种语言。它能够帮助开发者自动化构建、打包、签名和发布软件,简化复杂的发布流程,让你专注于核心开发工作。在前80个字内,GoReleaser的核心功能包括多平台构建、Docker镜像生成、包管理器发布和供应链安全增强,是现代软件开发中不可或缺的发布自动化解决方

gitblog_00642的博客 672

Gbase 8a GDCA考试真题100%

本文整理一些Gbase 8a中非常易错得考试真题及答案,而且都是不好搜的。加粗的是正确答案。

打工之路,一路生花 4310

ET2012新版免狗免安装绿色软件

ET2012新版免狗免安祖昂绿色软件。,新界面,新视觉,

GoReleaser 项目推荐

GoReleaser 项目推荐 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目地址: https:...

gitblog_00617的博客 491

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

【亲测免费】 GoReleaser 项目下载及安装教程

GoReleaser 项目下载及安装教程 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目地址: h...

gitblog_01249的博客 1281

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

pscad IEEE标准系统搭建说明

pscad IEEE标准系统搭建说明,包含典型的IEEE 9节点、14节点、30节点、39节点和118节点系统。内含标准测试系统的原始数据和潮流结果。

使用 Go 从零开发并发布一个 Kubectl 插件

作者:KaliArch(薛磊),某 Cloud MSP 服务商产品负责人,熟悉企业级高可用/高并发架构,包括混合云架构、异地灾,熟练企业 DevOPS 改造优化,熟悉 Shell/Python/Go 等开发语言,熟悉 Kubernetes、 Docker、 云原生、微服务架构等。 前言 十年云计算浪潮下,DevOps、容器、微服务等技术飞速发展,云原生成为潮流。企业云化从“ON Cloud” 走向 “IN Cloud”,成为“新云原生企业”,新生能力与既有能力立而不破、有机协同,实现资源高效、应用敏捷、.

KubeSphere 2089

GoReleaser:一键发布Go二进制文件的利器

GoReleaser:一键发布Go二进制文件的利器 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目...

gitblog_00930的博客 436

GoReleaser:简化发布流程的利器

GoReleaser:简化发布流程的利器 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目地址: h...

gitblog_00076的博客 733

Go二进制发布的终极解决方案:一键自动化部署全流程

🚀 还在为Go项目的发布流程头疼吗?每次手动构建、打包、上传到GitHub Release的繁琐步骤是否让你疲惫不堪?今天我要向你推荐一款真正改变游戏规则的Go二进制发布工具——GoReleaser,它能让你彻底告别重复劳动,实现一键自动化部署! ## 什么是GoReleaser? GoReleaser是一个基于Go语言开发的自动化软件发布工具,专门为Go项目量身定制。它支持多种编程语言和云

gitblog_00905的博客 307

GoReleaser 终极指南:如何用10分钟掌握自动化软件发布

GoReleaser 是一个基于 Go 的强大软件发布工具,支持多种编程语言和云平台,能帮助开发者轻松实现软件发布和部署的自动化。无论是 Go、Rust、Python 还是 Zig 项目,它都能提供一致且高效的发布体验,让你告别繁琐的手动操作,专注于代码开发。 [![GoReleaser 自动化发布流程](https://raw.gitcode.com/gh_mirrors/go/gorelea

gitblog_00494的博客 427

GoReleaser:终极自动化软件发布解决方案

GoReleaser是一个功能强大的开源工具,专门为现代软件开发团队设计,旨在彻底简化软件发布流程。无论你使用Go、Rust、Zig、Bun、Deno还是Python,GoReleaser都能提供统一、高效的发布体验。 [![GoReleaser功能概览](https://raw.gitcode.com/gh_mirrors/go/goreleaser/raw/de9ae24137392d5e5

gitblog_00869的博客 460

GoReleaser 打包全攻略:deb、rpm、Docker 镜像等 6 种格式一网打尽

GoReleaser 是一款 Go 生态中广受好评的发布工程工具,它能将"构建 + 打包 + 发布"一气呵成:你只需一份 `.goreleaser.yaml` 配置,就能在打 tag 的同时产出 deb、rpm、Docker 镜像、snap、zip 等多种格式的安装包。本文面向新手,带你快速搞懂这 6 种常用打包格式的配置思路。 [![GoReleaser打包多种格式的吉祥物插图](https:

gitblog_00405的博客 488

GoReleaser开源项目常见问题及解决方案

GoReleaser开源项目常见问题及解决方案 【免费下载链接】goreleaser goreleaser/goreleaser: 一个基于 Go 的软件发布工具,支持多种编程语言和云平台,适合用于自动化软件发布和部署。 项目地址...

gitblog_01246的博客 1000

goreleaser-cross:轻松实现 CGO 跨平台编译

goreleaser-cross:轻松实现 CGO 跨平台编译 在现代软件开发中,跨平台编译是一个常见需求,尤其是在使用 CGO 进行 C 和 Go 代码混合编译时。goreleaser-cross 正是为了解决这一痛点而生的 Docker 容器工具。本文将详细介绍这一项目的核心功能、技术分析、应用场景和特点。 项目介绍 goreleaser-cross 是一个基于 Docker 的工具,能够将 ...

gitblog_00210的博客 775
上一篇: 一家全球化初创公司背后的 30+ SaaS 服务和成本
下一篇: 关于数据库你应该知道的那些事儿
Bytebase
博客等级 码龄5年 1350粉丝 258原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值