.NET Core 从 Github到 Nuget 持续集成、部署

一.前言

Nuget 做为一个.NET研发人员，我想你都不会陌生，他为咱们提供很是方便的程序包管理，无论是版本，仍是包的依赖都能轻松应对，能够说是咱们的好助手。而 Nuget 除了官方nuget.org之外，咱们也能够用起提供的程序包快速构建一个Nuget Server，打造企业内部的私有 Nuget，用来管理项目的package是十分方便的，相对于咱们直接引用DLL，他能够方便的控制程序集版本和依赖。今天讲讲Nuget如何进行持续集成、部署，能够减小咱们更新package所需时间。

对nuget上传包以及使用nuget命令有不了解的朋友能够花几分钟看下这两篇文章：

• 发布你的程序包到Nuget

• 使用 dotnet cli 命令上传 nuget 程序包

二.为何用github？

若是用过持续集成的朋友都应该知道持续集成工具从代码仓库拉去代码，今天我选用github来进行讲解，由于github做为全球最大的开源社区，汇集了很是多的项目代码，你是否有注意Nuget上面的程序包很大一部分都是开源的，并且大部分都是开源在github的，因此github结合Nuget是很是不错的。

三.Jenkin 从配置 github 拉取代码

Jenkins算是使用量比较多的一个持续集成工具，关于它咱们写了一个系列，能够参考下 http://www.cnblogs.com/stulzq/p/8629165.html

1.建立 github AccessToken

(1) 选择 用户下拉列表选项中的 “Setting”

(2) 选择 “Developer settings”

(3) 选择 “Personal access tokens”->“Generate new token”

(4) 选择下图的权限

而后点生成就能够了，必定要保存好这个token

2.配置Jenkins

(1) 进入 “系统管理”->"管理插件" 安装 Github Plugin插件

(2) 而后进入 “系统管理”->“系统设置->Github Server” 添加以下信息

Credentials 那里点击 Add 添加以下信息

添加完毕以后记得选择咱们刚刚添加的信息

最后点击"Test Connection"若是配置正确应当有以下显示：

3.建立任务

(1) 建立一个自由风格的任务：

(2) 勾选 Github Project 填入github仓库url

(3) 源码管理选择git，填写仓库git地址，选择须要构建的分支，我这里选择master （** 为选择全部分支）

(4) 构建触发器选择 GitHub hook trigger for GITScm polling

(5) 而后添加构建步骤 Shell ，填入构建和部署的命令

(6) 如何编写构建命令 按照以下格式编写

# 编译项目
echo "begin build..."
dotnet build Alipay.AopSdk.Core.sln -c Release
echo "build success"

# 建立nuget临时存放目录和归档目录
mkdir /publish/nuget/aopsdk/$(date +%Y%m%d) -p
mkdir /publish/archives/$(date +%Y%m%d) -p

echo "begin pack..."

# 打包项目 Alipay.AopSdk.Core 并输出到临时存放目录
echo "pack Alipay.AopSdk.Core..."
dotnet pack Alipay.AopSdk.Core/Alipay.AopSdk.Core.csproj -c Release -o /publish/nuget/aopsdk/$(date +%Y%m%d)
echo "pack Alipay.AopSdk.Core success"

# 发布到nuget.org
echo "begin push..."
dotnet nuget push /publish/nuget/aopsdk/$(date +%Y%m%d)/*.nupkg -k <你的api key>-s https://api.nuget.org/v3/index.json
echo "push success"

# 归档package
mv /publish/nuget/aopsdk/$(date +%Y%m%d)/* /publish/archives/$(date +%Y%m%d)

最后点击保存。

4.最后一步，注册webhook钩子

回到咱们的 "系统管理"->系统设置"->"Github Server" 选择高级（有两个高级 别选择错了）

而后进行以下操做为咱们的仓库建立钩子

若是建立成功，到咱们github仓库 “Setting”->"Webhooks" 应当能够看见github插件已经为咱们自动建立了一个钩子：

到此，咱们的配置就结束了，若是提交代码到对应分支，就会触发构建，若是构建成功就会上传package到咱们的Nuget，十分方便，好了赶忙去享受吧。

若是出错，咱们能够 控制台日志来查出错误。

四.常见问题

• 若是部署到企业内部的私有Nuget Server，只需修改 dotnet nuget push -s 参数后的地址就好了。

• 若是采用我前面写的系列教程安装的Jenkins因为是采用Docker容器运行的，因此自带没有dotnet core的环境，须要进入Docker容器，安装才行，在dotnet core 官网下选择安装的时候，系统选择 Debian 9 https://www.microsoft.com/net/learn/get-started/linux/debian9

• 搭建私有Nuget ，请看这篇文章 https://www.jianshu.com/p/08e43b822137

五.写在最后

配置看似很繁琐，其实很简单，配置过一次，再配置第二次就是手到擒来，祝你们配置成功，若是有什么问题也能够加入下方QQ群进行提问。最后想说一句话，NET Core 的生态构建须要你的参与，但愿你们能共同支持.NET Core成长。欢迎你们加入NCC https://github.com/dotnetcore

NCC 全称 .NET Core Community（同时保有 .NET China Community 的名称，其缩写为 dotnet-china），成立于 2016 年年中。NCC（时名为 .NET Core 中国学习小组）最初项目为微软 ASP.NET Core 文档翻译项目，为第一批学习 ASP.NET Core 的中文圈开发人员提供了巨大便利，后微软逐步文档国际化，该翻译项目完成所有历史使命。后经历屡次调整，最终改名为 .NET Core Community，是一个目前包括 12 个成员项目（含 1 个外部项目）、4 个子团队的正不断成长、完善，并正加速前进的 .NET/.NET Core 开源社区组织。