利用docker实现Golang程序的交叉编译
版权声明 本站原创文章 由 萌叔 发表
转载请注明 萌叔 | https://vearne.cc
1. 前言
萌叔有有一个开源项目vearne/passwordbox，用于密码的管理。笔者想法是在Mac上build出多个平台下的bin文件，这样用户，可以无需自己编译，直接使用编译好的bin文件。
可是 vearne/passwordbox 内部依赖了 mattn/go-sqlite3。这个库编译时，依赖操作系统上的共享库，无法直接进行交叉编译。
2. 解决
前段时间，萌叔在阅读buger/goreplay源码时，偶然发现它有一个思路是利用docker来实现Golang交叉编译。于是笔者借鉴了它的思路，修改了passwordbox Makefile。
现在在Mac上执行
make docker-img # 只需要执行一次，生成基础镜像即可
make release
就可以同时生成Mac和linux下的bin文件
pwbox-v0.0.10-darwin-amd64.tar.gz
pwbox-v0.0.10-linux-amd64.tar.gz
完整代码见Makefile
2.1 build一个基础镜像用于linux环境的编译
docker-img:
docker build --rm -t $(CONTAINER) -f Dockerfile.dev .
Dockerfile.dev
FROM golang:1.14
RUN apt-get update && apt-get install vim-common -y
WORKDIR /go/src/github.com/vearne/passwordbox/
ADD . /go/src/github.com/vearne/passwordbox/
RUN go get
golang:1.14 实际是基于Ubuntu的一个镜像(Linux)
2.2 借助Docker实现跨平台编译
release-linux:
docker run -v `pwd`:$(SOURCE_PATH) -t -e GOOS=linux -e GOARCH=amd64 -i $(CONTAINER) go build $(LDFLAGS) -o pwbox
tar -zcvf pwbox-$(VERSION)-linux-amd64.tar.gz ./pwbox
rm pwbox
-v pwd:$(SOURCE_PATH)
是为了把项目的代码直接挂载到docker中，这样就无需每次拷贝代码到docker中
-i 参数
使用交互模式启动docker，build生成出来的bin文件是直接产生在宿主机上的
3. 共享库依赖错误
当萌叔把生成好的pwbox-v0.0.10-linux-amd64.tar.gz拷贝到某台linux机器上，试图运行时，报了如下错误。
[root@dev01]# ./pwbox -v
./pwbox: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found (required by ./pwbox)
进一步
[root@dev01]# ls -l /lib/x86_64-linux-gnu/libc.so.6
lrwxrwxrwx 1 root root 12 Jun 5 01:25 /lib/x86_64-linux-gnu/libc.so.6 -> libc-2.27.so
这个libc.so.6其实是GNU C Library，它是一个共享库。
报错的原因是在编译环境中
libc.so.6 -> libc-2.28.so
而在部署环境中，libc的版本太低导致。
libc.so.6 -> libc-2.27.so
对于这种情况有2种办法
- 1）升级部署环境的libc(见参考资料1)
- 2）降低编译环境libc的版本，经过测试，libc库是向后兼容的，将基础镜像从golang:1.14退到golang:1.10，对应的问题即可解决。
4. 后记
github里还有一个Golang跨平台编译工具karalabe/xgo, 可以一条命令生成windows、linux、mac下的bin文件。
当然它的思路也是借助docker来实现跨平台的编译。
2024年2月6日
karalabe/xgo 已经不再更新，请使用techknowlogick/xgo
参考资料
