合成构建配置

示例

创建一个示例项目

从以下的 GitHub 仓库（或其分支）创建一个项目： TeamCity DotNet Samples。导入项目时，选择不要导入设置，从头创建项目选项。
将构建配置名称设置为 "Build All"。
在 TeamCity 扫描存储库后，不要选择其建议的任何步骤。我们将在不同的配置中执行实际的构建任务，而这个初始创建的配置稍后将被用来一次性触发所有的任务。
打开项目设置。
单击创建子项目。这个子项目应该定位到与第1步中相同的 GitHub 仓库。
由于您的子项目使用的是与根项目相同的存储库，TeamCity 建议两个项目共享同一 VCS root ，而不是创建一个副本。在提示同意时，单击使用此项。
在您的新 “构建配置” 子项目中，创建五个构建配置。所有配置都应指向步骤1中的相同仓库，并使用共享的 VCS 根（参见步骤5）。
- 运行测试（Linux） — 一个配置，包含一个 .NET 运行器，用于在 .NET SDK 容器中测试 Linux 上的 "Clock.Tests" C# 项目。
- 运行测试（Windows） — 一个配置，包含一个 .NET 运行器，用于在安装了所需 .NET SDK 的 Windows 代理上测试 "Clock.Tests" C# 项目。
- 构建桌面 (Windows) — 一个配置，包含一个 .NET 运行器，用于对 "Clock.Desktop" 和 "Clock.Desktop.Uwp" 项目执行 "msbuild" 命令。
- 构建控制台 & 网页（win-x64）——一个包含两个 .NET 步骤的配置。
  - 一步执行 "Clock.Console" 项目上的 "publish" 命令，并使用 "win-x64" 运行时选项。此步骤的输出目录被设置为 "bin/Clock.Console/win-x64"。
  - 另一步执行 "Clock.Web" 项目上的 "publish" 命令。此步骤的运行时选项为 "win-x64"，输出目录为 "bin/Clock.Web/win-x64"。
- 构建控制台 & 网页（linux-x64） — 与之前的配置相同，但 .NET 步骤的运行时和输出目录设置分别为 "linux-x64" 和 "bin/<ProjectName>/linux-x64"。
由于这些构建配置将成为单一构建链的一部分，因此无需自动添加构建触发器，以便在 TeamCity 检测到远程仓库中的变更时独立启动所有五个构建配置。转到构建配置设置 | 触发器，禁用或删除所有配置的触发器（最顶层项目拥有的 "Build All" 配置除外）。
两种 "Build console & web" 配置都应该发布他们的 "bin" 文件夹。为了做到这一点，需要在这些配置中指定 bin => bin artifact paths。发布的构件将稍后由 deployment configurations 使用。

project {
    buildType(Building_1)
    subProject(Building)
}

object Building_1 : BuildType({
    id("Building")
    name = "Build All"

    vcs {
        root(DslContext.settingsRoot)
        showDependenciesChanges = true
    }

    triggers {
        vcs {
        }
    }

})


object Building : Project({
    name = "Building Configurations"
    buildType(Building_BuildConsoleWebLinuxX64)
    buildType(Building_BuildConsoleWebWinX64)
    buildType(Building_BuildDesktopWindows)
    buildType(Building_RunTestsLinux)
    buildType(Building_RunTestsWindows)
})

object Building_RunTestsLinux : BuildType({
    name = "Run Tests (Linux)"

    vcs {
        root(DslContext.settingsRoot)
    }

    steps {
        dotnetTest {
            name = "Tests (Linux)"
            projects = "Clock.Tests/Clock.Tests.csproj"
            dockerImage = "mcr.microsoft.com/dotnet/sdk:7.0"
            dockerImagePlatform = DotnetTestStep.ImagePlatform.Linux
        }
    }

    triggers {
        vcs {
            enabled = false
        }
    }

    requirements {
        matches("teamcity.agent.jvm.os.family", "Linux")
    }
})

object Building_RunTestsWindows : BuildType({
    name = "Run Tests (Windows)"

    vcs {
        root(DslContext.settingsRoot)
    }

    steps {
        dotnetTest {
            name = "Test (Win)"
            projects = "Clock.Tests/Clock.Tests.csproj"
            sdk = "7"
        }
    }

    triggers {
        vcs {
            enabled = false
        }
    }

    requirements {
        matches("teamcity.agent.jvm.os.family", "Windows")
    }
})

object Building_BuildDesktopWindows : BuildType({
    name = "Build Desktop (Windows)"

    artifactRules = """
        bin/Clock.Desktop/win/**/*.* => bin/Clock.Desktop.zip
        bin/Clock.Desktop.Uwp/win/**/*.* => bin/Clock.Desktop.Uwp.zip
    """.trimIndent()

    params {
        param("system.PublishDir", "../bin/Clock.Desktop/win/")
        param("system.AppxPackageDir", "../bin/Clock.Desktop.Uwp/win/")
    }

    vcs {
        root(DslContext.settingsRoot)
    }

    steps {
        dotnetMsBuild {
            name = "Build Desktop (Win)"
            projects = """
                Clock.Desktop/Clock.Desktop.csproj
                Clock.Desktop.Uwp/Clock.Desktop.Uwp.csproj
            """.trimIndent()
            version = DotnetMsBuildStep.MSBuildVersion.V17
            targets = "Restore;Rebuild;Publish"
            sdk = "7"
        }
    }

    triggers {
        vcs {
            enabled = false
        }
    }

    requirements {
        matches("teamcity.agent.jvm.os.family", "Windows")
    }
})

note
系统属性在此构建配置中指定了“Publish”任务应将输出放置的目录。了解详情:
dotnet publish
为您的 UWP 应用设置自动构建

object Building_BuildConsoleWebWinX64 : BuildType({
    name = "Build console & web (win-x64)"
    artifactRules = "bin => bin"

    vcs {
        root(DslContext.settingsRoot)
    }

    steps {
        dotnetPublish {
            name = "Build Console (win-x64)"
            projects = "Clock.Console/Clock.Console.csproj"
            runtime = "win-x64"
            outputDir = "bin/Clock.Console/win-x64"
        }
        dotnetPublish {
            name = "Build web"
            projects = "Clock.Web/Clock.Web.csproj"
            runtime = "win-x64"
            outputDir = "bin/Clock.Web/win-x64"
        }
    }

    triggers {
        vcs {
            enabled = false
        }
    }

    requirements {
        exists("DotNetCoreSDK7.0_Path")
        exists("DotNetCoreRuntime7.0_Path")
    }
})

object Building_BuildConsoleWebLinuxX64 : BuildType({
    name = "Build console & web (linux-x64)"
    artifactRules = "bin => bin"

    vcs {
        root(DslContext.settingsRoot)
    }

    steps {
        dotnetPublish {
            name = "Build console"
            projects = "Clock.Console/Clock.Console.csproj"
            runtime = "linux-x64"
            outputDir = "bin/Clock.Console/linux-x64"
            args = "/p:PublishTrimmed=true /p:PublishSingleFile=true"
        }
        dotnetPublish {
            name = "Build web"
            projects = "Clock.Web/Clock.Web.csproj"
            runtime = "linux-x64"
            outputDir = "bin/Clock.Web/linux-x64"
        }
    }

    triggers {
        vcs {
            enabled = false
        }
    }

    requirements {
        exists("DotNetCoreSDK7.0_Path")
        exists("DotNetCoreRuntime7.0_Path")
    }
})

设置构建链

object Building_1 : BuildType({
    id("Building")
    name = "Build All"
    artifactRules = "bin/**/*.* => ."

    // ...

    dependencies {
        dependency(Building_BuildConsoleWebLinuxX64) {
            snapshot {
            }

            artifacts {
                artifactRules = "**/*.* => ."
            }
        }
        dependency(Building_BuildConsoleWebWinX64) {
            snapshot {
            }

            artifacts {
                artifactRules = "**/*.* => ."
            }
        }
        dependency(Building_BuildDesktopWindows) {
            snapshot {
            }

            artifacts {
                artifactRules = "**/*.* => ."
            }
        }
    }
})

object Building_BuildDesktopWindows : BuildType({
    name = "Build Desktop (Windows)"
    artifactRules = """
        bin/Clock.Desktop/win/**/*.* => bin/Clock.Desktop.zip
        bin/Clock.Desktop.Uwp/win/**/*.* => bin/Clock.Desktop.Uwp.zip
    """.trimIndent()

    // ...

    dependencies {
        snapshot(Building_RunTestsWindows) {
        }
    }
})

object Building_BuildConsoleWebWinX64 : BuildType({
    name = "Build console & web (win-x64)"
    artifactRules = "bin => bin"

    // ...

    dependencies {
        snapshot(Building_RunTestsWindows) {
        }
    }
})

object Building_BuildConsoleWebLinuxX64 : BuildType({
    name = "Build console & web (linux-x64)"
    artifactRules = "bin => bin"

    // ...

    dependencies {
        snapshot(Building_RunTestsLinux) {
        }
    }
})