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

23decxf

　　当项目越来越庞大，部署环境越来越多以后，就会越来越依赖于自动化。比如本人公司的项目，目前有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站点，点击几下按钮就可以完成操作。
　　希望这篇文章能帮助到大家。