今天我们来谈谈NetCore在Linux底下的持续集成与部署。NetCore我就不多介绍了,持续集成用的是Jenkins,源代码管理器用的是GitHub。我们就跟着博文往下走吧。

1.Linux环境

在进行自动构建之前,我们需要一个可以运行的Linux环境,并保证环境安装了NetCoreSDK,Git,Jenkins等环境,那在这边就不多说环境的安装,提供相对应的安装教程,大家按照安装就可以,不过对Jenkins的安装,我会多啰嗦一句。

啰嗦的那一句
我在安装Jenkins成功的时候进入网页,网页会一直保持在下面图这个状态,没办法进入到开始页面,那解决办法是:

jenkins 指定linux路径_自动构建

Jenkins等待

  1. 进入到Jenkins的工作目录/var/lib/jenkins/修改hudson.model.UpdateCenter.xml文件
  2. http://updates.jenkins-ci.org/update-center.json修改为http://mirror.xmission.com/jenkins/updates/update-center.json
  3. 重启下Jenkins
2.Jenkins自动构建
定时构建
  1. chown jenkins /ftpfile -R  

  1. chmod 777 /ftpfile -R 

  1. dotnet restore 

  1. dotnet build 

  1. dotnet publish 

  1. 创建Jenkins项目
  2. jenkins 指定linux路径_Core_02

  3. 配置好自定义工作目录
  4. jenkins 指定linux路径_Core_03

  5. 填写源代码路径
  6. jenkins 指定linux路径_Core_04

  7. 配置定时任务

字段

*

*

*

*

*

含义

分钟

小时

日期

月份

星期

取值范围

0-59

0-23

1-31

1-12

0-7







示例






每隔15分钟执行一次

H/15

*

*

*

*

每隔2个小时执行一次

H

H/2

*

*

*

每隔3天执行一次

H

H

H/3

*

*

每隔3天执行一次(每月的1-15号)

H

H

1-15/3

*

*

每周1,3,5执行一次

H

H

*

*

1,3,5







规则






指定时间范围

a-b





指定时间间隔

/





指定变量取值

a,b,c





  1. 配置构建命令
  2. jenkins 指定linux路径_自动构建_05

  3. 查看构建,并运行NetCore
    注意:
    因为你建立的自定义工作目录,对于"jenkins"没有读写权限,所以可能就会导致构建失败,执行下面命令,给Jenkins赋予读写权限。
触发构建
  1. 提交代码
  2. jenkins 指定linux路径_Core_06

  3. 查看Jenkins
  4. jenkins 指定linux路径_Core_07

  5. 切换成触发构建
  6. jenkins 指定linux路径_自动构建_08

  7. 使用密文模式,并添加绑定,选择刚才添加的凭据
  8. jenkins 指定linux路径_Core_09

  9. 添加GitHub服务器

    2.添加GitHub的凭据,也就我们刚才拿到得accessToken
  10. 进入Settings页面,找到左边列表的Developer settings,点击进入,可以看到如下:
  11. jenkins 指定linux路径_Jenkins_10

  12. 点击生成,然后勾选,,保存即可,就可以获得token,顺便说下,token要记下来,不然关闭页面就看不到了。
  13. jenkins 指定linux路径_jenkins 指定linux路径_11

  14. 在项目设置中找到webhook
  15. jenkins 指定linux路径_Jenkins_12

  16. 设置Jenkins的hook地址到刚才添加的webhook中,

Jenkins的hook地址为:http://你的地址(端口)/github-webhook当然这个地址应该是外网可以访问的

  1. 配置GitHub
    针对我们的项目,我们要在自己的项目内添加webhook,并配置好webhook的地址。
  2. Personal access tokens
    对于任何第三方访问GitHub的项目,是需要授权的,Jenkins也是一样的,所以我们需要先获取一个accessToken
  3. Jenkins配置
    上面的配置完成之后,我们需要返回Jenkins,进行再次设置。为Jenkins添加GitHub服务器。
  4. Jenkins任务配置
    因为我们已经将触发构建的前置步骤都做完了,那接着我们就要去修改之前的定时构建的配置了
  5. 修改代码,上传GitHub
    终于我们将之前的定时构建改成了触发构建,也就是我们每次Push代码都会触发构建,接下来我们试下。
3.NetCore部署

终于的终于,我们把构建这个步骤做好了,那么接下来当然就是要部署我们网站咯。

  • 运行NetCore
    运行NetCore最简单了,我们只需要在发布后的目录运行dotnet ***.dll就可以了,当然,前提,你要装CoreSDK。
  • jenkins 指定linux路径_jenkins 指定linux路径_13

  • nginx托管
    虽然说上面那样已经运行起来,但是由于我们的环境在腾旭云上,要访问可以用nginx进行方向代理下,下面就简单贴下配置就可以了。
  1. server { 

  1. listen 80; 

  1. location / { 

  1. proxy_pass http: 

  1. proxy_http_version 1.1; 

  1. proxy_set_header Upgrade $http_upgrade; 

  1. proxy_set_header Connection keep-alive; 

  1. proxy_set_header Host $host; 

  1. proxy_cache_bypass $http_upgrade; 



守护进程
我们已经知道要运行Core,需要使用命令在控制台运行,但是一旦退出了,Core自然就退出了,所以我们在Linux底下需要一个类似IIS的,来托管我们运行Core的进程,守护进程,让其在后台运行,自动重启等等功能,这个就是supervisor

supervisors是C/S架构的进程控制系统,可使用户在类UNIX系统中监控、管理进程。常用于管理与某个用户或项目相关的进程。

安装教程可以参考开始表格supervisor的链接,同样怎么对于怎么对Core进行守护进程,文章内也有讲,一步一步按照教程来就可以了。不过我这边还是会讲下我在使用supervisor中遇到的坑。

jenkins 指定linux路径_Jenkins_14

  1. 一开始,我百度了挺多的,发现百度中的文章,对于supervisor的日志文件,很多都说在/etc/log/supervisor/supervisord.log这个文件内,但其实我去找的时候,发现并没有,查看配置文档,发现默认是在tmp中,我不知道是centeros 的版本问题,还是supervisor版本问题。
  2. 还有一个就是,在根据教程走完,配置后,要进行启动时,可能会出现Unlinking stale socket /tmp/supervisor.sock 这个错误,我们只需要解锁下就可以了unlink /tmp/supervisor.sock
4.总结一下

该篇文章简单介绍了下Linux下Jenkins与GitHub自动构建NetCore与部署,很多细点我可能没讲出来,我把大大的教程贴出来,按照教程走起,就可以了,这也是我实践过了的,肯定可以用的,非常感谢大大们,然后呢,我也想抛砖引玉下,在我Jenkins构建时有两个问题,不知道谁可以帮我解答下。

  1. 比如我们的解决方案文件.sln并没有在git项目的根目录下,我们要指定需要构建的解决方案呢?
  2. 还有一个就是,在命令dotnet publish我们怎么指定发布到另一个文件夹内呢,我知道有个参数-o|--output <OUTPUT_DIRECTORY>,我试了下,发现不行 dotnet publish -o /ftpfile/netCore/netCoreJenkins/JenkinsNetCore,会有以下的错误。

最后的最后,我的下一篇文章是《Linux下Jenkins与GitHub自动构建Node项目(Vue)》,期待0.5下吧。