將連結的 Resource Manager 範本搭配 CI/CD 使用

適用於: Azure Data Factory Azure Synapse Analytics

提示

Data Factory in Microsoft Fabric 是下一代的 Azure Data Factory,擁有更簡單的架構、內建 AI 及新功能。 如果你是資料整合新手,建議先從 Fabric Data Factory 開始。 現有的 ADF 工作負載可升級至 Fabric,以存取資料科學、即時分析與報告等新能力。

如果你已經為資料工廠設定了持續整合與交付(CI/CD),隨著工廠規模擴大,可能會超出 Azure Resource Manager 範本的限制。 例如,其中一個限制是 Resource Manager 範本中最大資源數量。 為了容納大型工廠同時產生完整的 Resource Manager 範本,Data Factory 現在會產生連結的 Resource Manager 範本。 透過這項功能,整個工廠的有效負載會被細分成數個檔案,讓您不受限制約束。

尋找連結的範本

如果你已經設定了 Git,連結的範本會被產生並與完整的 Resource Manager 範本一起儲存在 adf_publish 分支中,並存於一個名為 linkedTemplates 的新資料夾中:

相關資源管理器模板資料夾

連結的 Resource Manager 範本通常由一個基礎範本和一組子範本組成,這些子範本與基礎相連結。 父範本稱為 ArmTemplate_master.json,而子範本會以 ArmTemplate_0.json、ArmTemplate_1.json 等這個模式來命名。

使用連結的範本

若要使用連結範本取代完整的Resource Manager範本,請更新你的 CI/CD 任務,指向 ArmTemplate_master.json 而非 ArmTemplateForFactory.json(完整的 Resource Manager 範本)。 Resource Manager 也要求你將連結的範本上傳到儲存帳號,這樣 Azure 才能在部署時存取。 欲了解更多資訊,請參閱 使用 VSTS 部署連結的 Resource Manager 範本。

因為這是「連結範本」,所以 ARM 部署任務需要儲存帳戶 URL 和 SAS 權杖。 即使服務負責人能存取部落格,SAS 憑證仍是必要的,因為連結範本會在 Azure 中部署,且不會有使用者的上下文。 若要達成此目的,CI/CD 步驟所產生的連結範本需要下列參數 containerURI 和 containerSasToken。 建議您將 SAS 權杖作為祕密傳入,可透過安全變數或 Azure Key Vault 等服務來處理。

請記得在在部署工作之前和之後,於 CI/CD 管線中新增 Data Factory 指令碼。

如果尚未設定 Git,則可透過 [ARM 範本] 清單中的 [匯出 ARM 範本]來存取連結的範本。

部署資源時,您要指定部署為累加式更新或是完整更新。 這兩種模式的差別在於 Resource Manager 如何處理資源群組中未包含在範本中的現有資源。 請檢閱部署模式。

共用自我裝載整合執行階段的考量

警告

將連結的 ARM 範本部署至使用 連結(共享)自架整合執行個體 的環境時,Resource Manager 部署會以沒有註冊節點的純自架 IR 定義覆蓋連結 IR 配置。 這會導致 IR 變得 不可用,所有依賴它的連結服務中斷。 這是因為發佈時產生的連結 ARM 範本總是將整合執行時匯出為獨立的 Microsoft.DataFactory/factories/integrationRuntimes 資源,且不感知目標環境中的連結 IR 關係。

為防止此情況,請在您的 CI/CD 流程中新增一個步驟,在 Resource Manager 部署步驟之前,從連結的模板檔案中移除 IR 資源定義。 如果目標環境使用的 IR 名稱與來源工廠不同,移除後再加重命名步驟。 目標環境中的共享 IR 保持完整,所有連結服務在部署後仍能正常解析。