将生成排入队列

通过创建一个或多个生成定义来定义生成过程之后,您便可开始从生成系统受益。 大部分生成过程是使用自动触发器进行定义的。 有关更多信息,请参见指定生成触发器和原因

无论您的生成定义包含的是手动触发器还是自动触发器,您均可在需要时对生成进行手动排队。

常规任务

支持内容

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

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

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

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

公共生成

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

所需权限

若要执行此过程,您的**“将生成排队”权限必须设置为“允许”**。 有关更多信息,请参见 Team Foundation Server 权限

在 Visual Studio 中对公共生成进行排队

  1. 在团队资源管理器中,单击适当的团队项目。

  2. 在**“生成”菜单中单击“使新生成入队”**。

    将出现**“将生成‘团队项目名称’排队”**对话框。

  3. 在**“生成定义”**列表中,选择一个生成定义。

    如果您所选择的生成定义具有说明,则相应的说明将显示在**“生成定义”**列表下。

  4. 在**“您希望生成什么?”列表中,保持选中“最新源”**。

  5. (可选)在**“生成控制器”**列表中,选择默认生成控制器之外的生成控制器。

  6. (可选)在**“队列中的优先级别”列表中选择以下值之一:“高”“高于正常”“正常”“低于正常”“低”**。

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

  7. (可选)**“该生成的放置文件夹”**框将显示生成完成之后存储二进制文件等输出的文件夹。 如果您希望将输出存储在其他位置,请在此框中键入该位置的通用命名约定 (UNC) 路径。

    重要说明重要事项

    如果您修改此值,则必须指定已准备用作放置文件夹的文件夹。 有关更多信息,请参见设置放置文件夹

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

    如果生成定义基于**“默认模板”“升级模板”**,请参见Define Workflow Builds Using the Default Template通过升级模板来使用旧式 MSBuild 生成以获得有关这些参数的更多信息。

  9. 单击**“队列”**。

    **“生成资源管理器”将出现,其中将显示“已排队”**选项卡。 有关更多信息,请参见管理和查看已完成的生成

专用生成

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

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

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

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

  • 以下生成过程参数将假定为**“False”**,因此不管生成定义中指定的设置如何,都不会产生任何影响:

    • 标记源

    • 在失败时创建工作项

    • 将变更集与工作项相关联

  • 在**“生成资源管理器”**中,已完成的生成显示在以下图标旁边: ms181722.Icon_BldPrivateBuild(zh-cn,VS.100).gif

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

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

对专用生成进行排队

所需权限

若要执行此过程,您的**“将生成排队”权限必须设置为“允许”**。 有关更多信息,请参见 Team Foundation Server 权限

在 Visual Studio 中对专用生成进行排队

  1. 在团队资源管理器中,单击适当的团队项目。

  2. 在**“生成”菜单中单击“使新生成入队”**。

    将出现**“将生成‘团队项目名称’排队”**对话框。

  3. 在**“生成定义”**列表中,选择一个生成定义。

    如果您所选择的生成定义具有说明,则相应的说明将显示在**“生成定义”**列表下。

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

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

  5. 执行以下步骤之一:

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

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

  6. (可选)在生成成功的情况下,如果您希望签入搁置集中的更改,请选中**“在成功生成后签入更改”**复选框。

    重要说明重要事项

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

  7. (可选)在**“生成控制器”**列表中,选择默认生成控制器之外的生成控制器。

  8. (可选)在**“队列中的优先级别”列表中选择以下值之一:“高”“高于正常”“正常”“低于正常”“低”**。

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

  9. (可选)执行以下步骤以指定将下载生成的输出(例如二进制文件)的文件夹:

    提示

    忽略“该生成的放置文件夹”框,因为此框在专用生成中没有作用。

    1. 单击**“参数”选项卡,然后展开“高级”**组。

    2. 在**“专用放置位置”**框中,键入您在生成完成后要存储输出的文件夹的 UNC 路径。

      提示

      • 如果您未指定此文件夹,生成不会失败,但生成日志中会出现警告。

      • 如果您修改此值,则必须指定已准备用作放置文件夹的文件夹。 有关更多信息,请参见设置放置文件夹

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

    如果生成定义基于**“默认模板”“升级模板”**,请参见Define Workflow Builds Using the Default Template通过升级模板来使用旧式 MSBuild 生成以获得有关这些参数的更多信息。

  11. 单击**“队列”**。

    **“生成资源管理器”将出现,其中将显示“已排队”**选项卡。 有关更多信息,请参见管理和查看已完成的生成

请参见

任务

创建基本生成定义

概念

使用默认模板定义生成

使用搁置集

定义封闭签入生成以验证更改