go module
是go语言官方的包管理方式,go get
则是获取包的命令,通常,我们可以使用go get github/...
来引入第三方库,那么,如果我们需要引入私有库该怎么办呢?
本文假设读者已经使用过go get操作,并了解这一种引入包的方式,同时,了解go proxy的意义,当然,如果不了解也没关系[捂脸]
go get
默认通过GOPROXY获取第三方包,所以,想要引入私有包,需要在他原来的引入路径上做替换。
确定私有库的地址问题
我们使用的私有库可能来源多个地方,也许是github,也许是gitlab,也许是一个简单的git repository,所以仓库的地址也不尽相同,也许是域名格式,也许是ip格式。更重要的是,引入包的路径往往是和包名匹配的,例如我们的私有包module名为privacy.com/privacy/lib
,那么我们引入的路径就是go get privacy.com/privacy/lib
,所以,我们尽量使用域名地址去获取,那如果我的git仓库只是一个ip地址怎么办,没关系,后面我们会用git insteadOf方式做替换。
配置GOPROXY环境
如上所说,使用私有库的方式就是避开默认的GOPROXY方式,那么一共有两个地方需要去配置,如下:
-
GOPRIVATE
这个是用来配置哪一些库不走默认的GOPROXY,更确切的说,其实是帮我们配置了
GONOPROXY
和GONOSUMDB
两个配置,这两个配置可以通过go env
查看到,该配置支持多个路径,路径之间用逗号分割,执行命令如下:go env -w GOPRIVATE=privacy.com # 可能会遇到 warning: go env -w GOPRIVATE=... does not override conflicting OS environment variable这种错误 # 这是因为这个变量被系统变量赋值了,临时的解决办法是执行 unset GOPRIVATE # 根本上要去找一找哪里设置了这个变量,是否是自己在哪里export了这个
-
GOINSECURE
这个是使私有库的访问方式由HTTPS转为HTTP,因为默认go get发起请求使用的是HTTPS,如果自己的私有服务是HTTP的,则需要配置下,不过,这里其实无所谓,因为最后使用
git insteadOf
可以规避这个问题,如果需要请自取命令:go env -w GOINSECURE=privacy.com
配置git config
这一步是重点,为了解决前面说的HTTP问题也好,路径也好,都是在这里做修改,用到的方式也简单,就是git的insteadOf
配置,通过这种方式,可以在背后悄悄替换掉访问的git地址,举个栗子吧
假如我执行的go get命令是go get privacy.com/lib.git
,但是我希望访问的真实地址是10.0.0.1/my-privacy/lib.git
,那么用到的配置是
# 这是git config --global -e编辑看到的效果
[url "ssh://git@10.0.0.1/my-privacy/lib"]
insteadOf = https://privacy.com/lib
其实就是在git获取仓库的时候如果匹配到https://privacy.com/lib
就替换成ssh://git@10.0.0.1/my-privacy/lib
方式执行,所以,所有的问题都迎刃而解了,只需注意几个地方:
- insteadOf对应的地址应是自己的module名
- url对应的是实际的地址,这里是使用了ssh方式,如果你git使用http方式获取仓库,则应修改ssh为https or http
- 如果未配置GOINSECURE,则insteadOf对应的地址为https,否则为http
最后,可以一句命令添加配置:
git config --global url."ssh://git@10.0.0.1/my-privacy/lib".insteadOf "https://privacy.com/lib"
# 注意参数替换为自己的
结尾
到这应该就结束了,但是你会发现我之前获取私有库都在后面加了个.git后缀,这就要求私有库里的module也有.git后缀才行,很是不符合美观啊,不过我没有去找便捷的解决方式,只是参考了一下别人的博客,例如//www.greatytc.com/p/90ef66e41f3c,如果你有需要,可以自行配置下。
好了,私有库应该可以正常通过go get的方式引入了go get privacy.com/lib.git
,emmm,nice。