使用 API 自动实现 Git 集成

借助 Microsoft Fabric Git 集成工具，团队可以使用源控件进行协作，从而为其 Fabric 内容构建有效且可重复使用的发布过程。

借助 Microsoft Fabric REST API，可以自动化 Fabric 过程和流程，从而以更少的错误更快完成任务。 因此获得的效率可以节省成本并提高生产力。

本文介绍了如何使用 Git 集成 REST API 在 Microsoft Fabric 中自动化集成 Git。

先决条件

若要使用 Fabric Git API，需要：

• 与在 UI 中使用 Git 集成所需的先决条件相同。

• 具有 Fabric 服务的 Microsoft Entra 令牌。 该令牌将在 API 调用的授权标头中使用。 有关如何获取令牌的信息，请参阅 Fabric API 快速入门。

可以在不使用 PowerShell 的情况下使用 REST API，不过本文中的脚本使用了 PowerShell。 若要运行脚本，需要执行以下步骤：

• 安装 PowerShell。
• 安装 Azure PowerShell Az 模块。

Git 集成 API 函数

Git 集成 REST API 有助你实现内容的持续集成和持续交付 (CI/CD)。 下面是可以使用 API 完成的几个示例：

• 查看哪些项具有传入的更改，以及哪些项具有尚未通过 Git 状态 API 提交到 Git 的更改。

• 获取指定工作区的连接详细信息。

• 连接并断开 Git 存储库的特定工作区以及连接到该存储库的分支。

• 更新 Git 凭据 以更新 Git 凭据配置详细信息。

• 获取 Git 凭据 以获取 Git 凭据配置详细信息。

• 初始化连接到 Git 的工作区的连接。

• 将工作区中所做的更改提交到已连接的远程分支。

• 使用推送到已连接分支的提交更新工作区。

示例

可通过下面的 PowerShell 脚本来了解如何执行多个常见的自动化过程。 若要在 PowerShell 示例中查看或复制文本，请使用本部分中的链接。 还可以查看 Fabric Git 集成示例 GitHub 存储库中的所有示例。

连接并更新

本节介绍将工作区与 Git 连接并更新所涉及的步骤。

有关完整脚本，请参阅从 Git 连接并更新。

1. 登录并获取访问令牌 - 以“用户”（而不是服务主体）身份登录到 Fabric。 请使用 Connect-AzAccount 命令进行登录。 要获取访问令牌，请使用 Get-AzAccessToken 命令。

   代码应如下所示：

   $global:resourceUrl = "https://api.fabric.microsoft.com"
   
   $global:fabricHeaders = @{}
   
   function SetFabricHeaders() {
   
       #Login to Azure
       Connect-AzAccount | Out-Null
   
       # Get authentication
       $fabricToken = (Get-AzAccessToken -ResourceUrl $global:resourceUrl).Token
   
   $global:fabricHeaders = @{
           'Content-Type' = "application/json"
           'Authorization' = "Bearer {0}" -f $fabricToken
       }
   }
   

2. 调用连接 API，以将工作区连接到 Git 存储库和分支。

   Azure DevOps

   
   # Connect to Git
   
   Write-Host "Connecting the workspace '$workspaceName' to Git."
   
   $connectUrl = "{0}/workspaces/{1}/git/connect" -f $global:baseUrl, $workspace.Id
   
   # AzureDevOps details
   
   $azureDevOpsDetails = @{
       gitProviderType = "AzureDevOps"
       organizationName = "<ORGANIZATION NAME>"
       projectName = "<PROJECT NAME>"
       repositoryName = "<REPOSITORY NAME>"
       branchName = "<BRANCH NAME>"
       directoryName = "<DIRECTORY NAME>"
   }
   
   $connectToGitBody = @{
       gitProviderDetails =$azureDevOpsDetails
   } | ConvertTo-Json
   
   Invoke-RestMethod -Headers $global:fabricHeaders -Uri $connectUrl -Method POST -Body $connectToGitBody
   

   GitHub

   
   # Connect to Git
   
   Write-Host "Connecting the workspace '$workspaceName' to Git."
   
   $connectUrl = "{0}/workspaces/{1}/git/connect" -f $global:baseUrl, $workspace.Id
   
   # GitHub details
   
   $gitHubDetails = @{
       gitProviderType = "GitHub"
       ownerName = "<OWNER NAME>"
       repositoryName = "<REPOSITORY NAME>"
       branchName = "<BRANCH NAME>"
       directoryName = "<DIRECTORY NAME>"
   }
   
   $connectToGitBody = @{
       gitProviderDetails = $gitHubDetails
       myGitCredentials = @{
           source = "ConfiguredConnection"
           connectionId = "<CONNECTION ID>"
       }
   } | ConvertTo-Json
   
   Invoke-RestMethod -Headers $global:fabricHeaders -Uri $connectUrl -Method POST -Body $connectToGitBody
   

