仲秀娟 发表于 2025-6-2 23:33:52

通过 Nuke 为 Dotnet Core 应用构建自动化流程

为什么使用Nuke

最开始了解Nuke,是浏览github时,刷到了这个项目,看简介可以通过C# 来定义构建任务和流程,这一点很新颖,对我来讲,c# 显然更容易理解和维护。
再看给出的示例,确实比较清晰,简洁。看了下官方文档,也提供了大量第三方CLI的支持,工具支持比较好,也就是可以使用C#方法调用,代替直接使用cli 命令。
还可以与 gitlab jenkins 结合,实现CI、CD,兼容windows 与 linux。
看文档介绍,是不错的,对于缺少运维人员的团队,可以尝试使用。

 
示例场景


[*]为同一个解决方案下的多个Dotnet Core 项目构建dokcer镜像
[*]使用Gitversion的版本策略,生成镜像标签
[*]并推送至镜像仓库
 逻辑比较简单,可以拆分为,通过 gitversion 生成版本号,通过docker build 生成镜像,以及通过docker push 推送镜像。
Nuke 初始化

按需安装Nuke 版本,以及在项目跟目录下,进行初始化。
dotnet tool install Nuke.GlobalTool --global<br>nuke :setup 
调整构建流程

通过 LoginDocker 实现了登录docker镜像仓库;
通过 BuildDockerImages 实现了多个项目的镜像构建,并采用 GitVersion 的 FullSemVer 作为版本号,构建时启用了DOCKER_BUILDKIT;
通过 PushImages 实现了镜像推送;
通过 CleanImages 清除本地镜像;
using System;
using System.Collections.Generic;
using System.Linq;

using Nuke.Common;
using Nuke.Common.ProjectModel;
using Nuke.Common.Tooling;
using Nuke.Common.Tools.Docker;
using Nuke.Common.Tools.GitVersion;

using Serilog;

using static Nuke.Common.IO.FileSystemTasks;
using static Nuke.Common.Tools.Docker.DockerTasks;

class Build : NukeBuild
{
    readonly GitVersion GitVersion;
    readonly Solution Solution;
    readonly string ProjectName;

    public Build()
    {
      DockerLogger = (s, e) => Log.Debug(e);
    }

    public static int Main() => Execute<Build>(x => x.RunDockerTasks);
    string RegistryUrl => "registry.mydomain.com";
    string ImagePrefix => $"{RegistryUrl}/products";

    IEnumerable<Project> Projects => Solution.AllProjects.Where(p => p.Name.EndWith("Host"));

    readonly List<string> localImages = new();

    Target LoginDocker => _ => _
      .Executes(() =>
      {
            DockerLogin(_ => _
                .SetServer(RegistryUrl)
                .SetUsername("xxx")
                .SetPassword("xxxxx"));
      });

    Target BuildDockerImages => _ => _
      .Executes(() =>
      {
            foreach (var project in Projects)
            {
                var tag = $"{ImagePrefix}{project.Name}:{GitVersion.FullSemVer}";
                localImages.Add(tag);
                DockerBuild(_ => _
                  .SetProcessEnvironmentVariable("DOCKER_BUILDKIT", "1")
                  .SetPath(“./”)
                  .SetFile(project.Directory / "Dockerfile")
                  .SetTag(tag));
            }
      });

    Target PushImages => _ => _
      .DependsOn(BuildDockerImages)
      .DependsOn(LoginDocker)
      .Executes(() =>
      {
            foreach (var image in localImages)
            {
                DockerPush(_ =>
                _.SetName(image));
            }
      });

    Target CleanImages => _ => _
      .DependsOn(PushImages)
      .Executes(() =>
      {
            foreach (var image in localImages)
            {
                DockerImageRm(s => s
                .SetImages(image)
                .SetForce(true));
            }
      });

    Target RunDockerTasks => _ => _
      .DependsOn(CleanImages)
      .Executes(() =>
      {
            Serilog.Log.Information($"{ProjectName} 构建结束");
      });
}调试

本地运行代码,既可以执行以上逻辑,以及调试;非常方便。
调用

通过 执行命令行:dotnet nuke RunDockerTasks 即可执行镜像的构建与推送,可以很方便的与gitlab、github、jenkins 等结合。

优化


[*]执行以上CI,需要宿主机,安装Dotnet SDK,以实现 Dotnet tools 的安装,以及Docker 客户端的安装;可以考虑使用Docker In Docker的方式,减少对服务器的要求;
[*]默认会对所有的项目进行构建并推送,可以结合 Parameter 的方式,按需指定需构建的项目;
[*]可以使用compose 方式构建,隐藏项目细节;
总结

对于功能不复杂、脚本不熟悉、或者缺少运维的场景下,可以尝试使用。

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

汪玉珂 发表于 2025-11-1 23:23:16

懂技术并乐意极积无私分享的人越来越少。珍惜

季卓然 发表于 2025-11-20 16:01:24

懂技术并乐意极积无私分享的人越来越少。珍惜

材部 发表于 2025-11-27 05:25:06

前排留名,哈哈哈

欧阳梓蓓 发表于 前天 11:29

热心回复!
页: [1]
查看完整版本: 通过 Nuke 为 Dotnet Core 应用构建自动化流程