使用构建参数

这个主题展示了在 TeamCity UI 中可能选择引用参数而不是指定明确值的简单用例。请参阅主要使用场景部分，以了解参数使用场景的概述。

储存 Docker Registry 名称

如果您有各种配置要使用同一镜像仓库，您可以为 <Root> 项目创建一个自定义参数来存储这个镜像仓库的名称。因此，您可以在任何拉取或推送您的镜像的 Docker step 中引用此参数。

指定 JDK 版本

以下 Gradle 步骤总是使用 JDK 19，而不是通过 JDK_HOME 环境变量引用的默认版本。运行器从相应的 env. 参数中检索此所需JDK的路径。

steps {
    gradle {
        name = "Gradle step"
        tasks = "build-dist"
        jdkHome = "%\env.JDK_19_0_ARM64%"
    }
}

  

设置额外的 .NET 参数

在以下示例中， .NET 运行器的命令行形参字段的值是通过引用 dotnet.output.type 参数来指定的。

object MyBuildConfig : BuildType({
    params {
        param("dotnet.output.type", "WinExe")
    }

    steps {
        dotnetBuild {
            args = "-p:OutputType=%\dotnet.output.type%"
        }
    }
})

  

指定构建工件路径

在构建配置设置 | 常规设置 | 构件路径页面上设置 artifact 路径时，您可以利用自定义配置参数来替代普通值。

object GoalInBuildScripts : BuildType({
    artifactRules = "testfile1.txt => %\default.artifact.path%"
    params {
        param("default.artifact.name", "/bin/artifacts/build_artifact.tar.gz")
    }
})

  

修改构建编号模式

构建配置设置 | 常规设置 | 构建号格式字段允许您自定义此配置的构建编号模式。

构建的默认基于零的整数索引存储在 build.counter 参数中。下面的示例将仓库分支的名称添加到构建编号中。

object MyBuildConf : BuildType({
    buildNumberPattern = "%\build.counter%-%\teamcity.build.branch%"
})

  

标签构建

版本控制系统标签构建功能允许构建配置对仓库源进行标记。

以下设置说明了如何使用 release.status 参数的值作为标签。另请参阅：参数显示模式。

object MyBuildConf : BuildType({
    params {
        param("release.status", "EAP")
    }
    features {
        vcsLabeling {
            vcsRootId = "${DslContext.settingsRoot.id}"
            labelingPattern = "%\release.status%"
        }
    }
})

  

指定签出规则

VCS 检出规则可以在构建配置设置 | 版本控制设置页面上进行配置。如果您的组织对分支名称有特定的约定，您可以将这些默认名称存储为参数，并按下面所示指定签出规则。

object GoalInBuildScripts : BuildType({
    params {
        param("branch.ignored", "refs/heads/sandbox")
        param("branch.default", "refs/heads/main")
    }

    vcs {
        root(YourVcsRootName, "+:%\branch.default%", "-:%\branch.ignored%")
    }
})

  

最后修改日期： 2025年 8月 12日