将生成排入队列
通过创建一个或多个生成定义来定义生成过程之后,您便可开始从生成系统受益。 大部分生成过程是使用自动触发器进行定义的。 有关更多信息,请参见指定生成触发器和原因。
无论您的生成定义包含的是手动触发器还是自动触发器,您均可在需要时对生成进行手动排队。
常规任务 |
支持内容 |
---|---|
对公共生成进行排队 - 如果您希望生成版本控制服务器中最新版本的源代码。 若要在命令提示符处对公共生成进行排队,请使用 TFSBuild start 命令。 |
|
对专用生成进行排队 - 如果您要生成已放入搁置集的更改。 您可使用专用生成(也称为“合作者生成”)在签入代码前验证对代码的更改。 若要在命令提示符处对专用生成进行排队,请使用包含 /shelveset 选项的 TFSBuild start 命令。 |
公共生成
不管生成定义中是否指定了自动触发器,您均可手动对生成进行排队。
所需权限
若要执行此过程,您的**“将生成排队”权限必须设置为“允许”**。 有关更多信息,请参见 Team Foundation Server 权限。
在 Visual Studio 中对公共生成进行排队
在团队资源管理器中,单击适当的团队项目。
在**“生成”菜单中单击“使新生成入队”**。
将出现**“将生成‘团队项目名称’排队”**对话框。
在**“生成定义”**列表中,选择一个生成定义。
如果您所选择的生成定义具有说明,则相应的说明将显示在**“生成定义”**列表下。
在**“您希望生成什么?”列表中,保持选中“最新源”**。
(可选)在**“生成控制器”**列表中,选择默认生成控制器之外的生成控制器。
(可选)在**“队列中的优先级别”列表中选择以下值之一:“高”、“高于正常”、“正常”、“低于正常”或“低”**。
**“位置”**框将显示生成在队列中的估计位置。
(可选)**“该生成的放置文件夹”**框将显示生成完成之后存储二进制文件等输出的文件夹。 如果您希望将输出存储在其他位置,请在此框中键入该位置的通用命名约定 (UNC) 路径。
重要事项 如果您修改此值,则必须指定已准备用作放置文件夹的文件夹。 有关更多信息,请参见设置放置文件夹。
(可选)在**“参数”**选项卡上,查看和重写仅用于此次运行的其他生成定义设置。
如果生成定义基于**“默认模板”或“升级模板”**,请参见Define Workflow Builds Using the Default Template或通过升级模板来使用旧式 MSBuild 生成以获得有关这些参数的更多信息。
单击**“队列”**。
**“生成资源管理器”将出现,其中将显示“已排队”**选项卡。 有关更多信息,请参见管理和查看已完成的生成。
专用生成
如果您要生成已放入搁置集的更改,则应对专用生成进行排队。 您可使用专用生成(也称为“合作者生成”)在签入代码前验证对代码的更改。 在签入更改前执行更改的专用生成,可减少它们中断团队定期运行(如按夜生成)的任何生成的可能性。
专用生成与公共生成之间的区别
已完成专用生成与已完成公共生成的结果在以下方面有所不同:
专用生成与封闭签入生成的类似之处在于,您将生成包含搁置集中的更改的代码。 不过,它与封闭签入生成不同的是,专用生成之后不会自动签入更改。
以下生成过程参数将假定为**“False”**,因此不管生成定义中指定的设置如何,都不会产生任何影响:
标记源
在失败时创建工作项
将变更集与工作项相关联
在**“生成资源管理器”**中,已完成的生成显示在以下图标旁边:
通过使用 Build N 格式命名已完成的生成,其中 N 为唯一整数值。 此格式不同于通过使用**“内部版本号格式”**参数指定的公共生成的格式。
对于每个生成定义,指定一个独立(并且可以是不同的)的保留策略,以限制系统中存储的已完成的专用生成的数量。
对专用生成进行排队
所需权限
若要执行此过程,您的**“将生成排队”权限必须设置为“允许”**。 有关更多信息,请参见 Team Foundation Server 权限。
在 Visual Studio 中对专用生成进行排队
在团队资源管理器中,单击适当的团队项目。
在**“生成”菜单中单击“使新生成入队”**。
将出现**“将生成‘团队项目名称’排队”**对话框。
在**“生成定义”**列表中,选择一个生成定义。
如果您所选择的生成定义具有说明,则相应的说明将显示在**“生成定义”**列表下。
在**“您希望生成什么?”列表中,选择“包含搁置集的最新源”**。
将出现**“搁置集名称”**对话框。
执行以下步骤之一:
如果您已经有一个搁置集,请在**“搁置集名称”框中键入其名称,或者单击省略号 (...**) 按钮以搜索搁置集。
如果要将工作区中的一些挂起的更改放入搁置集中,然后再生成这些更改,请单击**“创建”**。
(可选)在生成成功的情况下,如果您希望签入搁置集中的更改,请选中**“在成功生成后签入更改”**复选框。
重要事项 如果您选中此复选框,则生成将作为封闭签入生成而不是作为专用生成运行。 有关封闭签入生成的更多信息,请参见定义封闭签入生成以验证更改。
(可选)在**“生成控制器”**列表中,选择默认生成控制器之外的生成控制器。
(可选)在**“队列中的优先级别”列表中选择以下值之一:“高”、“高于正常”、“正常”、“低于正常”或“低”**。
**“位置”**框将显示生成在队列中的估计位置。
(可选)执行以下步骤以指定将下载生成的输出(例如二进制文件)的文件夹:
提示
忽略“该生成的放置文件夹”框,因为此框在专用生成中没有作用。
单击**“参数”选项卡,然后展开“高级”**组。
在**“专用放置位置”**框中,键入您在生成完成后要存储输出的文件夹的 UNC 路径。
提示
-
如果您未指定此文件夹,生成不会失败,但生成日志中会出现警告。
-
如果您修改此值,则必须指定已准备用作放置文件夹的文件夹。 有关更多信息,请参见设置放置文件夹。
-
(可选)在**“参数”**选项卡上,查看和重写仅用于此次运行的其他生成定义设置。
如果生成定义基于**“默认模板”或“升级模板”**,请参见Define Workflow Builds Using the Default Template或通过升级模板来使用旧式 MSBuild 生成以获得有关这些参数的更多信息。
单击**“队列”**。
**“生成资源管理器”将出现,其中将显示“已排队”**选项卡。 有关更多信息,请参见管理和查看已完成的生成。