管理生成系统

您已配置生成服务器，其中包括生成控制器和生成代理。 您已定义生成过程以满足团队的需求。 您的团队现在运行并管理您的自动生成，以编译和测试您的应用程序。

有时，您将遇到需要监视和管理您的生成系统的情况，例如，当您正在诊断问题或扩展生成系统时。

所需权限

您必须是生成服务器上 Windows 管理员组的成员，还必须是您团队项目集上项目集生成管理员组的成员。 请参见 Team Foundation Server 权限参考。

您希望做什么？

• 在 Visual Studio 中检查您的控制器和代理状态、对其进行管理和修改

• 在管理控制台中检查您的服务器、控制器和代理状态，对其进行管理和修改

• 启动、终止或重新启动生成服务器

• 重新启动生成控制器或生成代理

• 启用或禁用控制器或代理

• 指定控制器同时运行生成的最大数目

• 注册或注销生成服务器

• 监视您生成服务器的运行状况

• 使用事件日志诊断问题

• 采取后续步骤

在 Visual Studio 中检查您的控制器和代理状态、对其进行管理和修改

有时您想检查状态，管理生成控制器并生成代理，例如，当队列中的生成进程无法开始或继续时。 您可以直接从 Visual Studio 完成所有操作。

1. 在 Visual Studio 中，在团队资源管理器中：

   1. 如果尚未连接到团队项目集合中的团队项目，则请 连接到团队项目。

   2. 选择 “主页”，然后选择 “生成”。

2. 在“生成”页上，选择**“操作”，然后选择“管理生成控制器”**。

后续步骤

• 检查您的控制器和代理状态

  • 如果**“状态”为“可用”且“状态”是“已启用”**，则组件可能正在正常工作。

  • 如果**“状态”是“禁用”，则可以选中组件，选择“属性”**，然后重新启用组件。

  • 如果**“状态”为“脱机”**，则组件已断开连接。 登录到生成服务器，确定其已注册并能连接至 您的 Team Foundation Server。

• 查看、修改、启用或禁用控制器或代理
  选中该项并选择**“属性”**，然后可以看到 部署和配置生成控制器 或 部署和配置生成代理。

• 移除生成控制器或代理
  请参阅移除生成控制器或移除生成代理。

• 管理或解决生成服务器、控制器或代理的问题
  有关更多信息，请参阅以下部分。

在管理控制台中检查您的服务器、控制器和代理状态，对其进行管理和修改

要检查或管理生成系统组件，有时需要在登录到生成服务器时可用的附加功能。

1. 登录到要配置的生成服务器。

2. 从 Windows**“开始”菜单中运行“Team Foundation 管理控制台”**。

   此时将出现“Team Foundation 管理控制台”。

3. 在树窗格中，展开服务器的名称。

4. 选择**“生成配置”**节点。

后续步骤

• 检查您的控制器和代理状态

  • 如果任何生成控制器或生成代理正在处理生成，您可以从 Team Foundation 管理控制台实时查看正在进行的工作消息。

    

    有关监控运行的生成过程的更多信息，请参见 运行、监视和管理生成 和 诊断生成问题。

  • 如果 控制器或 代理是红色，则表示组件已断开连接。 确保您的生成服务器可以连接到您的 Team Foundation Server。

• 使用生成服务器

  

  • 选择“重新启动”、“停止”或“开始”，以便启动，停止或重新启动生成服务器。

  • 选择**“属性”**，以部署和配置生成服务器。

  • 选择**“注册”或“注销”**，以注册或注销生成服务器。

  • 选择“事件”… 以使用事件日志诊断问题。

  • 监视您生成服务器的运行状况。

• 使用生成控制器
  

  • 选择**“属性”**，然后参见部署和配置生成控制器。

  • 选择**“重新启动”**，以重新启动控制器。

  • 选择**“启用”或“禁用”**，以启用或禁用控制器。

• 使用生成代理
  

  • 选择**“属性”**，然后参见 部署和配置生成代理。

  • 选择**“重新启动”**，以重新启动代理。

  • 选择**“启用”或“禁用”**，以启用或禁用代理。

启动、终止或重新启动生成服务器

在对其进行维护时，最好停止生成服务器。 从 Team Foundation 管理控制台中选择**“停止”，使承载于生成服务器上的所有生成控制器和生成代理脱机。 当您准备将管理器和代理放回服务中时，请选择“开始”**。

如果生成服务器不能响应（例如，如果生成进程无法启动或取得实时进展），选择**“重新启动”**可能会有所帮助。重新启动生成服务器时，Team Foundation Build Service 进程关闭并重新启动，进入类似重新启动计算机的崭新状态。 如果此生成服务器上的生成控制器或任何生成代理当前正在处理生成，则取消这些生成。

重新启动生成控制器或生成代理

当重新启动生成服务器具有破坏性或者不必要时，可从 Team Foundation 管理控制台选择生成控制器或生成代理的**“重新启动”**链接。 重新启动生成控制器时，它将重新加载程序集，并将中止正在处理的所有生成。 重新启动生成代理时，它将放弃应用程序域，重新加载程序集，并将中止正在处理的生成。

启用或禁用控制器或代理

