在 Azure Service Fabric 上裝載 Node.js 應用程式

發行項
06/01/2023

本快速入門可協助您將現有的應用程式 (在此範例中為 Node.js) 部署到在 Azure 上執行的 Service Fabric 叢集。

必要條件

開始使用之前，請先確定您已設定開發環境，包括安裝 Service Fabric SDK 和 Visual Studio 2019 或 2015。

您也需有現有的 Node.js 應用程式可供部署。此快速入門使用可在這裡下載的簡單 Node.js 網站。在下一個步驟中建立專案之後，請將此檔案解壓縮至 <path-to-project>\ApplicationPackageRoot\<package-name>\Code\ 資料夾。

如果您沒有 Azure 訂閱，請建立免費帳戶。

建立服務

以系統管理員身分啟動 Visual Studio。

使用 CTRL+SHIFT+N 建立專案

在 [新增專案] 對話方塊中，選擇 [雲端] > [Service Fabric 應用程式]。

將應用程式命名為 MyGuestApp，然後按 [建立]。

重要

Node.js 可以輕易打破 Windows 具有之路徑的 260 字元限制。對專案本身使用短路徑，例如 c:\code\svc1。選擇性地，您可以依照這些指示在 Windows 10 中啟用完整檔案路徑。

New project dialog in Visual Studio

您可以從下一個對話方塊建立任何類型的 Service Fabric 服務。在本快速入門中，選擇 [來賓可執行檔]。

將服務命名為 MyGuestService 並設定下列值右邊的選項：

設定	值
程式碼封裝資料夾	<包含 Node.js 應用程式的資料夾>
程式碼封裝行為	將資料夾內容複製到專案
程式	node.exe
引數	server.js
工作資料夾	CodePackage

按 [確定]。

New service dialog in Visual Studio

Visual Studio 會建立應用程式專案和動作項目服務專案，並在 [方案總管] 中加以顯示。

應用程式專案 (MyGuestApp) 不直接包含任何程式碼。此專案會參考一組服務專案。此外，其會包含三種其他類型的內容：

發佈設定檔
用來管理不同環境的工具喜好設定。
指令碼
包含用來部署/升級應用程式的 PowerShell 指令碼。
應用程式定義
包含 ApplicationPackageRoot 下的應用程式資訊清單。相關聯的應用程式參數檔案位於 ApplicationParameters下方，它們可以定義應用程式，讓您得以特別為指定的環境設定應用程式。

如需服務專案的內容概觀，請參閱開始使用 Reliable Services。

設定網路

我們所部署的範例 Node.js 應用程式會使用連接埠 80，而我們需要告知 Service Fabric 我們必須公開該連接埠。

開啟專案中的 ServiceManifest.xml 檔案。在資訊清單的底部，有已定義一個項目的 <Resources> \ <Endpoints>。修改該項目以新增 Port、Protocol 和 Type。

  <Resources>
    <Endpoints>
      <!-- This endpoint is used by the communication listener to obtain the port on which to 
           listen. Please note that if your service is partitioned, this port is shared with 
           replicas of different partitions that are placed in your code. -->
      <Endpoint Name="MyGuestAppServiceTypeEndpoint" Port="80" Protocol="http" Type="Input" />
    </Endpoints>
  </Resources>

部署至 Azure

如果您按下 F5 並執行專案，其就會部署到本機叢集。不過，讓我們改為將它部署到 Azure。

以滑鼠右鍵按一下專案，然後選擇 [發佈...] 來開啟對話方塊，以發佈至 Azure。

Publish to azure dialog for a service fabric service

選取 PublishProfiles\Cloud.xml 目標設定檔。

如果您先前尚未這樣做，請選擇要部署至的 Azure 帳戶。如果您沒有 Azure 帳戶，請註冊一個。

在 [連線端點] 之下，選取要部署 Service Fabric 叢集的位置。如果您沒有 Service Fabric 叢集，請選取 <建立新的叢集...>，這會在網頁瀏覽器視窗中開啟 Azure 入口網站。如需詳細資訊，請參閱在入口網站中建立叢集。

當您建立 Service Fabric 叢集時，請務必將 [自訂端點] 設定設為 80。

Service fabric node type configuration with custom endpoint

建立新的 Service Fabric 叢集需要一些時間才能完成。建立之後，請回到 [發佈] 對話方塊並選取 <重新整理>。新的叢集會列在下拉式方塊中，請加以選取。

按 [發佈] 並等待部署完成。

這可能需要幾分鐘的時間。完成之後，應用程式可能需要數分鐘的時間才能完全可用。

測試網站

在服務發佈之後，請在網頁瀏覽器中進行測試。

首先，開啟 Azure 入口網站並尋找您的 Service Fabric 服務。

請檢查服務位址的 [概觀] 刀鋒視窗。使用 [用戶端連線端點] 屬性中的網域名稱。例如： http://mysvcfab1.westus2.cloudapp.azure.com 。

Service fabric overview blade on the Azure portal

瀏覽至此位址，您將會在此看到 HELLO WORLD 回應。

選取叢集

請不要忘記刪除您在本快速入門中建立的所有資源，因為您需對那些資源付費。

下一步

深入了解客體可執行檔。