Go的包管理工具（四）：Go Module Proxy

在前面的文章，咱们介绍了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 代理。

详见： github.com/goproxyio/g…

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模块存储库）。

推荐阅读

Go的包管理工具

订阅最新文章，欢迎关注个人公众号

参考

1. Athens docs
2. 再探go modules：使用与细节