您可以通过禁用 控制器或 代理来阻止向它生成分配。 如果禁用正在处理生成的控制器或代理，则在组件被禁用之前可完成生成。

此功能可帮助您调整或临时修改生成系统的工作方式。 例如，由于生成处理速度太慢，您怀疑生成服务器运行了太多生成代理。 可以禁用某些生成代理，并评估禁用如何影响性能。 稍后，可以根据需要重新启用一个或多个生成代理。

若要启用或禁用生成代理或生成控制器：

• 从 “Visual Studio 管理生成控制器”对话框中选择您要禁用或启用的生成控制器或生成代理，然后选择**“属性”。 将显示“生成控制器属性”或“生成代理属性”对话框。 清除或选中“启用了生成控制器服务”或“启用了生成代理服务”**复选框。

• 在 Team Foundation 管理控制台 中，找到您要禁用或启用的生成控制器或生成代理，然后选择其**“启用”或“禁用”**链接。

注册或注销生成服务器

如果您想使生成服务器退出生成系统，则应从 Team Foundation 管理控制台中选择**“注销”。 当选择“注销”**时，系统会询问您是否删除生成服务器上运行的生成控制器和生成代理。

• 如果想要临时停止运行此生成服务器，请选择**“否”。 本生成服务器上的控制器和代理不可从团队项目集合中删除，且与“脱机”“状态”一起显示在Visual Studio 管理生成控制器对话框中。 稍后，可以选择“注册”**并还原生成控制器和生成代理。

• 如果希望从团队项目集合中删除此生成的所有配置设置，请选择**“是”**。 有关任何生成控制器和任何生成代理的所有信息都将被删除。

如果显示**“未注册生成服务”消息，则可以选择“注册”**使生成服务器重新工作，并使其可以承载生成控制器和生成代理。

监视您生成服务器的运行状况

在登录到生成服务器时，可确认 Team Foundation Build Service 正在运行，获取关于其所消耗资源的信息，并确认生成服务器的常规运行状态。

1. 运行 Windows 任务管理器（Windows 8 上的任务管理器）。

2. 在 Windows 8 上，如果出现**“更多详细信息”**链接，选择它。

3. 选择**“进程”**选项卡。

4. 在除了 Windows 8 以外的窗口版本上，确保已选择**“显示所有用户的进程”**。

5. 您的生成服务器在什么版本的窗口上运行？

   • Windows 8：找到**“Visual Studio Team Foundation 生成服务主机”进程。 它应位于“后台进程”部分，或者，如果生成服务器正在运行交互模式，则位于“应用程序”**部分。 观察进程正在耗用的 CPU、内存、硬盘和网络资源。

   • 另一 Windows 版本：定位**“TFSBuildServiceHost.exe”**进程。 观察正在耗用进程的 CPU 和内存资源。

6. 使用任务管理器中的其他选项卡确认生成服务器的常规运行状况。 例如，您可以选择**“性能”选项，以确认计算机具有足够的处理器和内存资源。 然后，您可以选择“资源监控器”（在 Windows 8 中，选择“打开资源监控器”**）。

使用事件日志诊断问题

使用事件查看器获取通过生成服务器或生成进程来帮助监视生成服务器如何运行和诊断问题的信息。

查看最近事件

通过检查最近事件开始。 从 Team Foundation 管理控制台中，选择“事件”… 打开事件查看器显示最近信息性消息、警告消息和错误消息。

查看操作日志

要在较长时间内获取详细信息，请在事件查看器的树窗格中展开**“应用程序和服务日志”、“Microsoft”、“Team Foundation Server”、“生成服务”，然后选择“操作”**。

查看分析日志

大多数情况下，并不需要读取分析日志显示的内部消息。 但是，当您使用客户支持解决问题时，此数据可能很有用。

若要启用分析日志

1. 在事件查看器中，选择**“视图”、“显示分析和调试日志”**。

2. 在树窗格中，依次展开**“应用程序和服务日志”、“Microsoft”、“Team Foundation Server”、“生成服务”，然后选择“分析”**。

3. 当**“分析”仍处于选定状态时，打开其快捷菜单，然后选择“启用”**。

自定义和查看数据

若要将数据保存在易于扫描和查看的永久性文件中，请在树窗格中选择上述其中一个节点，打开其快捷菜单，然后选择“保存全部事件”…。 使用**“另存为”**对话框按所需格式保存数据。

后续步骤

• 部署和使用生成服务器。
  若要通过本地 Team Foundation Server 使用 Team Foundation Build，必须部署至少一个生成服务器。 服务器可以在物理计算机或虚拟机上进行部署。

• 部署和配置生成控制器
  使用生成控制器执行轻轻量级任务并将生成进程的处理器密集工作分发至生成代理池。 您可以在生成服务器上承载生成控制器。

• 部署和配置生成代理
  使用生成代理来执行处理器密集型生成工作，包括从版本控制获取文件、配置工作区、编译代码和运行测试。 可在一台生成服务器上承载一个或多个生成代理。

• 设置删除文件夹
  您可以准备并指定一个或多个放置文件夹，以便您的生成系统可以将二进制文件、测试结果和日志文件传递到您的团队。

• 扩展您的 Team Foundation Build 系统
  随着您团队的扩大和基本代码的增加，可以相对轻松地以增量方式扩展您的生成系统。