步驟 1:在 Visual Studio 中新增 BizTalk Server 應用程式專案
當您使用 Visual Studio Team Services 建置應用程式時,會建立新的 BizTalk 項目檔 – .btaproj。 這個新專案會保留您使用 Azure DevOps 建置和發行功能建置和部署的所有 BizTalk 應用程式。
BizTalk 應用程式專案包含 檔案 BizTalkServerInventory.json
。 在此檔案中,新增 BizTalk 元件、新增 BizTalk 應用程式的系結檔案,然後設定部署順序。
開始之前
- 使用協調流程建立簡單的 BizTalk 專案。
- 讓 XML 系結檔的路徑準備好到 BizTalk 專案。 此 XML 檔案會建立您的傳送和接收埠。
- 瞭解您的 Azure DevOps 帳戶、您的集合,以及您的小組專案詳細數據。
- 熟悉 git 概念,包括複製和使用存放庫。
新增應用程式專案
在 BizTalk Server 上,在 Visual Studio 中開啟您的解決方案 (ProjectName.sln) 。 請勿選取 Visual Studio Blend。
在方案總管中,以滑鼠右鍵按兩下您的專案 >[建置]。 請確定您的組建成功。 以滑鼠右鍵按下您的專案 >[部署]。 請確定您的部署成功。
以滑鼠右鍵按下您的方案 >[新增>專案]。
選取 [下一步] BizTalk Server [應用程式專案>]。 輸入項目名稱,例如
appProjectHelloWorld
>[建立]。在 方案總管 中,以滑鼠右鍵按下新新增的應用程式專案 (.btaproj) >[新增>參考]。 展開 [ 專案] 索引 標籤,並檢查您的 BizTalk 專案 (您使用 Azure DevOps) 部署的專案。 選取 [確定]。
新增之後,請展開應用程式專案底下的 [參考 ] (,例如 appProjectHelloWorld) ,以查看您剛才新增的 BizTalk 專案。
在 方案總管 中,以滑鼠右鍵按兩下您的應用程式專案 (.btaproj) > [新增現有的專案>] [新增>系結 XML 檔案]。
選擇性。 以滑鼠右鍵按下您新增的應用程式專案 >[屬性]。 自訂您要顯示在 BizTalk 管理中的 應用程式名稱 :
設定 JSON 範本
在 Visual Studio 中,在應用程式專案中 (.btaproj) ,開啟檔案
BizTalkServerInventory.json
。範本包含下列區段:
- BizTalkAssemblies:應用程式中使用的元件。
- BindingFiles:您所參考的系結檔案。
- DeploymentSequence:要安裝之專案的序列。
範例範本:
重要
視解決方案的複雜度而定,您需要在此 JSON 範本檔案中參考組建中的元素。
在 中
BizTalkAssemblies
,新增 BizTalk 專案所使用的元件:"BizTalkAssemblies": [ { "Name": "AssemblyName", "Path": "PathToAssembly } ]
在 中
BindingsFiles
,新增 BizTalk 專案的系結檔案:"BindingsFiles": [ { "Name": "Binding File Name", "Path": "PathToBindingFile } ]
在
DeploymentSequence
中,依照您想要部署的應用程式名稱順序新增應用程式名稱,並在 BizTalk Server 上安裝:"DeploymentSequence": [ "NameOfFirst", "NameOfSecond", "NameOfThird" ]
儲存您的變更。 完成時,您的.json檔案看起來如下:
{ "$schema": "http://json.schemastore.org/BizTalkServerApplicationSchema", "BizTalkAssemblies": [ { "Name": "HelloWorld", "Path": "HelloWorld\\bin\\Release\\HelloWorld.dll" } ], "BindingsFiles": [ { "Name": "HelloWorldBinding", "Path": "HelloWorld\\HelloWorldBinding.xml" } ], "DeploymentSequence": [ "HelloWorld", "HelloWorldBinding" ] }
選擇項。 以滑鼠右鍵按下您的應用程式專案 (例如 appProjectHelloWorld) >Properties。 您可以將 [偵錯] 或 [發行] 版本設定為新的值。 我們不會在這些步驟中,但知道您可以:
以滑鼠右鍵按下您的應用程式專案 (例如 appProjectHelloWorld) >Build。 如果成功, 則會在 yourApplicationProject\bin\debug 資料夾中建立 zip 檔案:
選取您的解決方案,然後選取 [ Team Explorer] 索引標籤。在 [Azure DevOps] 底下,選取 [ 連線]。
選取您的 Azure DevOps 帳戶、您的集合和小組專案。 選取 [確定]。 如果您尚未建立 Azure DevOps 帳戶,請建立一個 (步驟 2:建立 Azure DevOps 令牌 提供一些指引) 。 建立之後,請返回此步驟並連線。
當您連線時,可能會收到複製此存放庫的提示。 選取 [複製此存放庫 ] 連結。
記下 URL 和路徑,然後選取 [複製]:
完成後,Azure DevOps 部署工作會接受必要的檔案和安裝順序。
提示
如果您在 git 中複製之後對專案進行變更,您可以 暫存 變更,然後在 Visual Studio 中 全部推送。
您的作法
在 BizTalk 專案中,您已新增 BizTalk 應用程式專案 (.btaproj) 。 此專案可用來使用 Azure DevOps 將 BizTalk Server 專案的部署自動化。 建立應用程式項目之後,您已新增 BizTalk 項目的參考。 然後,您已更新 JSON 檔案,告知自動化部署要部署的 DLL、要使用的系結檔案,以及部署應用程式的順序。