对生成进行排队

  • 项目

通过创建一个或多个生成定义来定义生成过程之后，您便可开始从生成系统受益。 大部分生成过程是使用自动触发器进行定义的。 无论您的生成定义包含的是手动触发器还是自动触发器，您均可在需要时对生成进行手动排队。

重要

如果您结合使用了 Visual Studio 2013 和 Visual Studio Team Foundation Server 2013，则在对生成进行排队时修改生成过程参数可能会遇到问题。获取 KB 2898341 修补程序。

常规任务

支持内容

对公共生成进行排队 - 如果您希望生成版本控制服务器中最新版本的源代码。

若要在命令提示符处对公共生成进行排队，请使用 TFSBuild start 命令。

对专用生成进行排队 - 如果您要生成已放入搁置集的更改。 您可使用专用生成（也称为“合作者生成”）在签入代码前验证对代码的更改。

若要在命令提示符处对专用生成进行排队，请使用包含 /shelveset 选项的 TFSBuild start 命令。

如果要使用与某个已完成的生成相同的选项对公共或专用生成进行排队，则可选择“重试已完成的生成”。

重试已完成的生成

公共生成

不管生成定义中是否指定了自动触发器，您均可手动对生成进行排队。

  1. 在**“团队资源管理器”**中：

    1. 如果尚未连接到要处理的团队项目，请连接到团队项目。

    2. 选择 “主页”图标“主页”，然后选择 “生成”图标“生成”（键盘输入：Ctrl + 0, B）。

    3. 在**“生成”页的“收藏夹生成定义”或“所有生成定义”中，打开生成定义的上下文菜单，然后选择“将新生成排队”**。

    即会出现**“将生成‘TeamProjectName’排队”**对话框。

  2. 在**“生成定义”**列表中，将会选定生成定义并在下面显示其说明。 如果要对不同的生成定义进行排队，则可以从列表中选择一个生成定义。

  3. 在**“您希望生成什么?”列表中，确保选中“最新源”**。

  4. （可选）在**“生成控制器”**列表中，选择默认生成控制器之外的生成控制器。

  5. （可选）在**“队列中的优先级别”列表中选择以下值之一：“高”、“高于正常”、“正常”、“低于正常”或“低”**。

    **“位置”**框将显示生成在队列中的估计位置。

  6. （可选）**“此生成的放置文件夹”**框将显示生成完成之后存储二进制文件和日志文件等输出的位置。 如果您希望将输出存储在其他位置，请在此框中键入指向该位置的路径。

    重要

    如果您修改此值，则必须指定已准备用作放置文件夹的文件夹。如果您已将“将生成输出复制到服务器”指定为生成定义的临时位置，就无法修改此值。

    请参阅设置放置文件夹。

  7. （可选）在**“参数”**选项卡上，查看和重写仅用于此次运行的其他生成定义设置。

    如果生成定义基于**“默认模板”或“升级模板”**，请参见对生成过程使用默认模板或解决在升级时会出现的问题以获得有关这些参数的更多信息。

  8. 选择**“队列”**。

专用生成

如果您要生成已放入搁置集的更改，则应对专用生成进行排队。 您可使用专用生成（也称为“合作者生成”）在签入代码前验证对代码的更改。 通过在签入更改前执行更改的专用生成，可减少它们中断团队定期运行（如每夜生成）的任何生成的可能性。

专用生成与公共生成之间的区别

已完成专用生成与已完成公共生成的结果在以下方面有所不同：

  • 专用生成与封闭签入生成的类似之处在于，您将生成包含搁置集中的更改的代码。 不过，它与封闭签入生成不同的是，专用生成之后不会自动签入更改。

  • 该生成不会标记源，不会在失败时创建工作项，也不会关联变更集和工作项。

  • 在**“生成资源管理器”**中，已完成的生成显示在以下图标旁边：Icon_BldPrivateBuild

  • 通过使用格式 Build N 命名已完成的生成，其中 N 为唯一整数值。 此格式不同于通过使用**“生成号格式”**参数指定的公共生成的格式。

  • 对于每个生成定义，指定一个独立（并且可以是不同的）的保留策略，以限制系统中存储的已完成的专用生成的数量。

对专用生成进行排队

  1. 在**“团队资源管理器”**中：

    1. 如果尚未连接到要处理的团队项目，请连接到团队项目。

    2. 选择 “主页”图标“主页”，然后选择 “生成”图标“生成”（键盘输入：Ctrl + 0, B）。

    3. 在**“生成”页的“收藏夹生成定义”或“所有生成定义”中，打开生成定义的上下文菜单，然后选择“将新生成排队”**。

    即会出现**“将生成‘TeamProjectName’排队”**对话框。

  2. 在**“生成定义”**列表中，将会选定生成定义并在下面显示其说明。 如果要对不同的生成定义进行排队，则可以从列表中选择一个生成定义。

  3. 在**“您希望生成什么?”列表中，选择“包含搁置集的最新源”**。

    将出现**“搁置集名称”**对话框。

  4. 执行下列步骤之一：

    • 如果您已经有一个搁置集，请在**“搁置集名称”框中键入其名称，或者选择省略号 (...**) 按钮以搜索搁置集。

    • 如果要将工作区中的一些挂起的更改放入搁置集中，然后再生成这些更改，请选择**“创建”**。

  5. （可选）如果生成已成功，并且您希望签入搁置集中的更改，请选中**“在成功生成后签入更改”**复选框。

    重要

    如果您选中此复选框，则生成将作为封闭签入生成而不是作为专用生成运行。有关封闭签入生成的更多信息，请参见使用封闭签入生成过程以验证更改。

  6. （可选）在**“生成控制器”**列表中，选择默认生成控制器之外的生成控制器。

  7. （可选）在**“队列中的优先级别”列表中选择以下值之一：“高”、“高于正常”、“正常”、“低于正常”或“低”**。

    **“位置”**框将显示生成在队列中的估计位置。

  8. （可选）在**“参数”**选项卡上，查看和重写仅用于此次运行的其他生成定义设置。

    如果生成定义基于**“默认模板”或“升级模板”**，请参见对生成过程使用默认模板或解决在升级时会出现的问题以获得有关这些参数的更多信息。

  9. 选择**“队列”**。

重试已完成的生成

当测试对生成过程的某些潜在更改或试验选项时，可以使用对现已完成的生成进行排队时指定的相同选项，快速对公共或专用生成进行排队。

  • 在**“团队资源管理器”**中：

    1. 如果尚未连接到要处理的团队项目，请连接到团队项目。

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

    3. 在**“生成”页的“我的生成”下，打开已完成生成的上下文菜单，然后选择“重试生成”**。