jenkins在windows上自动化部署.Net（.Net Core）项目-C#/.NET开发

前言什么是持续集成呢？Continuous integration（CI）。持续集成是一种软件开发实践，即团队开发成员经常集成他们的工作，通常每个成员至少集成一次，也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建...

前言

　　什么是持续集成呢？Continuous integration（CI）。持续集成是一种软件开发实践，即团队开发成员经常集成他们的工作，通常每个成员至少集成一次，也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建（包括编译，发布，自动化测试）来验证，从而尽快地发现集成错误。许多团队发现这个过程可以大大减少集成的问题，让团队能够更快的开发内聚的软件。

　　如果没有持续集成会有哪一些问题呢？模块项目接口部署不及时，接口不通。每次需要手动打包最新的代码进行部署、发布代码、线上部署都是纯手工。容易出错。浪费时间。

　　现在加上持续集成解决的问题呢？项目构建自动化、集成的详细信息及历史记录的记录、使用统一的管理、固定规定的部署流程、每天至少集成一次。

安装

　　这里我采用的是使用Tomcat配合jenkins一起使用的来达成持续集成的目的。

　　一、安装Tomcat

　　　　从官网下载Tomcat。下载地址：http://tomcat.apache.org/。

　　　　这里我选择的是32-bit/64-bit Windows Service Installer (pgp, sha512)这个版本。然后依次安装就可以了。

接下来配置环境变量：

一、修改设置：CLASSPATH：（.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%）。注意是第一个符号点！！

二、新增设置：CATALINA_HOME：（D:\tool\apache-tomcat-7.0.57）括号内为路径名。

三、修改设置：path：（;%JAVA_HOME%;%JRE_HOME%\jre\bin）若以前配置java环境时配置过则不要再次配置。

　　　　安装就差不多完成了，我们在浏览器输入http://localhost:8080/来看看是否出现以下页面，出现了的话就说明安装成功了。

　　二、安装JDK

　　　　安装JDK可以查阅这篇文章——https://www.runoob.com/java/java-environment-setup.html

　　三、安装Jenkins

　　一切准备就绪之后，就开始安装jenkins了，下载地址：https://jenkins.io/download/。前往地址下载jenkins的 war包。然后将war包放置在前面安装的Tomcat的目录之下（C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps——我的地址是这个）。

然后在浏览器中输入http://localhost:8080/jenkins/。访问，安装成功的话就会出现jenkins的界面

这里根据提示我们找到目录之下就可以获取密码了。接下来会出现插件安装的一个选择，新手直接选择新手入门推荐安装就好了。

这里有时会出现安装失败或者链接失败的情况，多试几次就好了。一般是网络的问题。

创建管理员用户之后就可以正式开始配置jenkins了。

配置

一、插件安装

　　这里需要安装暂且有三个插件，一个是MSBuild Plugin、一个是 Publish Over SSH、一个是Email Extension Plugin。前者是用来作为编译的插件，后者是用来作为连接服务器的插件、最后一个则是用来配置邮件发送的插件了。

二、邮箱配置

　　进入系统设置，正式开始配置邮件发送的配置。

　　首先找到Jenkins Location设置系统管理员的邮件地址。

　　然后找到Extended E-mail Notification设置，这里就可以开始设置邮件的发送配置了。这里我采用的是qq邮箱的配置。

SMTP server——SMTP 服务器的配置

Default user E-mail suffix——默认电子邮件的后缀

User Name——这里设置的是发件人信息（12345678@qq.com-在这里就输入12345678）

Password——这里不是填写密码，这里输入的是开通SMTP 的授权码

SMTP port——SMTP 默认端口开启465

Default Content Type——邮件内容的格式

Default Recipients——默认收件人

Default Subject——默认主题

Default Content——默认内容

邮件通知内容的配置的模板：

<!DOCTYPE html>    

<html>    

<head>    

<meta charset="UTF-8">    

<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>    

</head>    

    

<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"    

    offset="0">    

    <table width="95%" cellpadding="0" cellspacing="0"  style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">    

        <tr>    

            本邮件由系统自动发出，无需回复！<br/>            

            各位同事，大家好，以下为${PROJECT_NAME }项目构建信息</br>

            <td><font color="#CC0000">构建结果 - ${BUILD_STATUS}</font></td>   

        </tr>    

        <tr>    

            <td><br />    

            <b><font color="#0B610B">构建信息</font></b>    

            <hr size="2" width="100%" align="center" /></td>    

        </tr>    

        <tr>    

            <td>    

                <ul>    

                    <li>项目名称 ： ${PROJECT_NAME}</li>    

                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>    

                    <li>触发原因： ${CAUSE}</li>    

                    <li>构建状态： ${BUILD_STATUS}</li>    

                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>    

                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>    

                    <li>工作目录 ： <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>    

                    <li>项目  Url ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>    

                </ul>    

 

<h4><font color="#0B610B">失败用例</font></h4>

<hr size="2" width="100%" />

$FAILED_TESTS<br/>

 