3. 调用初始化连接 API，以初始化工作区与 Git 存储库/分支之间的连接。

    # Initialize Connection
   
   Write-Host "Initializing Git connection for workspace '$workspaceName'."
   
   $initializeConnectionUrl = "{0}/workspaces/{1}/git/initializeConnection" -f $global:baseUrl, $workspace.Id
   $initializeConnectionResponse = Invoke-RestMethod -Headers $global:fabricHeaders -Uri $initializeConnectionUrl -Method POST -Body "{}"
   

4. 根据初始化连接 API 的响应，调用从 Git 更新 API 以完成更新，或者在不需要任何操作的情况下不执行任何操作。

   以下脚本更新并监视进度：

   if ($initializeConnectionResponse.RequiredAction -eq "UpdateFromGit") {
   
       # Update from Git
       Write-Host "Updating the workspace '$workspaceName' from Git."
   
       $updateFromGitUrl = "{0}/workspaces/{1}/git/updateFromGit" -f $global:baseUrl, $workspace.Id
   
       $updateFromGitBody = @{ 
           remoteCommitHash = $initializeConnectionResponse.RemoteCommitHash
     workspaceHead = $initializeConnectionResponse.WorkspaceHead
       } | ConvertTo-Json
   
       $updateFromGitResponse = Invoke-WebRequest -Headers $global:fabricHeaders -Uri $updateFromGitUrl -Method POST -Body $updateFromGitBody
   
       $operationId = $updateFromGitResponse.Headers['x-ms-operation-id']
       $retryAfter = $updateFromGitResponse.Headers['Retry-After']
       Write-Host "Long Running Operation ID: '$operationId' has been scheduled for updating the workspace '$workspaceName' from Git with a retry-after time of '$retryAfter' seconds." -ForegroundColor Green
   
       # Poll Long Running Operation
       $getOperationState = "{0}/operations/{1}" -f $global:baseUrl, $operationId
       do
       {
           $operationState = Invoke-RestMethod -Headers $global:fabricHeaders -Uri $getOperationState -Method GET
   
           Write-Host "Update from Git operation status: $($operationState.Status)"
   
           if ($operationState.Status -in @("NotStarted", "Running")) {
               Start-Sleep -Seconds $retryAfter
           }
       } while($operationState.Status -in @("NotStarted", "Running"))
   }
   

从 Git 更新

在本节中，我们将介绍使用 Git 中的更改更新工作区所涉及的步骤。 在此脚本中，我们将使用 Git 中的更改来更新工作区项，但会保留 Git 存储库不变。

有关完整脚本，请参阅从 Git 更新工作区。

1. 登录到 Git 并获取身份验证。
2. 调用获取状态 API 以根据 Git 请求正文生成更新。
3. 调用从 Git 更新 API，以使用推送到已连接分支的提交更新工作区。

全部提交

本节分步说明了如何以编程方式将工作区中的所有更改提交到 Git。

有关完整脚本，请参阅将所有更改提交到 Git。

1. 登录到 Git 并获取身份验证。
2. 连接到工作区。
3. 调用 提交到 Git REST API。
4. 获取用于轮询操作状态的长期 OperationId。

选择提交

本节介绍仅将工作区的特定更改提交到 Git 所涉及的步骤。

有关完整脚本，请参阅将选定更改提交到 Git。

1. 登录到 Git 并获取身份验证。
2. 连接到工作区。
3. 调用获取状态 API 以查看工作区的哪些项发生了更改。
4. 选择要提交的具体项。
5. 调用提交到 Git API，以将工作区的选定更改提交到连接的远程分支。

监视长期操作的进度

有关完整脚本，请参阅轮询长期操作。

1. 从从 Git 更新或提交到 Git 脚本中检索 operationId。
2. 按指定的间隔（以秒为单位）调用获取 LRO 状态 API 并打印状态。

注意事项和限制

• 使用 API 进行 Git 集成的限制与使用 Git 集成用户界面时相同。
• 不支持服务主体。
• 使用增强刷新 API 刷新语义模型会导致每次刷新后产生 Git 差异。

相关内容

• Git 集成 - 入门
• Fabric API
• Git 最佳做法