Jenkins持续部署-自动生成版本号

时间  2019-11-09
标签 jenkins 持续 部署 自动 生成 本号 栏目 自动化构建 繁體版
原文   原文链接

目录html

Jenkins持续部署-自动生成版本号

目录

Jenkins持续集成学习-Windows环境进行.Net开发1
Jenkins持续集成学习-Windows环境进行.Net开发2
Jenkins持续集成学习-Windows环境进行.Net开发3
Jenkins持续集成学习-Windows环境进行.Net开发4
Jenkins持续集成学习-搭建jenkins问题汇总
Jenkins持续部署-Windows环境持续部署探究1
Jenkins持续部署-自动生成版本号shell

前言

在上一篇以前的文章开始对Windows环境下持续部署的方案进行学习与研究。上一篇文章主要介绍关于持续部署须要的一些技术方案的实现，在本篇文章开始对持续部署的一些细节实现展开讨论。
本篇文章先对版本号的自动更新流程进行梳理和说明。后续须要经过版本号比较建立差量更新包。c#

目的

本章文章主要是经过调用svn客户端命令和powershell脚本实现彻底无需人工干预自动生成版本号。bash

详细流程

若程序须要定义版本号，则能够将版本号记录在程序集的AssemblyInfo.cs文件中app

[assembly: AssemblyVersion("1.0.0")]
[assembly: AssemblyFileVersion("1.0.0")]

也能够在程序集右键选择属性(或者经过快捷键Alt + Enter)，在Application点击Assembly Infomation...按钮修改程序集版本号和文件版本号。svn

20190629173644.png

AssemblyVersion是程序集的版本，.NET的CLR用于标识出该dll的版本信息，用于定义强名称的版本号,该版本号每一位最大为16位长度，即最大为65535，超过期编译不经过。
AssemblyFileVersion是文件版本号，仅仅是文件版本号，给人看的，没有实际什么做用，也没有长度限制。工具

获取SVN Reversion

咱们规定程序的版本号为需求版本号1.0.0加上SVN的Reversion作为修订号。这样就能直接关联上该程序集是哪一个版本的代码。
关于修订号，在《TortoiseSVN》文档中有相关的说明。我看的是《TortoiseSVN 1.8.10》的文档，在第五章介绍了SubWCRev程序。经过SubWCRev程序能够执行关键字$WCREV$替换。同时咱们须要提供一个版本号模板文件，经过替换版本号模板文件的关键字生成咱们须要的版本号文件。post

首先咱们根据程序集下AssemblyInfo.cs文件复制出一个AssemblyInfo.template.cs文件。visual-studio

因为咱们仅仅是为了修改版本号信息，后面就称之为版本号模板文件。学习

而后将其[assembly: AssemblyFileVersion("1.0.0.0")]修改成[assembly: AssemblyFileVersion("1.0.0.$WCREV$")]。这样咱们就能够经过SubWCRev程序替换修订号。

20190629221330.png

因为AssemblyVersion有大小限制，不容许超过65535，而SVN修订号颇有可能会超过该值，所以CLR的程序集版本号不用改修订号。只须要修改文件版本号便可。

因为在编译时,VS会编译AssemblyInfo文件提取出程序集信息放入到程序集内。咱们直接复制出来的版本号模板文件默认也会进行编译。而咱们建立的版本号模板文件用于生成版本号文件，无需编译。咱们须要的是经过版本号模板文件生成版本号文件，即经过AssemblyInfo.template.cs生成AssemblyInfo.cs。所以在版本号模板文件右键属性中将Build Action从Compile修改成None。

20190629221252.png

此时咱们已经有了版本号模板文件,接下来要作的是在编译的以前先根据版本号模板文件建立咱们须要的版本号文件。
VS编译的时候提供了编译前预处理功能和编译后处理功能。在程序集属性中，咱们选择Build Event里面有Pre-build event command line,经过在里面输入指令能够实如今编译前执行咱们想要的命令。

20190629181431.png

同时VS内部也提供了一些宏指令供咱们使用，经过点击Edit Pre-build按钮，会弹出一个编辑框

20190629181601.png

点击Macros能够查看全部VS支持的宏指令

20190629181733.png

SubWCRev程序命令格式为SubWCRev WorkingCopyPath [SrcVersionFile DstVersionFile] [-nmdfe],WorkingCopyPath为SVN的工做副本，SrcVersionFile为原始版本文件，即版本模板文件。DstVersionFile为替换关键子后保存的版本文件。
在VS环境变量中咱们能够经过$(ProjectDir)获取到当前程序集路径，经过$(SolutionDir)获取到解决方案路径。

宏指令为$(指令名)格式

在预编译事件中输入如下指令SubWCRev $(SolutionDir) $(ProjectDir)Properties\AssemblyInfo.template.cs $(ProjectDir)Properties\AssemblyInfo.cs便可在编译前获取到SVN的reversion填充到修订号中。

编译后能够在输出窗口看到关键字替换的信息

1>------ Build started: Project: FGMain, Configuration: Debug Any CPU ------
1>  SubWCRev: 'F:\工做\SVN\Platform\trunk\FGMain\FGMain\'
1>  Last committed at revision 100268
1>  Mixed revision range 100267:100268
1>  Local modifications found
1>  Unversioned items found

获取需求号

在实际工做中，咱们每次发版都会有一个需求版本号。当产生需求时整个版本都会使用这个版本号。所以咱们能够在开发的时候就在开发分支上建立该版本号的需求分支。分支名称以版本号命名，这样程序就能够获取到URL的版本号信息填充到版本号模板号模板文件中。而省去了人为修改版本号的麻烦。

好比当前版本号为1.32.0，则在SVN程序的分支上建立一个1.32.0的版本。branches/FGMain/1.32.0。

接下来在咱们使用SubWCRev程序关键字替换以前须要先获取到分支的版本号填充到版本号模板文件中。这样在编译前就会将版本号和SVN的修订号一同生成。
咱们还须要提早判断当前SVN工做目录是否有修改，只有在工做目录有修改时，才须要更新版本号，工做目录没有修改时，则无需修改版本号。

当咱们安装了SVN客户端后(同时须要选择安装命令行工具)，咱们能够经过SVN执行执行命令，经过SVN help查看支持的全部参数。

SVN客户端安装时须要勾选命令行工具，以下截图
20190701100831.png

获取版本号

咱们须要获取url的版本号。而版本号只有在分支目录上才有，所以咱们能够经过正则解析如下url，提取版本号。若提取不到则无需执行后续逻辑

经过svn info获取当前目录的svn信息，经过svn info 路径获取指定路径的svn信息。

F:\工做\SVN\Platform\trunk\FGMain>svn info
Path: .
Working Copy Root Path: F:\工做\SVN\Platform\trunk\FGMain
URL: http://inner.svn.com:81/ATS_Code/Platform/branches/FGMain/1.32.0
Relative URL: ^/Platform/branches/FGMain/1.32.0
Repository Root: http://inner.svn.com:81/ATS_Code
Repository UUID: 2fd9d0ce-2897-f849-b9e2-af1303b08de7
Revision: 99512
Node Kind: directory
Schedule: normal
Last Changed Author: wish
Last Changed Rev: 99512
Last Changed Date: 2019-06-14 17:54:47 +0800 (周五, 14 6月 2019)

命令会返回多行信息，我使用的时SVN 1.11 版本的客户端,其余版本可能会有不一样。咱们解析第二行的URL从而解析出URL的版本号。

$svnInfo = svn info $projectDir
$urlInfo = $svnInfo[2]
$url = $urlInfo.Replace("URL: ","");
$urlMatchStr= 'branches/(.*?)/(.*?)/(.*?)'
if($url -notmatch $urlMatchStr)
{
    # 主线再也不处理
    Write-Host "$url not match $urlMatchStr"
    return 
}

这里须要注意因为咱们当前目录不必定就是解决方案目录，在VS中咱们实在解决方案调用的编译工做，可是在jenkins咱们的目录可能会是bin/release或bin/debug，所以匹配URL时须要用非贪婪匹配。这样不管路径为branches/FGMain/1.32.0/FGBussness仍是branches/FGMain/1.32.0/FGMain/bin/Debug 第二项均可以匹配到版本号。
如今同$matches[2]便可获取到咱们获取到的版本号。

获取当前工做副本状态

当获取到版本号时，代表当前实在分支目录，则须要判断工做副本是否有修改。有修改则须要更新版本号。经过svn status 查看路径的svn状态,经过svn status 路径能够查看指定路径的SVN状态。

PS F:\工做\SVN\Platform\trunk\FGMain> svn status FGBussness
    ?       FGBussness\FGClientBussness.csproj.user
    M       FGBussness\MainWorkServer.cs
    ?       FGBussness\app.config
    ?       FGBussness\bin

命令返回了一个集合，每一行是一个文件或文件夹的SVN状态。SVN共包含如下状态

  • " ": 无修改
  • "A": 新增
  • "C": 冲突
  • "D": 删除
  • "G": 合并
  • "I": 忽略
  • "M": 改变
  • "R": 替换
  • "X": 未归入版本控制，但被外部定义所用
  • "?": 未归入版本控制
  • "!": 该项目已遗失 (被非 svn 命令所删除) 或是不完整
  • "~": 版本控制下的项目与其它类型的项目重名
  • "L": 锁定
  • "S": 已切换
  • "K": 存在锁定标记

能够看到" "、"X"、"?"能够认为是本地无修改。其余状态都有修改，须要更新版本号。当有冲突时，编译也会出错，同时编辑完冲突有可能就没有修改了，所以状态为"C"时也认为时无修改。

$svnStatuses = svn status $projectDir
#遍历每一个文件状态
foreach($svnStatus in $svnStatuses)
{
    $status = $svnStatus.SubString(0,1)
    if(($status -ne " ") -and ($status -ne "X") -and ($status -ne "?") -and ($status -ne "C"))
    {
        #存在编辑
        Write-Host $svnStatus.SubString(1).Trim()"Modified"
        $modified = $true
        break
    }
}

经过$modified记录当前工做副本的是否修改。同时只要一个文件修改了就无需判断其余文件。

更新版本号模板

接下来咱们读取版本号模板文件，首先咱们须要确认一下VS保存的文件编码，咱们按照VS的编码读取并保存文件。
在文件-高级保存选项中能够看到设置的文本编码

20190629200536.png

$versionContent = Get-Content $versionFile -encoding UTF8

for($count = 0 ; $count -lt $versionContent.Length; $count++)
{
    if(($versionContent[$count] -match '\[assembly: AssemblyVersion\(\"(\d*
    \.\d*\.\d*)\"\)\]') -or
    ($versionContent[$count] -match '\[assembly: AssemblyFileVersion\(\"(\d*\.\d*\.\d*)\.\$WCREV\$\"\)\]'))
    {
        #版本号不一致则更新版本号
        if($matches[1] -ne $marjorVersion)
        {
            Write-Host "Change Version"$matches[1]"To $marjorVersion"
            $versionContent[$count] = $versionContent[$count] -replace $matches[1],$marjorVersion
        }
        continue
    }
}

\d*\.\d*\.\d*匹配3位版本号，如1.32.0

遍历文件的每一行进行匹配，若匹配上了则将匹配的版本号替换为新的版本号。
最后更新版本号模板文件
Set-Content $versionContent -Path $versionFile -encoding UTF8

同时因为咱们程序只能获取一个程序集看成整个程序的版本号，所以咱们每次编译的时候能够将启动项强制更新版本号。咱们能够添加一个$force 当设置为true的时候无论本地是否有修改都更新版本号。

完整的脚本以下：

param([string] $projectDir,[string]$versionFile, $force)

Write-Host "current path:"$projectDir

try
{
    # 指定路径
    $svnInfo = svn info $projectDir
    $urlInfo = $svnInfo[2]
    $url = $urlInfo.Replace("URL: ","");

    Write-Host "url:$url"

    $urlMatchStr= 'branches/(.*?)/(.*?)/(.*?)'
    if($url -notmatch $urlMatchStr)
    {
        # 主线再也不处理
        
        Write-Host "$url not match $urlMatchStr"
        return 
    }
    # 分支
    # PS F:\工做\SVN\Platform\trunk\FGMain> $matches
    # Name                           Value
    # ----                           -----
    # 3                              FGBussness
    # 2                              1.32.0
    # 1                              FGMain
    # 0                              branches/FGMain/1.32.0/FGBussness
    $marjorVersion = $matches[2]
    Write-Host "Current Working Copy Version:$marjorVersion"

    # 没有强制修改，则须要判断当前工做路径是否编辑过。
    $modified = $force 

    if($modified)
    {
        Write-Host "Force Modified"
    }
    else
    {
        #当路径含有中文时，参数传入会乱码。暂时获取当前路径状态
        $svnStatuses = svn status $projectDir
        #遍历每一个文件状态
        foreach($svnStatus in $svnStatuses)
        {
            $status = $svnStatus.SubString(0,1)
            if(($status -ne "X") -and ($status -ne "?"))
            {
                #存在编辑
                Write-Host $svnStatus.SubString(1).Trim()"Modified"
                $modified = $true
                break
            }
        }
    }
    # 若当前工做目录没有修改过的文件则无需修改版本号
    # 查找模板文件的路径
    if($modified)
    {
        Write-Host "Version File :$versionFile"
        $versionContent = Get-Content $versionFile -encoding UTF8

        for($count = 0 ; $count -lt $versionContent.Length; $count++)
        {
            if(($versionContent[$count] -match '\[assembly: AssemblyVersion\(\"(\d*\.\d*\.\d*)\"\)\]') -or
            ($versionContent[$count] -match '\[assembly: AssemblyFileVersion\(\"(\d*\.\d*\.\d*)\.\$WCREV\$\"\)\]'))
            {
                #版本号不一致则更新版本号
                if($matches[1] -ne $marjorVersion)
                {
                    Write-Host "Change Version"$matches[1]"To $marjorVersion"
                    $versionContent[$count] = $versionContent[$count] -replace $matches[1],$marjorVersion
                }
                continue
            }
        }
        # 编辑过则将模板的版本号替换掉
        # 在VS的菜单-文件-高级保存选项中默认的文件编码是使用UTF8 With BOM的格式
        Set-Content $versionContent -Path $versionFile -encoding UTF8
    }
    else
    {
        Write-Host "No Modified"
    }
}
catch
{
    $Error
}

设置编译前读取版本号

脚本编写好，咱们将脚本放到项目根目录下，这样全部的程序集都能经过解决文件夹获取到该脚本。

powershell -ExecutionPolicy Bypass -NoProfile -NonInteractive -File $(SolutionDir)Update-Version.ps1 $(ProjectDir) $(ProjectDir)Properties\AssemblyInfo.template.cs

在Pre-build event command line 添加以上命令调用更新版本号的脚本。

  • -ExecutionPolicy Bypass表示容许该脚本执行，不然可能没有权限执行本地脚本文件。
  • -NoProfile 表示不加载powershell的配置文件。默认会加powershell全部的配置文件。
  • -NonInteractive 表示不向用户显示交互式提示。

如今完整的Pre-build命令以下

powershell -ExecutionPolicy Bypass -NoProfile -NonInteractive -File $(SolutionDir)Update-Version.ps1 $(ProjectDir) $(ProjectDir)Properties\AssemblyInfo.template.cs
SubWCRev $(SolutionDir) $(ProjectDir)Properties\AssemblyInfo.template.cs $(ProjectDir)Properties\AssemblyInfo.cs

若启动项默认须要强制更新版本号，则使用如下命令

powershell -ExecutionPolicy Bypass -NoProfile -NonInteractive -File $(SolutionDir)Update-Version.ps1 $(ProjectDir) $(ProjectDir) $true

若当前版本文件的版本号为1.31.0,在1.32.0的分支上进行编译，则会在输出窗口输出如下日志

1>------ Build started: Project: FGMain, Configuration: Debug Any CPU ------
1>  current path: F:\工做\SVN\Platform\trunk\FGMain\FGMain\
1>  url:http://124.160.27.118:81/ATS_Code/Platform/branches/FGMain/1.32.0/FGMain
1>  Current Working Copy Version:1.32.0
1>  Force Modified
1>  Version File :F:\工做\SVN\Platform\trunk\FGMain\FGMain\Properties\AssemblyInfo.template.cs
1>  Change Version 1.31.0 To 1.32.0
1>  Change Version 1.31.0 To 1.32.0
...

总结

在脚本编写的时候遇到了如下错误

  1. 咱们能够在传入参数设置$force为bool类型，可是在外部调用powershell脚本传参传入bool类型会报如下错误
    没法处理对参数“force”的参数转换。没法将值“System.String”转换为类型“System.Boolean”。布尔参数仅接受布尔值和数字，例如 $True、$False、1 或 0。
    可是经过提示的传入值仍然会报错，所以咱们只能将[bool]显示的类型去掉,避免强制转换时出现错误。

  2. 外部传入路径含有中文会致使powershell因为乱码处理不了

参考文献

  1. 给PowerShell脚本传递一个布尔值
  2. Using PowerShell in post/pre build action in Visual Studio
  3. How to pass boolean values to a PowerShell script from a command prompt
  4. Always Use -NoProfile To Launch Scripts

本文地址：http://www.javashuo.com/article/p-bxznawmj-ky.html 做者博客：杰哥很忙 欢迎转载，请在明显位置给出出处及连接

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程