基于jenkins的go语言项目自动化发布遇到的坑

殇帝刘玢你

　　本文转载自：http://www.javaxxz.com/thread-359435-1-1.html
　　之前我们研究dep，就是为了有一天可以实现go语言项目在我们系统里的CI. 之前联物科技的项目主要是使用java作为后端开发语言，基于jenkins的自动发布，使用了pipeline编写脚本，从拉取代码，使用maven编译，构建docker镜像，推送镜像到仓库，调用接口执行docker swarm命令进行容器部署。我一直觉得go目前这个阶段不适合实现传统以业务逻辑为主的系统，但现在有一个项目比较特殊，于是使用了go作为实现。为了也能实现自动化，我和运维从写dockerfile, stackfile，到能自动发布，足足折腾了小一天.
　　考虑到这方面的资料比较少，下面就把遇到的坑讲解一遍， 不熟悉dep的可以先看这篇文章
　　 
　　部分依赖无法下载
　　由于我们代码的依赖项目中又依赖了golang.org/x 下的部分功能，而golang.org下的代码，能不能下载完全看命，即使我们的jenkins服务器在阿里云上，做一些FQ下载已经比公司内或者家里快很多了，对golang.org这个域名下的东西依旧是无能为力（完全ping不通）. 好在golang.org/x 也算标准库，兼容性好，我机器上有一些很早之前的版本也能用. 这时候先要在项目的Gopkg.toml文件中，页头增加这一段标识
　　 

• 　　ignored = ["golang.org/*"]
  

　　复制代码
　　 
　　这是在之前文章里没提过的，意味着不需要dep解析所有golang.org路径下代码的依赖.dep就不会为其在Gopkg.lock中的内容，也不会去下载到vendor文件夹中，需要你或者手工添加到vendor文件夹中，或者在GOPATH下存在相应代码，否则dep ensure可以通过，但go build或go install会失败. 我采取了后者，人工拷贝到jenkins服务器的GOPATH下. 理由是考虑其比较通用. 对于一些特定领域使用的包，不大的话，可以添加到vendor文件夹里并且推到版本控制服务器. 但无论选哪个，都要做上面代码的配置
　　待构建代码必须在GOPATH下
　　严格说来这并不算一个坑，谁都知道如果要dep或者build，代码就要在GOPATH下，但配置的时候还是忘了.
　　对于一个java项目，我们会将其下载到 /workspace/ 下，并以其作为工作目录，执行maven操作，最后拿到target目录下的jar包继续进行下一步操作. 但dep不但要求jenkins下载下来的代码在GOPATH/src下，还要求其存放路径和其在代码仓库中的完全一致：因为你项目内部一定也互相引用了，如果你把github.com/A/B的项目放到了GOPATH/src/github.com/C 下，dep会解析失败，报出很奇怪的错误. 这点要尤其注意，坑了我好久
　　所以我们把代码放在了/workspace//src/  目录下，并且把/workspace/ 临时export成了另外一个GOPATH. 开始我们考虑直接将其下载到服务器的GOPATH下，但很快否定了：1. 有可能有多版本的同时发布，而我们的旧代码策略是要存1天 2. 多个不同go项目同时发布也会造成影响，可能会让一些错误的项目成功build通过
　　git也要临时加到PATH中
　　不知道为什么，在服务器上可以dep通过的项目，但在jenkins的自动执行下，执行dep却报"git is not installed"的异常，我们的git放到了/usr/local/bin目录下，之前java项目命名运行很好，这个问题至今没研究出结果，可能和jenkins使用了自己的用户有关. 解决方案是在pipelien的脚本中把git地址再加入到PATH中
　　之后在pipeline的脚本中增加 dep ensure就可以，阿里云上下载还是比我们公司快很多的（经常是5分钟起），dep一次的时间完全在可接受范围内.
　　完成了这一步，在根目录执行go build生成二进制文件，并且ADD到docker image中，进行很顺利，但在docker run 时候执行这个二进制文件时候，问题又来了
　　 
　　注意构建环境 
　　docker container中执行这个二进制文件报"not found"，我们猜测是因为go build是在jenkins服务器上执行的，jenkins服务器是centos的，而基础镜像则选择了alpine，alpine缺少一些在centos下go build没有打进去c库. 最后还是选了一个其他大一点的基础镜像
　　 
　　以上就是我们这一天的坎坷经历，以下是处理过的pipeline脚本，供大家参考
　　 

• 　　node{
  
• 　　def VERSION
  
• 　　def REGISTRY = "{我们的镜像仓库地址}"
  
• 　　def ENV = "iot-dev"
  
• 　　stage("Preparation") {
  
• 　　sh "mkdir -p src/{我们的gitlab仓库地址}/arch/gmqtt"
  
• 　　dir("src/{我们的gitlab仓库地址}/arch/gmqtt") {
  
• 　　git branch: "dev_0.x", credentialsId: "080cf534-36fd-43ad-9ace-f499fe22ebbd", url: "http://{我们的gitlab仓库地址}/arch/gmqtt.git"
  
• 　　}
  
• 　　}
  
• 　　stage("Build") {
  
• 　　dir("src/{我们的gitlab仓库地址}/arch/gmqtt") {
  
• 　　VERSION = readFile "version.txt"
  
• 　　sh "export GOPATH=${WORKSPACE}:/usr/local/gopath && export PATH=$PATH:/usr/local/bin:/usr/local/bin/go/bin && /usr/local/gopath/bin/dep ensure && go build"
  
• 　　}
  
• 　　}
  
• 
  
• 　　... 后面是build docker image, push docker image以及deploy, 由于没有区别就不在这里介绍了
  
• 　　}
  

　　复制代码