利用PowerShell+Jenkins，实现项目的自动化部署

当项目越来越庞大，部署环境越来越多以后，就会越来越依赖于自动化。比如本人公司的项目，目前有6个web和4个windows service，同时本地有两套环境：开发自测试环境和QA测试环境。每次版本发布，需要先部署开发自测试环境；开发人员自测试通过以后，将部署的版本部署到QA测试环境；QA测试通过以后，将本次版本打包作为发布版本，交给运维人员部署生产环境。

在以往，每次本地部署的流程是：开发人员获取最新代码-编译发布-远程连接部署机-上传版本文件-备份项目-实施部署（文件覆盖）。每次操作千篇一律，重复性很高，又非常耗时，极大影响了开发人员的工作效率。上周，我开始调研项目的自动化部署，今天搭建完毕，说下这段时间的心得。

1.选择Jenkins

调研开始，我就首先了采用Jenkins作为操作工具，它提供了SVN/Git,MSBuild等插件，可以满足自动获取代码和编译；同时提供了完善的UI，方便操作。

2.选择PowerShell

最开始的设想，是在构建步骤中可以通过命令行函数与操作系统交互。但是由于我们环境的特殊性（需要部署不同的环境，同时同一环境包含不止一台服务器），单纯的命令行函数无法跨服务器执行。最后决定采用PowerShell，主要是看中它以下优点：

可以远程调用
可以编写自己的业务逻辑代码，语法简单

3.环境的准备

我选择的PowerShell版本是V5.0。网上搜索一下安装包，下载后在服务器安装即可。作为安装PowerShell的先决条件，.Net Framework 4.5也是必须安装的。

首先是选择一台独立的自动化部署服务器，在此服务器安装Jenkins,PowerShell。最好也把VisualStudio装上，否则GAC会缺少一些关键的类库。此服务器需要远程调用其它服务器的PowerShell命令，因此是个客户端机，在安装完PowerShell后，需要设置服务器白名单。

PS C:\Users\53738> winrm set winrm/config/client '@{TrustedHosts="*"}'

所有的环境服务器需要安装PowerShell，同时开启远程访问

PS C:\Users\53738> winrm quickconfig

4.如何编译发布项目

通过MSBuild，可以实现.Net项目的编译与打包。

以下是我发布web的命令:

PS C:\Users\53738> C:\Windows\Microsoft.NET\Framework64\v4.0.30319\MSBuild.exe 'xxx.csproj' /p:DeployOnBuild=true /p:PublishProfile='$($project.PublishFile)' /p:SolutionDir='$($project.SolutionDir)' /p:VisualStudioVersion=14.0

几个参数的含义：

xxx.csproj:项目文件路径

PublishProfile:在用VS执行发布操作时，会生成这个文件。里面指定了发布操作的各种配置参数，比如发布路径，基于X86/X64平台等

SolutionDir:解决方案文件夹

VisualStudioVersion:安装VisualStudio时会安装一些SDK，这个参数告诉MSBuild该去哪里找这些SDK。由于我安装的是VisualStudio 2013，因此此处填写了14.0。如果不想每次都填写这个参数，也可以在csproj里面搜索这个参数名称，填写一个默认值。

以下是我发布WindowsService的命令

PS C:\Users\53738> C:\Windows\Microsoft.NET\Framework64\v4.0.30319\MSBuild.exe 'xxx.csproj' /p:SolutionDir='$($project.SolutionDir)' /p:VisualStudioVersion=14.0 /p:Platform=x64 /p:Configuration=Release

5.如何部署到远程服务器

要远程访问服务器，首先是利用PowerShell的New-PSSession命令，填写远程服务器的管理员账号密码登陆，获取Session

PS C:\Users\53738> New-PSSession -ComputerName RemoteComputerName -Credential Get-Credential

Get-Credential是个交互函数，执行时会弹出一个用户名密码对话框，因此我们要人为构造一个PSCredential。改写一下方法

PS C:\Users\53738> $pass=ConvertTo-SecureString -String 'your password' -AsPlainText -Force

$cre=New-Object pscredential('your username', $pass)

$session=New-PSSession -ComputerName $server -Credential $cre

获取Session以后，远程服务器已经完全落入我们的掌心。现在可以通过Invoke-Command远程执行命令，可以用Enter-PSSession直接进入远程会话，可以通过Copy-Item实现文件传输。以下是我在部署过程中遇到的常用的命令。

远程停止Windows Service:

PS C:\Users\53738> Invoke-Command -Session $session -ScriptBlock{

    Stop-Service -Name 'your service name'

}

远程停止Web:

PS C:\WINDOWS\system32> Invoke-Command -Session $session -ScriptBlock{

    $site=Get-Item 'IIS:\Sites\Your site'

    $site.Stop()

}

拷贝本地文件到远程服务器

PS C:\WINDOWS\system32> ls "local folder" | cp -Destination "remote folder" -ToSession $session -Recurse -Force

拷贝远程服务器文件到本地

PS C:\WINDOWS\system32> cp -FromSession $session -Path "Remote File" -Destination "Local Folder" -Recurse -Force

将文件打包成zip

PS C:\WINDOWS\system32> Compress-Archive "Folder" -DestinationPath "Zip File Name" -Force

将zip文件解压

PS C:\WINDOWS\system32> Expand-Archive "Zip File Name" -DestinationPath "Folder" -Force

释放PSSession

PS C:\WINDOWS\system32> Remove-PSSession -Id $session.Id #使用完毕后一定记得释放PSSesion

6.与Jenkins集成

Jenkins提供了PowerShell Plugin，实现了与PowerShell的集成。但是最好修改Jenkins的服务为以管理员用户登录，否则Jenkins默认以本地用户方式调用PowerShell，在执行远程脚本时会出现权限问题。修改方式很简单，进入服务-右键Jenkins-属性-登录，按下图方式配置

我在Jenkins创建了2个项目，一个用于部署研发自测试环境，一个用于部署QA测试环境。

以部署研发自测试环境为例，整个流程大致如下：

操作人员在执行构建页面，填写要部署的源代码分支路径
Jenkins将用户填写的代码路径作为启动参数传递给PowerShell脚本
PowerShell脚本启动
- 进入指定的代码目录，用SVN Update命令下载代码。
- 执行MSBuild编译
- 获取环境服务器session
- 停止环境服务器上的站点和服务
- 将环境服务器上的项目文件打包备份
- 将本地发布的文件覆盖到环境服务器
- 启动环境服务器上的站点和服务

这样，就完成了整个项目的自动化部署，每次部署时操作人员只需要进入Jenkins站点，点击几下按钮就可以完成操作。

希望这篇文章能帮助到大家。