Eventstream CI/CD - Git 整合和部署管線

本文說明 Git 整合和部署管線如何適用於 Fabric 中的 Eventstream。 瞭解如何將工作區同步至 Git 存放庫、將 Eventstream 項目認可至 Git，以及跨不同工作區進行部署。

網狀架構平臺針對不同案例提供 Git 整合和部署管線：

• 使用 Git 整合 將工作區同步至 Git 存放庫，以及管理 Eventstream 專案中的累加變更、小組共同作業、認可歷程記錄。
• 使用 部署管線 將工作區 （含 Eventstream 專案） 部署到不同的開發、測試和生產環境。

必要條件

若要存取 Eventstream 的 CI/CD 功能，您需要符合下列需求：

• 使用所有支援的 Fabric 專案的 Fabric 容量。 如果您還沒有 Fabric 容量，請註冊免費試用。
• 必須從系統管理入口網站啟用 Git 整合： 使用者可以同步處理工作區專案與其 Git 存放庫。
• 從 Azure DevOps 或 GitHub 存取現有的存放庫。
• 您是 Fabric 工作區的系統管理員。

將工作區連線至 Git 存放庫

僅工作區管理員可以將工作區連線到存放庫，但一旦連線，具有權限的任何人都可以在工作區中工作。 如果您不是管理員，請向管理員尋求連線方面的協助。

若要將工作區連線至 Azure 或 GitHub 存放庫，請遵循下列步驟：

1. 登入 Fabric 並瀏覽至您想要連線的工作區。
2. 移至 [ 工作區設定 ]，然後選取 [Git 整合]
3. 選擇 Git 存放庫並輸入 git 資料夾。 一個工作區會同步至 git 資料夾。
4. 從工作區檢視中，您會看到 Eventstream 項目的狀態為 [已同步]。

將 Eventstream 變更認可至 git

對 Eventstream 專案進行變更之後，您會 在工作區檢視中看到 Eventstream 專案旁邊的未認可 Git 狀態。 選取檢視頂端的 [ 原始檔控制 ] 按鈕，然後選擇要認可的 Eventstream 專案。

同步處理 Eventstream 項目之後，您可以在 Git 存放庫中檢視最新的 Eventstream 變更。

從 Git 更新 Eventstream 專案

如果您在 Git 存放庫中變更 Eventstream 專案，您會 在工作區檢視中看到 Eventstream 專案旁的更新必要 git 狀態。 選取檢視頂端的 [ 原始檔控制 ] 按鈕，然後選取 [ 全部 更新] 以合併最新的 Eventstream 變更。

將 Eventstream 專案從一個階段部署到另一個階段

1. 在工作區檢視中，選取 [建立部署管線]。 您也可以從 Fabric 中的部署管線進入點建立管線（工作區清單底部）。
2. 您可以定義它應該具有多少階段，以及應該呼叫的階段。 階段數目是永久性的，在建立管線之後無法變更。
3. 為管線命名。 默認管線有三個階段，名為 Development、 Test 和 Production。 您可以重新命名階段，並在管線中具有 2-10 個階段之間的任何位置。 然後選取 [ 建立並繼續]。
4. 建立管線之後，您可以將工作區指派給每個階段。
5. 在管線階段中擁有內容之後，您可以選取專案並將其 部署 至下一個階段，即使下一個階段工作區有內容也一樣。 已配對的項目會被覆寫。

您可以檢閱部署歷程記錄，以查看上次將內容部署到每個階段的時間。 部署歷程記錄可用來了解一個階段最後一次更新是什麼時候。 如果您要追蹤部署之間的時間，此資訊也很有用處。

若要深入瞭解部署管線，請瀏覽 開始使用部署管線

事件串流元件的 CI/CD 支援

Fabric CI/CD 功能包括 Git 整合、部署管線及公開 API。 本節概述各種 Eventstream 元件與不同 CI/CD 功能的相容性。 了解這些支援層級對於維護與部署跨工作空間的 Eventstream 項目至關重要。

支援層級定義

• 完全支援：部署期間設定會被完全保留。
• 部分支援：資源支援 CI/CD，但不支援 進階設定 （例如 Azure SQL DB （CDC）欄位排除清單，部署後會回復預設值。
• 不支援：該元件不支援透過 Git 整合與部署管線進行 CI/CD。

元件支撐矩陣

類別	完全支援	部分支持	不支援
來源	標準 GA 來源（例如 Azure Event Hubs、Confluent、Sample Data）	Azure SQL 資料庫 （CDC） Azure SQL 受控執行個體 （CDC） MySQL資料庫（CDC） PostgreSQL 資料庫 CDC 虛擬機器上的 SQL Server （CDC）	Azure Service Bus（預覽） Cribl（預覽） HTTP（預覽） MongoDB CDC（預覽）
目的地	所有目的地	-	-
Operators	Filter 管理欄位 Aggregate 加入 分組依據 Union 展開	SQL 程式碼（自訂程式碼）	-
Features	一般功能（例如多結構推論）	-	暫停/繼續狀態

這很重要

在 CI/CD （Git 整合和部署管線） 之後，目標事件串流中的所有資源都會變成作用中，除非它們因連線或組態問題而失敗。 原始事件流 （匯出至 Git） 和正在部署的事件流中的資源會保留其狀態。

警告

在匯入 Azure Event Grid 命名空間 來源時，請確保 你在目標 Fabric 工作空間中擁有成員或更高的權限。 如果没有，請在繼續之前為事件網格服務主體申請 Contributor 權限。

限度

• Git 整合 和 部署管線 對跨工作區案例的支援有限。 若要避免問題，請確定所有事件串流目的地都在相同的工作區內。 跨工作區部署可能無法如預期般運作。
• 如果事件資料流包含使用 直接擷取 模式的 Eventhouse 目的地，您必須在將連線匯入或部署至新工作區之後，手動重新設定連線。

相關內容

• 開始使用 Git 整合
• 為您選擇最佳的網狀架構 CI/CD 工作流程選項