共用方式為


教學課程:使用 Azure Pipelines 設定 Service Fabric 應用程式的 CI/CD

本教學課程是系列課程的 第四部分 。 它示範如何使用 Azure Pipelines 來設定 Azure Service Fabric 應用程式的持續整合和持續部署 (CI/CD)。 若要完成教學課程,您必須有現有的 Service Fabric 應用程式。 本指導教學使用 指導教學系列第一部分中所述的應用程式。

在本教學課程中,您將瞭解如何:

  • 將原始檔控制新增至您的專案
  • 在 Azure Pipelines 中建立組建管線
  • 在 Azure Pipelines 中建立發行管線
  • 自動部署和升級應用程式

教學課程系列說明如何:

先決條件

開始進行本教學課程之前:

下載投票應用程式範例

如果您未在本 系列的第一部分中建置投票範例應用程式,您可以下載它。 在命令視窗中,執行下列命令,將範例應用程式存放庫複製到本機電腦。

git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart

下載發行設定檔

現在您 已建立應用程式 並將 應用程式部署至 Azure,您就可以設定持續整合了。 首先,在應用程式內準備發佈配置檔,以供在 Azure Pipelines 內執行的部署程式使用。 發佈設定檔應設定為以您先前建立的叢集為目標。 啟動 Visual Studio 並開啟現有的 Service Fabric 應用程式專案。 在 [方案總管] 中,以滑鼠右鍵按一下應用程式,然後選取 [發佈]。

在您的應用程式專案中選擇要使用於持續整合工作流程的目標設定檔,例如雲端。 指定叢集連線端點。 選取 [升級應用程式] 複選框,讓您的應用程式針對 Azure DevOps 中的每個部署進行升級。 選取 儲存設定檔 連結以將設定儲存至發佈設定檔,然後選取 取消 以關閉對話方塊。

顯示推送設定檔以發佈應用程式的螢幕擷取畫面。

將您的 Visual Studio 解決方案共用至新的 Azure DevOps Git 存放庫

將您的應用程式來源檔案共用至 Azure DevOps 中的專案,以便產生組建。

若要在 Visual Studio 2022 中建立 新的 GitHub 存放庫和 Azure DevOps 存放庫 ,請在 [Git] 功能表上選取 [ Git>建立 Git 存放庫 ]。

選取您的帳戶,然後輸入您的存放庫名稱。 選擇 建立並推送

顯示建立新 Git 存放庫的螢幕擷取畫面。

發佈存放庫會在 Azure DevOps Services 帳戶中建立與本機存放庫名稱相同的新專案。

若要檢視新建立的儲存庫,請移至 https://dev.azure.com/><organizationname>。 將滑鼠停留在專案名稱上,然後選取 Repos 圖示。

使用 Azure Pipelines 設定持續傳遞

Azure Pipelines 組建管線描述具有一組循序執行的組建步驟的工作流程。 若要部署至 Service Fabric 叢集,請建立產生 Service Fabric 應用程式套件和其他成品的建置管線。 深入瞭解 Azure Pipelines 建置管線

Azure Pipelines 發行管線描述將應用程式套件部署至叢集的工作流程。 搭配使用時,建置管線和發行管線會執行整個工作流程,從來源檔案開始,到叢集中執行中的應用程式結束。 瞭解更多關於 Azure Pipelines 發行管線 的資訊。

建立組建管線

開啟網頁瀏覽器,然後前往您在 https://dev.azure.com/<organization-name>/VotingSample 的新專案。

選取 [管線] 索引標籤,然後選取 [建立管線]。

顯示建立新管線的螢幕擷取畫面。

選取 [ 使用傳統編輯器 來建立管線,而不使用 YAML]。

顯示使用傳統編輯器建立管線的螢幕擷取畫面。

針對來源,選取 [Azure Repos Git]。 針對 Team 專案,選取 VotingSample。 針對 存放庫,選取 VotingApplication。 保留手動和排程組建的預設分支。 然後選取 [ 繼續]。

螢幕擷取畫面,顯示在 Azure DevOps 中選取存放庫。

在 [ 選取範本] 中,選取 Azure Service Fabric 應用程式 範本,然後選取 [套用]。

顯示選取和建置範本的螢幕擷取畫面。

[工作] 中,為 [代理程式集區] 輸入 Azure Pipelines。 針對 代理程式規格,輸入 windows-2022

顯示選取任務的螢幕擷取畫面。

