实现版本控制和 Git 集成

已完成

为了支持持续集成,需要经常将代码更改合并到共享存储库中。 共享存储库是 GitHub 或 Azure DevOps 之类的版本控制系统的一部分。 版本控制是一种管理一段时间内的代码更改的方法。 它可以让你跟踪代码修订,协作参与代码开发,并在需要时还原到以前的代码版本。

GitHub 和 Azure DevOps 是 Fabric 中支持的版本控制系统。 使用这些版本控制系统,你可以创建称为分支的代码存储库的副本。 你可以使用分支来独立于团队代码的主版本处理你自己的代码。 有更改需要提交时,可以将其提交到存储库并将更改与主代码分支合并。

与版本控制的集成位于 Fabric 中的工作区级别。 可以对工作区内开发的项进行版本控制。

连接到 Git 存储库

Fabric 工作区是访问实时项的共享环境。 直接在工作区中所做的任何更改都会替代原来的内容,并影响所有其他工作区用户。 最佳做法是在共享实时工作区之外的独立工作区中进行开发。 在你自己的受保护工作区中,你可以连接到你自己的分支并将实时工作区中的内容同步到受保护的工作区中,然后将更改提交回你的分支或主分支。

  1. 设置 git 存储库:实现 Git 集成的第一步是在 GitHub 或 Azure DevOps 中设置 Git 存储库。 存储库是存储和管理项的中心位置。

  2. 将 Fabric 工作区连接到 Git 存储库:接下来,在你要将其连接到存储库的工作区内,通过工作区设置中的“Git 集成”选项建立与存储库的连接。

    工作区到 Git 提供程序连接接口的屏幕截图。

    将工作区连接到 Git 时,请创建 Git 存储库分支或选择现有的 Git 存储库分支,以便与之同步。 Fabric 会在工作区和 Git 之间同步内容,因此它们有相同的内容。

    在 Git 提供程序接口中进行分支选择的屏幕截图。

提交并更新 Fabric 工作区和 Git 存储库

连接到存储库后,工作区会显示一个 Git 状态列,指示工作区中的项的同步状态(与远程分支中的项相比)。

源代码管理图标显示在工作区和存储库之间不同的项的数目。

同步工作区和存储库:

  • 进行工作区更改时,请使用“源代码管理”窗口中的“更改”选项将这些更改与 Git 分支同步。

  • 在 Git 分支中进行新的提交时,请使用“源代码管理”窗口中的“更新”选项将所做的提交与工作区同步。

    工作区中未提交的更改的屏幕截图。

分支方案

在进行开发工作时对工作区所做的更改会影响所有其他工作区用户,因此最佳做法是在共享工作区之外独立工作。 为了使开发工作与共享工作区隔离,可以通过以下方式进行开发:

  • 使用分开的独立工作区
  • 使用客户端工具,例如 Power BI Desktop(用于报表和语义模型)或 VS Code for Notebooks。

在两种方案中,功能开发工作都应在专用分支而不是主代码分支中进行。 这使得多个开发人员可以轻松地开发一个功能而不会影响主分支。

创建专用分支、发出拉取请求并将工作区与 Git 同步

按照以下步骤创建专用分支并发出拉取请求,将分支中的更改拉取到主分支中:

若要使用分开的独立工作区进行开发,请执行以下操作:

  1. 按照本页的“连接到 Git 存储库”部分中的说明,将开发工作区连接到主分支。

  2. 如果你是使用 Fabric Web 界面的开发人员,请在连接到主分支的开发工作区中为工作创建一个独立的分支,方法是选择“源代码管理”和“分支到新工作区”。 为分支命名并将其与另一个工作区关联。 新创建的工作空间将与您创建的新分支同步,并成为独立且隔离的工作环境。

    屏幕截图显示如何创建新工作区和分支。

  3. 在分支中进行更改,然后通过 Fabric 中的“源代码管理”界面将更改提交到独立分支。

  4. 然后,在 Git 中创建“拉取请求(PR)”,将更改从独立分支拉取到主分支中。

  5. 一旦 PR 合并到 Git 中的主分支,该主分支就会进行更新。 打开共享开发工作区时,系统会提示你将 Git 中的新内容与共享开发工作区同步。

使用客户端工具进行开发时,流程与在 Fabric Web 界面中进行开发时的流程类似。

  1. 按照本页的“将 Fabric 工作区连接到 Git 存储库”部分中的说明,将开发工作区连接到主分支。
  2. 在本地计算机上克隆存储库。
  3. 准备好在 Fabric 中进行测试时,将更改推送到远程存储库。 通过将独立分支连接到单独的工作区来测试更改。
  4. 在 Git 中发出 PR,以将更改合并到主分支中。
  5. 打开与主分支关联的共享工作区时,系统会提示你将存储库中的更改同步到工作区中。