如何使用 Cake 构建 .NET 微服务的自动化脚本?

来源:这里教程网 时间:2026-02-21 17:27:01 作者:

使用 Cake(C# Make)可以高效地为 .NET 微服务项目编写跨平台的自动化构建脚本。它采用 C# 语法,便于 .NET 开发者维护。以下是实现自动化构建的基本步骤和示例。

配置 Cake 环境

在项目根目录下创建 build.cake 文件,并准备运行环境:

安装 .NET SDK(建议 6.0 或以上) 通过 .NET 全局工具安装 Cake: dotnet tool install -g Cake.Tool 或使用本地工具清单(推荐): dotnet new tool-manifestdotnet tool install Cake.Tool

编写基础构建脚本

build.cake 中定义常用任务,例如还原、构建、测试和发布微服务:

var target = Argument("target", "Build");
var configuration = Argument("configuration", "Release");
var projects = GetFiles("./src/**/*.csproj");

Task("Restore")
    .Does(() =>
    {
        foreach(var project in projects)
        {
            DotNetRestore(project.ToString());
        }
    });

Task("Build")
    .IsDependentOn("Restore")
    .Does(() =>
    {
        var settings = new DotNetBuildSettings
        {
            Configuration = configuration,
            NoRestore = true
        };

        foreach(var project in projects)
        {
            DotNetBuild(project.ToString(), settings);
        }
    });

Task("Test")
    .IsDependentOn("Build")
    .Does(() =>
    {
        var testProjects = GetFiles("./test/*/.csproj");
        foreach(var project in testProjects)
        {
            DotNetTest(project.ToString(), new DotNetTestSettings
            {
                Configuration = configuration,
                NoBuild = true,
                Logger = "trx"
            });
        }
    });

Task("Publish")
    .IsDependentOn("Build")
    .Does(() =>
    {
        var outputDir = "./artifacts";
        EnsureDirectoryExists(outputDir);

        foreach(var project in projects)
        {
            DotNetPublish(project.ToString(), new DotNetPublishSettings
            {
                Configuration = configuration,
                OutputDirectory = System.IO.Path.Combine(outputDir, project.GetFilenameWithoutExtension()),
                SelfContained = false,
                Runtime = "linux-x64"
            });
        }
    });

RunTarget(target);

集成 Docker 镜像构建

若微服务需打包为容器,可在 Cake 脚本中调用 Docker CLI:

Task("DockerBuild")
    .IsDependentOn("Publish")
    .Does(() =>
    {
        var projectName = "MyMicroservice.Api";
        var dockerfile = $"./src/{projectName}/Dockerfile";
        var tag = "my-microservice:latest";

        DockerBuild(new DockerImageBuildSettings
        {
            File = dockerfile,
            Tag = new[] { tag }
        }, ".");
    });

确保系统已安装 Docker 并在 PATH 中可用。

执行构建脚本

运行指定目标任务:

dotnet cake build.cake --target=Build
dotnet cake build.cake --target=Test
dotnet cake build.cake --target=DockerBuild

也可将常用命令写入 PowerShell 或 Bash 脚本(如 build.ps1build.sh)简化调用。

基本上就这些。Cake 提供了灵活且类型安全的方式管理 .NET 微服务的 CI/CD 流程,适合集成到 GitHub Actions、Azure Pipelines 等系统中。

相关推荐