共用方式為


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

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

在本教學課程中,您會了解如何:

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

本教學課程系列說明如何:

必要條件

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

下載投票應用程式範例

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

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

下載發行設定檔

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

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

顯示推送配置檔以發佈應用程式的螢幕快照。

向新的 Azure DevOps Git 儲存機制共用 Visual Studio 解決方案

將應用程式來源檔案共用至 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

顯示選取工作的螢幕快照。

在 [觸發程式]下,選取 [啟用持續整合] 複選框。 在 [分支篩選] 中,[ 分支] 規格 預設為 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 會觸發組建。 若要檢查您的建置進度,請在 上的https://dev.azure.com/organizationname/VotingSample應用程式中選取 [管線] 索引標籤。

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

確認部署成功,且應用程式正在叢集中執行。 開啟網頁瀏覽器,然後前往 https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/。 記下應用程式版本。 在此範例中為 1.0.0.20170815.3

此螢幕快照顯示在瀏覽器中執行的 Service Fabric Explorer 中投票應用程式,其中已醒目提示應用程式版本。

更新應用程式

在應用程式中進行程式碼變更。 儲存並認可變更。

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

顯示在瀏覽器中執行的 Service Fabric Explorer 中投票應用程式的螢幕快照,其中已醒目提示狀態消息。

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

此螢幕快照顯示在瀏覽器中執行的 Service Fabric Explorer 中投票應用程式,其中已醒目提示已更新的應用程式版本。

後續步驟

前進到下一個教學課程: