基于Jenkins的ASP.NET CI搭建

使用Jenkins配置 .NET 自动构建(CI)

发布新的代码版本是一个简单的、重复的、费时的工作。使用自动化工具来完成构建是非常高效的。最终要实现的应用场景是:

在SVN中提交代码,服务器自动的进行编译、发布的工
作。

这里我们使用Jenkins来实现这个目标。本文将介绍如何使用“standalone”版本的Jenkins,Jenkins通常作为一个独立的应用程序在其自己的流程中运行,内置Java servlet容器/应用程序服务器(Jetty)。它可以非常方便的在你的本地机器上运行。

准备工作

JDK

Jenkins 是基于Java 开发的一款软件所以必不可少的就是要安装JDK了,需要注意我们只安装JDK8就可以了。

Jenkins

Jenkins是一款自包含的开源自动化服务器,可用于自动执行与构建,测试和交付或部署软件有关的各种任务(官网

Jenkins 官网

仅需下载war包即可。 (有时候由于网络问题可能官网的链接会很慢可以使用 镜像

.NET Framework

因为需要编译发布所以需要安装对应版本的 .NET Framework。

初次启动

执行指令启动Jenkins:
java -jar jenkins.war --httpPort=8080 // 你可以更换这里的端口号
服务启动后可以通过 http://localhost:8080/ (如果你没有更改默认端口号) 登录到Jenkins。

1.解锁Jenkins

解锁Jenkins

当你首次访问Jenkins的界面时,会要求通过自动生成的密码来解锁。在窗口中输入我们刚获取的随机密码。

启动过程中给出这个随机密码,如下图:

*************************************************************
*************************************************************
*************************************************************

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

763052939c804777811277ac6a108411   //随机密码 在第一次使用Jenkins时需要。

This may also be found at: /Users/LeoLiu/.jenkins/secrets/initialAdminPassword

*************************************************************
*************************************************************
*************************************************************

2.选择插件

选择插件模式

由于我们的项目是用 .NET 以及 SVN 所以和默认的用 Java 、Maven、 Git 的工具链非常不同。所以这里建议选择客制化安装插件。并且插件也可在之后再添加,所以无需担心是否有漏缺。


插件管理

为了发布 .NET 程序我们需要安装 MS Build 插件,同时为了trcaking SVN change 来构建代码,还需要安装SVN的扩展。

选择插件界面

3.创建Admin用户

最后Jenkins将会要求你创建第一个Admin用户(相当于Linux里的Root)。


创建账户
成员管理界面

到这里我们的准备工作就完成了,现在我们可以正式开始配置我们的构建服务了。

创建项目

配置MSbuild

MSBuild

安装MSBuild 之后在前文中提到过的 Configure System 里配置MSBuild的参数。


参数配置

创建新项目

之后打开并登录到Jenkins。之后在左边的连标汇总选择 New Item。这将打开一个如下界面


创建项目

由于我们要构建的是 .NET项目所以在这里我们选择 Freestyle project。

配置基本信息

第一个Tab页中可以配置构建项目的名称与描述

配置源代码管理

因为我们使用的是SVN,所以在这里我们选择SVN。如果没有SVN的选项的话就是没有成功安装SVN插件按之前的步骤重新安装一下。


SVN配置界面

我们需要首先添加一个SVN账户, 这里我建议专门创建一个用户供Jenkins拉取代码。填写这个账号的用户名与密码。


SVN账户配置

配置项目的Repository URL


Repository
  • Module:指svn上的模块。一个任务中可以添加多个不同来源的svn模块。
  • Repository URL:svn代码仓库的地址。
  • Credentials:访问svn代码仓库所需的认证。
  • Local module directory:检出到本机的文件夹路径
  • Repository depth:需要检出的文件夹深度,一般设为infinity(配置文件夹下的所有文件,包括子文件夹)
  • Ignore externals / Additional Credentials:忽略某些文件。
  • Check-out Strategy:更新svn到本地的几种方式。建议使用 Use 'svn update' as much as possible, with 'svn revert' before update (先放弃所有本地修改,然后尽可能进行svn更新。避免本地修改导致本地项目与代码仓库不一致)

配置构建

增加构建步骤,选择Build a Visual Studio project or solution using MSBuild:


然后填写信息。

MSBuild Build File 是项目文件或者工程文件的名称,简单的说就是需要发布的项目对应的项目文件,这里可以配置成相对路径,把有.svn文件目录当成根目录,如MSD_ClearCustomsNew/Uuch.MSD/Uuch.MSD.csproj,注意路径的斜杠是/

配置构建

/t:Build  /p:Configuration=Release /p:WebProjectOutputDir=E:\SourceCodePublish\Mobile /p:OutputPath=E:\SourceCodePublish\Mobile\bin

不同版本的VS在这里稍有区别在后面的发布部分会详细阐述。

配置触发事件

触发事件

对于Jenkins而言支持以上的触发事件,当然还可以通过安装不同的插件进行扩展。

这里我们主要关注里面的 Build periodically 和 Poll SCM。

Build periodically

可以让我们在每天的指定时间进行构建,其语法为 * * * * *

第一个表示分钟,取值0~59
第二个
表示小时,取值0~23
第三个表示一个月的第几天,取值1~31
第四个
表示第几月,取值1~12
第五个*表示一周中的第几天,取值0~7,其中0和7代表的都是周日

举个例子: 15 5 * * * 就代表了在每天的 5:15 AM 自动构建。但是我们往往需要的是间隔一段时间构建一次。那我们可用一下方法:

H/15 * * * * 每15分钟构建一次
45 9-16/2 * * 1-5 在周一到周五的 9点到16点之间的 每2个小时的 45分构建 第一个构建会在 9:45 最后一个在 15:45
H H/2 * * * 每2小时构建一次

Poll SCM

定时检查源码变更(根据SCM软件的版本号),如果有更新就checkout最新code下来,然后执行构建动作。


image.png

配置构建后操作

可选操作

Jenkins提供了丰富的构建后操作,例如生成文档、触发其他构建、发送邮件等,非常的实用。

手动触发构建

手动触发

直接点击图片中的绿色播放按钮就可以手动触发。

发布

VS2012+的Web站点发布

首先在VS中新建发布配置项


发布Web

配置好发布方式,以“文件系统”方式发布,需要注意的是,目标位置是服务器上的路径。

连接

设置

完成后,在项目的Properties/PublishProfiles可以找到这些*.pubxml文件

<?xml version="1.0" encoding="utf-8"?>

<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <WebPublishMethod>FileSystem</WebPublishMethod>
    <LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration>
    <LastUsedPlatform>Any CPU</LastUsedPlatform>
    <SiteUrlToLaunchAfterPublish />
    <LaunchSiteAfterPublish>True</LaunchSiteAfterPublish>
    <ExcludeApp_Data>False</ExcludeApp_Data>
    <publishUrl>C:\Jenkins_Publish\DEV_Metadata</publishUrl>
    <DeleteExistingFiles>True</DeleteExistingFiles>
  </PropertyGroup>
</Project>

可以直接在此修改配置。

配置参数
/t:Rebuild /p:Configuration=Release;PublishProfile=你的配置名称;DeployOnBuild=true;VisualStudioVersion=11.0  
  • PublishProfile 创建的Profile名称(不包含扩展名)
  • DeployOnBuild 设置编译并发布
  • VisualStudioVersion 这里填你的VS版本(VS2012 是 11.0)

VS2010发布

Command Line Arguments 填入

//t:Build  /p:Configuration=Release /p:WebProjectOutputDir=E:\SourceCodePublish\Mobile /p:OutputPath=E:\SourceCodePublish\Mobile\bin
  • WebProjectOutputDir 站点发布路径
  • OutputPath dll文件路径

可能遇到的问题

在上面配置的过程中,由于种种原因我们可能碰到这样或呢样的问题。笔者在这里对其中较为常见的问题进行了汇总。

无法安装插件

如果在浏览 available插件时产生错误,主要是由于缺乏证书导致的。可以通过一下设置来解决。

较为简单的一个选择是放弃https,而转用http协议。这样就简单的绕过了证书问题。但是对于正式的大项目这样可能有安全问题隐患。
更改为http

如何重启Jenkins

对于Windows在第一次启动Jenkins之后,可以使用 Net 命令来启动或关闭Jenkins服务。

 net start jenkins
 net stop jenkins 
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容