Go Get 访问私有库配置

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方式,那么一共有两个地方需要去配置,如下:

  1. GOPRIVATE

    这个是用来配置哪一些库不走默认的GOPROXY,更确切的说,其实是帮我们配置了GONOPROXYGONOSUMDB两个配置,这两个配置可以通过go env查看到,该配置支持多个路径,路径之间用逗号分割,执行命令如下:

    go env -w GOPRIVATE=privacy.com
    # 可能会遇到 warning: go env -w GOPRIVATE=... does not override conflicting OS environment variable这种错误
    # 这是因为这个变量被系统变量赋值了,临时的解决办法是执行 unset GOPRIVATE
    # 根本上要去找一找哪里设置了这个变量,是否是自己在哪里export了这个
    
  2. 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://[email protected]/my-privacy/lib"]
        insteadOf = https://privacy.com/lib

其实就是在git获取仓库的时候如果匹配到https://privacy.com/lib就替换成ssh://[email protected]/my-privacy/lib方式执行,所以,所有的问题都迎刃而解了,只需注意几个地方:

  • insteadOf对应的地址应是自己的module名
  • url对应的是实际的地址,这里是使用了ssh方式,如果你git使用http方式获取仓库,则应修改ssh为https or http
  • 如果未配置GOINSECURE,则insteadOf对应的地址为https,否则为http

最后,可以一句命令添加配置:

git config --global url."ssh://[email protected]/my-privacy/lib".insteadOf "https://privacy.com/lib"
# 注意参数替换为自己的

结尾

到这应该就结束了,但是你会发现我之前获取私有库都在后面加了个.git后缀,这就要求私有库里的module也有.git后缀才行,很是不符合美观啊,不过我没有去找便捷的解决方式,只是参考了一下别人的博客,例如https://www.jianshu.com/p/90ef66e41f3c,如果你有需要,可以自行配置下。

好了,私有库应该可以正常通过go get的方式引入了go get privacy.com/lib.git,emmm,nice。

你可能感兴趣的:(Go Get 访问私有库配置)