TeamCity On-Premises 2024.03 Help

运行自定义构建

构建配置通常使用 构建触发器 根据所需的时间表启动新的构建,或者当 TeamCity 检测到源代码中有新的更改时。

除了这些自动触发的构建外,TeamCity 还允许您手动运行构建,如果需要,还可以自定义它们的设置:添加新的或修改现有的属性,选择特定的更改,安排构建,选择哪个代理应该运行它,等等。

TeamCity 提供了多种运行自定义构建的选项:

  • 点击 Run 按钮旁边的省略号按钮,并在 Run Custom Build 对话框中指定可选设置(有关更多信息,请参阅 本节)。

  • 要运行带有特定更改的自定义构建,请打开构建结果页面并切换到 Changes 选项卡。 将所需的更改展开,点击带有此更改的运行构建按钮,并指定必填的选项

  • 向 TeamCity 服务器发送一个 HTTPREST API 请求。

  • 推广构建

  • 设置 构建触发器 以启动具有自定义参数的构建。

一般选项

General 标签页显示了最基础且常用的设置。

运行自定义构建对话框,通用设置选项卡

代理

此设置允许您选择应运行您的构建的代理。 以下选项可用:

  • <最快的空闲代理>(默认选项)- 如果选择,TeamCity 将自动选择一个代理来运行构建。

  • 从列表中选择特定的 TeamCity 代理。 TeamCity 显示指定代理的当前状态,如果它已经在运行构建,会估计它何时会变为空闲。

  • <在 N 池中最快的空闲代理> — TeamCity 将在指定池的代理上运行构建。

  • 如果配置了 云集成,您可以在由 特定云镜像 生成的代理上运行构建。 如果没有这种类型的云代理可用,TeamCity 将尝试启动一个新的。

  • <启用的所有兼容代理> — 在所有启用且与构建配置兼容的代理上同时运行构建。 使用此选项来:

    • 为了进行代理维护,运行构建(例如,您可以创建配置以检查在环境升级/更新后代理是否正常运作)。

    • 在不同的平台上运行构建(例如,您可以设置一个配置,并指定安装了不同环境的多个兼容构建代理。

日期 & 时间

请保留尽快选项,以便在您点击运行构建后立即将新构建放入常规队列。

要将构建安排到特定的日期和时间,请切换到 特定日期和时间 选项。 计划构建会在构建队列的最末端,直到到达它们预定的日期和时间。

计划构建和时间

构建选项

  • 以个人构建方式运行 — 这允许您运行 个人构建

  • 将构建置于队列顶部 — 将这个新的构建置于当前 构建队列 的顶部。 由于您新启动的构建可能没有立即可用的兼容代理,因此在等待代理时,它可能会在队列中向下移动。 如果出现这种情况,请在构建配置页面点击 移至顶部 图标,或者导航至 构建结果页面 页面并点击 操作 | 移至顶部

    将排队的构建移至顶部
  • 在构建之前删除检出目录中的所有文件 — 指定 TeamCity 是否应清除 构建检出目录

    • 如果配置了快照依赖,此选项可以应用于快照依赖。 在这种情况下,构建链中的所有构建都将使用干净的检出。

Perforce 特定设置

如果当前的构建配置使用的是 Perforce 版本控制系统根目录,您也可以在 搁置的文件 上运行自定义构建。 要做到这一点:

  1. 勾选 作为个人构建运行 选项。

  2. 输入包含暂存文件的变更列表的 ID。

  3. 选择目标 Perforce 根目录。

依赖

此选项卡仅适用于依赖于其他构建的构建

Dependencies 标签页允许您重新构建所有依赖项,并选择一个特定的构建,这个新的构建应该使用这个特定构建的构件。 默认情况下,TeamCity 显示最后的 20 个构建。 为了增加可用的最近构建次数,请添加 teamcity.runCustomBuild.buildsLimit=<您的值> 内部属性

如果您重新运行一个依赖构建,TeamCity 将尝试重建所有依赖构建,包括之前失败的构建。

依赖项构建在列表中最初按照其按字母顺序排列的分支进行分组。 同一分支的构建按构建日期排序。 要舍弃基于分支的排序,并仅按照它们的日期对所有依赖性构建进行排序,请点击 按日期对依赖性进行排序。 这使您能够首先查看最近的构建。 要恢复默认排序,点击 重置所有

更改

此选项卡仅在您的 TeamCity 用户具有访问构建配置的 VCS 根的权限时可用。

Changes选项卡允许您选择一个更改以包含在构建中。 TeamCity 将使用更改的修订版来检出源, 并在这个新的构建中包含所有的更改,直到选择的那一个。

请注意,如果相应的 VCS 根被从构建配置中分离,TeamCity 将无法获取最新的提交,并且只显示有限数量的更改。 要用较旧的更改运行构建,请在更改日志中找到所需的提交,并使用 使用此更改运行构建 操作。

包含更改

Include changes 下拉菜单允许您选择哪些在与配置关联的 VCS 根中的更改应包含在此新建筑中。

  • 构建开始时的最新更改:TeamCity 将自动包含当前可用的所有最新更改。

  • 最后一次包含的更改:选择所需的更改以忽略所有后续提交。 TeamCity 将忽略最新更改的构建标记为 历史构建

构建分支

如果此构建配置(或其快照依赖配置)具有分支,则可使用 构建分支 下拉菜单。 允许您为自定义构建选择一个分支。

使用 Settings

如果一个项目在版本控制系统中存储其设置,此标签页允许您选择哪些设置应用于这个新的构建:

  • 当前在 TeamCity 服务器上定义的设置

  • 从为此构建计算的 VCS 修订版加载的设置。

默认行为取决于当前选择的项目设置 | 版本设置页面设置(有关更多信息,请参考此部分:定义应用于构建的设置)。

如果您选择了 specific changes revision,TeamCity 也会载入项目设置的相应版本。

参数

此选项卡允许您添加、编辑和删除参数 / 属性 / 变量,并可覆盖 预定义参数 的初始值。

以下限制适用:

  • 预定义的属性和变量不允许您编辑其名称(只能编辑值)。

  • 您只能删除新添加的属性和变量。 预定义属性不能被删除。

  • 参数值不能超过16,000个字符。

评论和标签

这个标签页允许您为您的自定义构建添加可选的评论和 标签。 您也可以在此部分勾选相应选项,将自定义构建添加到 收藏夹中。

推广构建

推广版本是自定义构建,其已重写了 artifact 或 snapshot 依赖。 此类构建使用的依赖构建与其默认使用的构建不同。

例如,构建配置 A 从构建配置 B 中检索工件。 通常,运行新的 A 构建会使用最后一次成功的 B 构建。 如果您希望 A 使用旧版的 B 构建,那么这个较早的 B 构建需要被提升。

为了推广构建,请打开依赖构建的构建结果页面,并点击 操作 | 推广。 促销只有一次性效果:在当前运行后,构建配置将恢复到其默认依赖逻辑(最后成功或最后固定的构建)。

请查看 以下博客文章 以获取更多信息。

最后修改日期: 16日 7月 2024年