Agent Actions

在 Coordinator Manager 的 Agent List 里，可以修改设置，如 Build Group 和日志级别。要修改单个 Agent，请使用三点式菜单，或右键单击任一 Agent。

  • Enabled as Helper 暂时阻止该 Agent 的构建协助工作，请取消勾选。

  • Allow to Enable/Disable as Helper 允许该 Agent 禁用自己为 Helper，暂时不协助构建的工作。

  • License Configuration: 可以手动将许可证分配给 Agent。默认情况下，新的 Agent 若为可用状态，会收到一个 helper 可证。

  • 启用 Build Cache：您可以在启动代理服务上启用 Build Cache，并定义代理是使用本地缓存、共享缓存还是两者皆有。

  • Build Cache 配置：您可以修改 Build Cache 端点的大小和位置。这些也可以在 Agent 本身的 Agent Settings 中修改。

  • Unsubscribe Agent：从一个代理中删除所有许可证。

  • Agent 描述：可用于识别 Agents 的自由文本。

  • Assignment Priority： Coordinator 在分配任务时给予该 Helper Agent 的优先权。具有较高分配优先权的 Agent 将比具有较低优先权的 Agent 更容易被分配任务。最高优先级为 1，最低为 5。

  • Build Priority：分配至由此 Agent 启动的构建优先级。如果没有足够的 Helper 供所有构建使用，构建优先级将决定哪些构建程序可以获得 Helper。最高优先级（1）将始终在较低优先级的构建之前获得全部的 Helper。优先级为2-4的构建如果 Helper 不足，则会进行分配。最低优先级（5）只有在所有其他构建的 Helper 完全分配后才会获得 Helper。

  • Build Group：您可以将 Agent 分配到现有的 Build Group 中，该 Build Group 将构建分布限制在指定的 Agent 集合中。详情请见 Build Groups。

  • Log Level： 日志中包含了多少细节。除非 Incredibuild 支持团队另有要求，该值应设置为最小值，因为详细设置会导致文件非常大。

  • Resize Helper Cache：helper 缓存让 Helper Agent 重新使用以前构建的数据。

  • Advanced Configuration：这些选项允许你在一个或多个 agent 上远程改变各种设置。有关详细内容，请见下文。

  • Update Version：  升级 Coordinator 后，每个 Agent 应自动升级到相同的版本。如果由于任何原因，这种情况没有发生，你可以使用这个选项来远程手动升级一个 Agent。

  • 设置描述：添加 Agent 的自由文本描述以供识别。

  • Clean Helper Cache：  清理 Helper 缓存。

修改多个 Agent（批量操作）。

你可以将任何行动应用于多个 agent。先过滤 agent 名单，可以加快批量操作的执行速度，如根据 agent 状态分配许可证或 Build Group。

将鼠标悬停在列表中的某一 Agent 上，查看左边的复选框。勾选相关 Agents，然后点击 Actions 按钮或右击。你所做的任何改变都将应用于所有选定的 Agent。

提示： 你可以使用标题栏中复选框旁边的下拉菜单来选择特定类型的所有 Agent。

高级代理配置

这些选项允许你在一个或多个 Agent 上远程改变各种设置。

  • 允许并行链接：允许并行运行多个链接步骤。

  • Avoid local：在可能的情况下将任务分发给 Helper，即可避免在本地运行任务。

  • Build Monitor Output Font：将在 Build Monitor 的输出显示中使用的字体。

  • Coordinator Port： 改变连接到 agent 所关联的 Coordinator 所需的端口。

  • Coordinator Server：改变 agent 与之相关的 Coordinator。

  • Enable MsBuild： 定义 Visual Studio 构建是否会运行 MSBuild.exe（已启用）或 devenv.exe（已禁用）。

  • Force CPU Count for Initiator：  运行构建时将使用的 initiator 上的最大 CPU 核心数。这需要重新启动 Incredibuild 的 agent 服务器。

  • Force English Build Monitor:必须将 VS Build Monitor 输出设为英语。

  • Helper Activity Report Timeout： 如果在这个超时时间段后未能与 initiator 通信，则禁用 helper。默认情况下，超时时间为 40 秒。

  • Max concurrent PDB file instances：可以并发构建的文件（属于同一项目）的最大数量。0 表示没有限制。

  • Max file sync threads：用于 Initiator 和 Helper 之间单个文件传输的最大线程数。

  • Max parallel links：可以并行运行的最大链接步数。需要启用 Allow parallel linking。

  • Maximum Log Size： 定义了日志文件的最大大小 (MB)。默认情况下，没有任何限制。这只会影响往往是最大的日志，如 Build Cache 和 Test Console。

  • Only Fail on Local： 启用后，远程失败的任务将在本地机器上再次重试。

  • Predictive Execution：启用预测执行程序。

  • Use 64 Bit Toolset： 使用 Visual Studio 的本地 64 位工具集运行 Visual Studio 构建，而不是默认的 32 位工具集。