觸發器 下,選取 啟用持續整合 核取方塊。 在 Branch 篩選器中, Branch 規格 預設為 master。 選取 [儲存並排入佇列] 以手動啟動組建。

顯示選取觸發器的截圖。

推送或簽入時也會觸發組建。 若要檢查您的建置進度,請選取 [建置 ] 索引標籤。確認組建成功執行之後,請定義將應用程式部署至叢集的發行管線。

建立發行管線

選取 [管線] 索引標籤,然後選取 [發行]>新管線。 在 [選取範本] 上,選取 [Azure Service Fabric 部署] 範本,然後選取 [套用]。

顯示選取發行範本的螢幕擷取畫面。

選取 [新增任務]> 以新增叢集連線。

顯示新增叢集連線的螢幕擷取畫面。

[新增 Service Fabric 連線] 上,選取 [憑證型][Microsoft Entra 認證驗證]。 指定叢集 tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000 端點 (或您要部署之叢集的端點)。

針對憑證式驗證,請新增用來建立叢集的伺服器憑證的伺服器憑證的伺服器憑證指紋。 在 [用戶端憑證] 中,新增用戶端憑證檔案的 base-64 編碼。 請參閱該欄位的說明資訊,以瞭解如何取得憑證的 base-64 編碼表示法。 此外,請新增憑證的密碼。 如果您沒有個別的用戶端憑證,則可以使用叢集憑證或伺服器憑證。

針對 Microsoft Entra 認證,請新增 伺服器憑證指紋的值。 請使用您用來建立叢集的伺服器憑證,並在 使用者名稱密碼 輸入您要用來連線至叢集的認證。

選取 [儲存]。

接著,將組建成品新增至管線,讓發行管線可以找到建置的輸出。 選取 [管線]>[成品]>[新增]。 在 [ 來源 (建置定義)] 中,選取您稍早建立的建置管線。 選取 [ 新增 ] 以儲存建置成品。

顯示新增成品的螢幕擷取畫面。

啟用持續部署觸發程序,以便在建置完成時自動建立版本。 選取成品中的閃電圖示,啟用觸發程序,然後選取 [儲存] 以儲存發行管線。

顯示啟用觸發器的螢幕擷取畫面。

選取 建立發行版>建立 來手動建立發行版。 若要監視發行進度,請選取 [發行] 索引標籤。

確認部署成功,以及應用程式是否在叢集中執行。 開啟網頁瀏覽器並移至 https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/。 請注意應用程式版本。 在此範例中為 1.0.0.20170616.3

認可並推送變更以觸發發行程序

若要確認持續整合管線是否正常運作,請提交一些程式碼變更到 Azure DevOps。

當您撰寫程式碼時,Visual Studio 會在 [Git 變更] 窗格的 [變更] 區段中追蹤專案的檔案變更。

[變更] 上,輸入訊息來描述您的更新,然後認可您的變更。

顯示認可最新變更的螢幕擷取畫面。

[Git 變更] 上,選取 [推送 ] (向上箭號) 以更新 Azure Pipelines 中的程式代碼。

顯示推送選項的螢幕擷取畫面。

將變更推送至 Azure Pipelines 會觸發組建。 若要檢查建置進度,請在應用程式中選取 Pipeline 索引標籤。

建置完成時,會自動建立版本,並開始升級叢集上的應用程式。

確認部署成功,以及應用程式是否在叢集中執行。 開啟網頁瀏覽器並移至 https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/。 請注意應用程式版本。 在此範例中為 1.0.0.20170815.3

此螢幕擷取畫面顯示在瀏覽器中執行的 Service Fabric Explorer 中的投票應用程式,其中醒目提示了應用程式版本。

更新應用程式

在應用程式中進行程式碼變更。 儲存並提交變更。

當應用程式升級開始時,您可以在 Service Fabric 總管中追蹤升級進度:

螢幕擷取畫面顯示在瀏覽器中執行的 Service Fabric Explorer 中的投票應用程式,並且狀態訊息被標示出來。

應用程式升級可能需要幾分鐘的時間。 升級完成後,應用程式正在執行下一個版本。 在此範例中,它正在執行版本 1.0.0.20170815.4

螢幕擷取畫面顯示在瀏覽器中執行的 Service Fabric Explorer 中的投票應用程式,已將更新的應用程式版本標示出來。

後續步驟

前進到下一個教學課程: