全面掌握Directory.Build.props
为什么需要集中管理版本号?
1)同一个产品包含多个模块,对同一个包指定了不同的版本
比如A模块用了"Serilog.Sinks.Async"的“1.1.2”版本,
B模块用了“Serilog.Sinks.Async”的“1.5.0”版本,
最终集成在C项目里,就会有版本不一致的问题。大多数情况下,这个无所谓。
2)团队在使用自动集成,但是没有集中管理版本号。
如果最终的C项目,是用于部署应用程序的。这个项目的代码,很少需要改动,只是用于发布而已。
当上游的项目,重新编译并推送了新的包到NuGet仓库。
而C项目并没有在Visual Studio打开,更新整个解决方案的NuGet包。
那么Gitlab里,这个C项目的包的定义就还是旧的。
C项目在docker build、docker push和docker run之后,就还可能在使用项目A和项目B的旧的包。
Directory.Build.props的特点
这是dotnet内置的技术,原理很简单。就是dotnet restore的时候,从当前目录下开始寻找Directory.Build.props。
当前目录没有,就去上级目录里找。
直到找到一个Directory.Build.props,就不再向上寻找了。
也就是说,Directory.Build.props和NuGet.Config的机制不一样。
那么 Directory.Build.props有两个特点:
1、Directory.Build.props的定义是不能继承,也不能映像子目录的。
2、和*.csproj文件一样,可以Import其它的文件
如何共享Directory.Build.props及其Import的文件呢?
1、设立分发文件的http网站
用宝塔设立分发Directory.Build.props及其Import文件的网站
2、Windows开发环境的共享
Windows开发环境如何启用Directory.Build.props版本号集中管理
3、在Gitlab Runner里,dotnet build的时候,获取文件
Gitlab中的打包作业完成后,更新http服务器里的版本号文件
这篇文章里,就是这一句话在起作用:
build-job: # This job runs in the build stage, which runs first.
stage: build
before_script:
- bash $DOWNLOAD_ALL_DIRECTORY_BUILD_PROPS_FILES $DIRECTORY_BUILD_DIST_SERVER_DIRECTORYNAME
$DOWNLOAD_ALL_DIRECTORY_BUILD_PROPS_FILES 这个脚本哪里找?在这篇文章里:
制作docker方式执行Gitlab Runner所需要的镜像
4、在Gitlab Runner里,dotnet pack成功之后,把最新版本号写入分发文件的网站
Gitlab中的打包作业完成后,更新http服务器里的版本号文件
这篇文章里,调用这一段脚本,就可以了:
更新版本号: # This job runs in the test stage.
stage: update-version # It only starts when the job in the build stage completes successfully.
script:
- echo "SSH到http服务器,更新文件里的版本号……"
- bash $DIRECTORY_BUILD_UPDATE_VERSION_SH $DIRECTORY_BUILD_DIST_SERVER_USER $DIRECTORY_BUILD_DIST_SERVER $DIRECTORY_BUILD_DIST_SERVER_DIRECTORYNAME "Directory.Build.Change.EasyComment.props" $EASY_COMMENT_VERSION_ID
$DIRECTORY_BUILD_UPDATE_VERSION_SH 这个脚本哪里找?在这篇文章里:
制作docker方式执行Gitlab Runner所需要的镜像
5、在Gitlab Runner里,docker build的时候,获取最新文件
用Docker发布网站时,自动下载Directory.Build.props及其Import的文件
在Visual Studio生成的Dockerfile里,把
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
修改成这样即可:
FROM docker.amicap.cn/amihome/dotnet/sdk8:2024 AS build
WORKDIR /
# 因为要运行下边这个shell,所以build镜像不能用默认的mcr.microsoft.com/dotnet/sdk:8.0
# 我们自己的镜像是包含下边这个shell的
RUN /home/public/download-directory-builds-props.sh dev.amihome.cn
这里用到的docker.amicap.cn/amihome/dotnet/sdk8:2024,根据这篇文章来制作:
适配http分发Directory.Build.props文件,需要替换默认的微软sdk:8.0映像