<h4><font color="#0B610B">最近提交(#$SVN_REVISION)</font></h4>

<hr size="2" width="100%" />

<ul>

${CHANGES_SINCE_LAST_SUCCESS, reverse=true, format="%c", changesFormat="<li>%d [%a] %m</li>"}

</ul>

详细提交: <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a><br/>

 

            </td>    

        </tr>    

    </table>    

</body>    

</html>

三、 Publish over SSH配置

接下来我们就开始配置SSH连接服务器配置了。

按照上面的配置进行设置就可以了。

Passphrase——密码或密钥

Name——此连接服务的名称

Hostname——服务器的地址

Username——服务器用户名

Remote Directory——传输的远程目录

Use password authentication, or use a different key——此选项可另设置其他的密码

四、全局工具配置

进入Global Tool Configuration设置全局工具设置，这里首先我们得设置git，这个不设置后面可能就拉取不到代码了。再然后设置MSBuild，这个设置就是用来给项目进行编译的。

构建

到这里安装和配置都已经结束了。我们可以正式开始构建项目了。这里我们分为对.Net 和.Net Core项目进行集成。配合使用则是Git进行代码的提交及拉取。

这里我们选择开始构建一个自由风格的项目。

然后进行项目描述填写

这里就开始设置源代码管理了。选择git并输入地址。随后点击高级，设置用户名和密码，然后返回此页面选择刚设置的证书即可

然后开始构建触发器，这里我设置的触发器的时间是每分钟轮询是否触发。时间大家可以根据情况而定

这里的构建环境，大家可以视情况而定。

到这里就正式开始构建配置了。这里我选择的是使用MSBuild构建VS项目。

/t:Rebuild

/p:Configuration=Release

/p:DeployOnBuild=true;PublishProfile=FolderProfile

/p:OutputPath=D:\Jenkins_Publish

MSBuild Build File——构建的目录（例如我的就填写的C:\Windows\ServiceProfiles\LocalService\.jenkins\workspace\Test_Net\WebApplication1\WebApplication1.csproj）

Command Line Arguments——构建的命令

Rebuild ——重新生成

Configuration=Release——生成Release版本

DeployOnBuild=true;PublishProfile=FolderProfile——设置运行部署生成，并且执行FolderProfile目录下的生产目录（FolderProfile文件在Properties目录中）

OutputPath——输出路径

这里我看开始配置构建完成之后的操作的短信配置了。

到这里就已经都配置完成了，我们可以返回主页面开始构建了。

点击立即构建，不一会我们就收到了邮件

到这里我们使用git加上jenkins搭建的.Net 项目持续集成就完成了。那么我们接下来看对于.Net Core项目如何进行持续集成的呢。因为.Net Core 项目可以部署在Linux上，所以下面我们就以Linux作为服务器。在本地进行集成然后发布到Linux。其他的操作都是一样的，主要在构建操作和构建后操作不同。我们下面主要介绍构建操作和构建后操作。

dotnet restore

dotnet build   

dotnet publish  -c:Release -r centos.7-x64 --self-contained false   -o C:\Windows\ServiceProfiles\LocalService\.jenkins\workspace\Test_Net_Core\WebApplication2\bin\Release\netcoreapp2.2\centos.7-x64

echo 压缩开始

 cd  C:\Windows\ServiceProfiles\LocalService\.jenkins\workspace\Test_Net_Core\WebApplication2\bin\Release\netcoreapp2.2

 7z a -tzip publish.zip C:\Windows\ServiceProfiles\LocalService\.jenkins\workspace\Test_Net_Core\WebApplication2\bin\Release\netcoreapp2.2\centos.7-x64

echo 压缩结束

dotnet restore——还原

dotnet build ——构建

dotnet publish——发布

-c:Release ——Release 版本

-r centos.7-x64 ——linux版本

--self-contained false ——框架依赖

-o D:\Jenkins_CorePublish ——发布文件到此目录下

后面增加了一个压缩命令，将发布文件压缩成一个压缩包，这个是方便后续上传到服务器的。SSH上传仅上传文件。不带上传文件夹。所以我们需要进行压缩。后续上传到服务器再进行解压。

然后开始配置构建后操作，一样的需要配置邮件信息，邮件信息与上面的配置一样即可。这里我们主要配置如何连接SSH。

这里需要注意的是上传的源文件。这里基目录是你的jenkins工作目录，所以需要相对于填写位置

这里配置上传文件及解压等操作然后重新启动linux服务器上的服务完成发布。

cd /home/hlz

rm -f publish

unzip publish.zip

rm -f publish.zip

cd /root

systemctl  enable Test.service

systemctl  start Test.service

systemctl  status Test.service

总结

　　到这里在windows上使用jenkins持续集成就完成了。中间还有一些细节需要另行配置的都可以自由发挥，主要流程大概就是这么多了。这里的是通过在本地继续集成然后通过Publish over SSH插件传输到linux服务器进行.Net Core项目的部署的。那么我们也可以直接在Linux上部署Jenkins，这样就不需要这一步连接服务器的操作了。可以直接在服务器上一次性解决问题。

　　逃避不一定躲得过，面对不一定难受．转身不一定最软弱．

欢迎大家扫描下方二维码，和我一起踏上设计模式的闯关之路吧!