在 Azure Boards 中从工作项驱动 Git 开发

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

团队推动其开发并保持同步的方式之一是将工作项链接到开发期间创建的对象,例如分支、提交、拉取请求和生成。 可以通过从一个或多个工作项创建分支来开始该链接。 稍后,可以创建拉取请求、快速打开提交,并维护为完成特定工作而执行的开发操作的记录。

在本文中,了解如何执行以下任务:

  • 如何从工作项创建新分支或拉取请求
  • 完成拉取请求
  • 执行 squash 合并
  • 为多个工作项创建分支
  • 将工作项链接到现有开发和生成对象

本文介绍如何创建新分支、添加提交链接,以及将拉取请求添加到 Azure DevOps 上托管的 Git 存储库。 若要链接到 GitHub 提交和拉取请求,请参阅将 GitHub 提交和拉取请求链接到工作项

提示

可以设置自动链接以及将工作项链接到 Git 提交、拉取请求、生成等的其他设置。 有关详细信息,请参阅以下资源:

开发控件

开发控件记录支持完成工作项的所有 Git 开发过程。 此控件可以显示执行下一个开发步骤所需的团队信息,并最小化导航步骤以完成常见开发任务。 它还支持可跟踪性,从而提供与工作项相关的所有分支、提交、拉取请求和生成的可见性。

工作项表单、开发控件的屏幕截图。

工作项窗体、开发控件、Azure DevOps Server 2019 的屏幕截图。

从中,可以快速访问链接到工作项的分支、拉取请求和提交。 此外,还可以为已创建或从工作项链接到的分支启动拉取请求。

请记住,开发控件仅显示在 Web 门户工作项表单中。 Visual Studio 或其他受支持的客户端中显示的工作项跟踪体验和表单不会显示 Web 门户中提供的多项功能。

先决条件

  • 连接到项目。 如果没有项目,请创建一个
  • 必须作为参与者项目管理员安全组的成员添加到项目。 若要添加,请将用户添加到项目或团队
  • 若要查看或修改工作项,必须将查看此节点中的工作项编辑此节点中的工作项权限设置为允许。 默认情况下,参与者组设置了此权限。 有关详细信息,请参阅为工作跟踪设置权限和访问权限
  • 连接到项目。 如果没有项目,请创建一个
  • 必须作为参与者项目管理员安全组的成员添加到项目。 若要添加,请将用户添加到项目或团队
  • 若要查看或修改工作项,必须将查看此节点中的工作项编辑此节点中的工作项权限设置为允许。 默认情况下,参与者组设置了此权限。 有关详细信息,请参阅为工作跟踪设置权限和访问权限

工作流过程

如果没有链接的代码项目,请考虑创建新分支。 如果分支存在,但没有拉取请求,请考虑创建拉取请求。 下面是使用 Git 存储库时的典型工作流序列。

  1. 通过创建分支开始处理工作项。 可以从“开发”部分添加新的 Git 分支...

    “开发”控件,创建分支链接的屏幕截图。

    ...或者,从表单的“ 操作”菜单。

    用户情景工作项表单,“操作”菜单,添加新分支。

    为分支命名并选择存储库。

    创建“分支”对话框

    创建分支时,分支会自动链接到工作项。

    注意

    只有在将文件添加到主分支后,才能创建分支,我们建议你标记 main 或其他独特的标签。 系统会自动将自述文件添加到使用每个新项目创建的初始存储库。

  2. 系统对你创建的存储库和分支开放。

    可以在 Web 门户中编辑文件。

    或者,如果有大量的文件编辑或需要添加文件,则请使用 Visual Studio 或其他受支持的 IDE。 从创建的分支添加新的本地分支。 有关详细信息,请参阅使用提取和拉取更新代码、使用提取下载更改。 (虽然任何代码编辑和提交过程都可以正常工作,但我们最好使用一个版本的 Visual Studio。)

  3. 在创建的分支中添加或修改文件。

    从 Visual Studio 或其他受支持的 IDE 中,将更改从本地分支提交并推送到存储库。

    提交和推送更改

    如果这是第一次从新分支推送更改,则请在推送更改之前发布分支。 有关详细信息,请参阅使用推送共享代码

  4. 从工作项表单创建拉取请求

    创建拉取请求以合并对主分支所做的更改,并让团队的其他成员审阅更改。

    “开发”控件,创建拉取星期链接的屏幕截图。

  5. 视图会切换到“代码”,然后切换到“拉取请求”页。 完成创建拉取请求,如下所示。

    代码视图,“拉取请求”页。

    注意

    创建拉取请求后,在完成上一个拉取请求之前,无法为同一分支创建新的拉取请求。

    “拉取请求”页,创建拉取请求。

    选中合并时 Squash 更改框,然后完成合并。

    “完成拉取请求”对话框,选中 squash-merge

  6. 完成后,应会看到如下所示的屏幕。

    拉取请求、完成的通知

  7. 打开工作项表单或刷新表单,展开开发部分(选择最大化开发),你会看到为支持完成的操作而添加的链接。

    “工作项”窗体、“开发”部分、已添加链接的屏幕截图。

为多个工作项创建分支

还可以从积压工作 (backlog) 或看板面板中列出的工作项添加新分支,而无需打开工作项。 使用多选,可以选择多个工作项,并在其中创建一个新分支,这些工作项全部链接到分支。

例如,我们在此处选择要链接到新分支的前五个项。

从积压工作 (backlog) 选择多个项,创建分支链接的屏幕截图。

然后,我们会指定分支的名称。

“创建新分支”对话框

“开发”部分下列出的所有项也会显示在链接选项卡下。从“开发”部分启动的所有开发操作也会记录在历史记录选项卡下。

“链接”选项卡、开发链接

要将工作项链接到现有对象,请选择添加链接“添加链接”图标,然后选择链接类型。

选择“添加链接”图标,然后选择链接类型。

如果要删除链接,可以从开发部分执行此操作,方法是先突出显示该链接,然后选择删除链接

“开发”部分、删除链接

或者,可以从链接选项卡中选择它,为链接选择操作,然后选择删除链接选项。

生成中的关联工作项

使用 Git 提交时,已链接到提交的任何工作项均列在“生成摘要”页的“关联工作项”下。

链接工作项列在“生成摘要”页的“关联工作项”下。

由于以下操作,出现本部分中所示链接:

  • 从工作项创建分支、提交或拉取请求
  • 在提交、拉取请求或其他受支持的 Git 或 TFVC 操作期间指定工作项 ID
  • 专门将开发部分或链接选项卡中的工作项链接到源代码分支、生成或其他受支持的 Git 或 TFVC 操作。

将鼠标悬停在“开发”部分下列出的任何条目上会激活指向关联对象的超链接。

可以在“开发”部分中添加的链接类型包括分支、生成、更改集、提交、在生成中查找、在生成中集成、拉取请求和版本控制项。

生成工件到生成工件链接类型

若要详细了解链接控件或自定义开发链接控件,请参阅 LinksControlOptions 元素,开发链接控件