基于jenkins实现手动拉取码云代码，实现半自动化部署

本文紧接上文玩转jenkins  - 在自己的服务器上安装jenkins，不熟悉的可以先回顾下。

咱们这次来完成使用jenkins手动拉取我在码云的项目，之前都是登录服务器，然后切换到具体目录，拉取完成后再部署，这种人肉操作太累，所以必须要使用工具来完成，让我有更多的时间来刷剧。

本文要达到的具体目标：使用jenkins完成手动部署（半自动化部署）

ps：我的服务器：CentOs8 Linux

计划了几个想要达到的目标

• 在自己的机器上跑起来 done
  

• 使用jenkins将码云上的git仓库拉到服务器 done

• 将代码拉到服务器后，可以手动触发构建、部署 done

• 完成自动化部署

• 开发一个自己的插件，具体做啥还没想好

• 待定...

安装gitee（码云）插件

jenkins默认是不支持gitee的，但只需要安装一个插件就可以搞定。这个插件gitee已提供。

具体安装步骤如下

• 打开 Manage Jenkins -> Manage Plugins -> Available （本人jenkins还没汉化，只是觉得没必要，其实一个插件就可以搞定）

• 在 search 文本框内输入 Gitee

插件配置

上一步安装好了插件，这里要开始对插件进行配置。

打开具体配置项:Jenkins -> Manage Jenkins -> Configure System -> Gitee Configuration -> Gitee connections

• 链接名：在 Connection name 中输入 Gitee 或者你想要的名字，名字无所谓，只是用来显示

• Gitee host URL 中输入码云完整 URL地址：https://gitee.com （码云私有化客户输入部署的域名），一般填https://gitee.com 即可

• 证书令牌：Credentials右边选项点击add,选择jenkins

1. Domain 选择 Global credentials（全局凭据）

2. 类型（Kind）选择Gitee API 令牌（Gitee API Token）

3. 范围（Scope） 选择你需要的范围，根据个人想要这个凭据在哪个范围可使用，我选的是全局

4. Gitee API Token 输入你的码云私人令牌，获取地址：https://gitee.com/profile/personal_access_tokens

5. ID和描述（ID, Descripiton） 中输入你想要的 ID 和描述即可。（随便写，只是用来显示）

• 令牌添加完成后，选择刚自己添加的这个令牌

• 点击页面右侧的Advanced按钮 ，可配置是否忽略 SSL 错误（适您的Jenkins环境是否支持），并可设置链接测超时时间（适您的网络环境而定）

• 点击 Test Connection 测试链接是否成功，如果失败请检查以上 3，5，6 步骤（基本上一次过，没出现失败的情况）。

• 配置成功截图

  

  最后点击页面底部的保存，来保存我们的配置。

  

  新建构建任务

  这里就到了具体项目的配置，配置完成后再也不需要频繁登录服务器手动部署了。

  前往 Jenkins -> New Item , name 输入 'Test 码云'(项目名字自拟 )，选择 Freestyle project(自由风格) 保存即可创建构建项目。

  

  • 基本配置中，gitee 链接配置:选择我们刚刚配置好的证书名称。具体操作路径：前往某个任务（如'Test 码云'）的 Configure -> General，Gitee connection 中选择前面所配置的码云联机

  • 源码管理配置

  点击source code management tab

  1. 点击Git,Repository URL输入git地址，Credentials选择无即可（前提是我们已经把jenkins所在服务器的公钥配置在码云上了，该服务器可以直接使用git命令clone或pull码云的代码）

  2. 点击Advanced，Name中输入origin,Refspec输入+refs/heads/:refs/remotes/origin/ +refs/pull//MERGE:refs/pull//MERGE

  3. Branch Specifier (blank for ‘any’)输入origin/${giteeSourceBranch}，我这里按照默认的配置，使用master分支

  

  由于我还没有配置gitee ssh，所以这里使用的是http协议，然后配置下gitee的账号密码认证即可。

  

  到此gitee插件基本配置完成，剩下的就是当gitee代码更新到服务器后需要做的操作了，比如执行npm i,npm run build然后部署服务。当然全部的配置还没完，还有一个非常重要的操作，那就是自动部署，也就是触发器配置，这个咱们后面文章再说。

  测试配置是否成功

  页面拉到最后，找到build选项，添加构建步骤，选择execute shell，然后输入echo hello，测试下我们构建后的结果。

  

  构建成功截图

  

  从日志中能看到，jenkins先拉取git项目代码，然后执行了我们配置好的shell脚本。

  项目部署

  就差一步就可以让我们的项目跑起来了，这里大家最熟悉不过了，看命令就知道。

  npm install //安装依赖
  npm run build  //构建打包
  PORT=9001 pm2 start app.js -n testMyproject --watch -- env:production //使用pm2 启动服务，并且设置端口和文件监听，代码有变动会自动重启
  

  

  最后

  到这里我们整个配置就完成了，以后就可以通过半自动化的方式来部署项目了，虽然是半自动化，但和之前手动部署相比已经方便太多了。当然我们的终极目标是自动部署，咱们后面的文章继续撩。

  参考资料：https://gitee.com/help/articles/4193#article-header0

  点个在看支持下