在前面的文章,我们介绍了Go Modules
。Go module支持了Versioned Go,并初步解决了包依赖管理的问题。
新的工作模式也带来了一些问题,在大陆地区我们无法直接通过 go get
命令获取到一些第三方包,最常见的就是 golang.org/x
下面的各种优秀的包。一旦工作在模块下,go build
将不再关心 GOPATH 或是 vendor 下的包,而是到 GOPATH/pkg/mod
查询是否有cache,如果没有,则会去下载某个版本的 module,而对于某些包的 module,在大陆地区往往会失败。本文将重点介绍 go module 的 proxy 配置实现,包括如下两种的代理配置:
- GOPROXY
- Athens
GOPROXY
goproxy 是一个开源项目,当用户请求一个依赖库时,如果它发现本地没有这份代码就会自动请求源,然后缓存到本地,用户就可以从 goproxy.io 请求到数据。当然,这些都是在一个请求中完成的。goproxy.io 只支持 go module 模式。当用户执行 go get 命令时,会去检查 $GOPROXY//@v/list
这个文件中是否有用户想要获取的版本,如果有,就依次获取 $GOPROXY//@v/.info
、$GOPROXY//@v/.mod
、$GOPROXY//@v/.zip
等文件,如果没有就直接从源码库中去下载。
通过命令:
export GOPROXY=https://goproxy.io
设置了这个环境变量,一旦设置生效,后续 go 命令会通过 go module download protocol
与 proxy
交互下载特定版本的 module
。当然,我们还可以置空 GOPROXY
变量,来关闭 GOPROXY
代理。
详见: https://github.com/goproxyio/goproxy
Athens
Athens 是一个建立在 vgo(或者是1.11 +)之上的项目,试图让依赖关系更接近你,即使在 VCS 关闭时你也可以依赖可重复的构建。
依赖关系是来自 Github 的不可变的代码块和相关的元数据。 他们存储在 Athens 控制的仓库里。
您可能已经知道“不可变”意味着什么,但让我再次指出它,因为它对整个系统非常重要。当人们改变他们的包,迭代,实验或其他任何东西时,Athens 的代码都不会改变。如果软件包作者发布了一个新版本,Athens 将把它拉下来。比如某个项目依赖于包 M 版 v1.2.3
,它将永远不会改变 Athens 上的包。
安装
Athens 支持多种方式的安装,docker 容器、k8s 和二进制安装包,本文将会介绍如何通过二进制包安装。
git clone https://github.com/gomods/athens
cd athens
make build-ver VERSION="0.2.0"
./athens -version
获取私有仓库
Athens 获取私有仓库中的 module,这也是一个企业级的需求。通常企业私有仓库都是需要身份验证的,因此我们需要在 Athens 中配置访问私有仓库的账号和凭证信息。目前 Athens 官方文档中提供了通过 .netrc
方式访问带有身份验证的私有仓库的功能。
通过创建 .netrc
文件,进行私有仓库身份验证。
//.netrc
machine github.com
login MY_USERNAME
password MY_PASSWORD
本地应用
export GO111MODULE=on
export GOPROXY=http://127.0.0.1:3000
我们可以使用 Athens 提供的 walkthrough
。
git clone https://github.com/athens-artifacts/walkthrough.git
$ cd ../walkthrough
$ go run .
go: finding github.com/athens-artifacts/samplelib v1.0.0
handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.info [200]
handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.mod [200]
go: downloading github.com/athens-artifacts/samplelib v1.0.0
handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.zip [200]
The ???? says rawr!
go run .
的输出包括尝试查找 github.com/athens-artifacts/samplelib
依赖项。由于代理是在后台运行的,因此还可以看到来自 Athens 的输出,表明它正在处理对依赖项的请求。
global public proxy
Athens 还提供了一个试验性的 proxy:athens.azurefd.net
供全球gopher 使用。导入环境变量:
export GOPROXY="https://athens.azurefd.net"
当然虽然可以使用这些公有的代理,但是包的源并不是很全,最稳妥的方法还是自建 Athens 服务。官方issue中所说:
athens.azurefd.net
处于 alpha 的版本,目前基础设施还没有很好地维护,所以看到超时并不感到惊讶。自建Athens
或使用 GoCenter(目前唯一的托管Go模块存储库)。