Share via


如何在 Service Fabric 中使用參數指定服務的連接埠號碼

本文會示範如何使用 Visual Studio,在 Service Fabric 中使用參數指定服務的連接埠號碼。

使用參數指定服務的連接埠號碼的程序

在此範例中,您會使用參數設定您的 ASP.NET Core Web API 的連接埠號碼。

  1. 開啟 Visual Studio 並建立一個新的 Service Fabric 應用程式。

  2. 選擇無狀態的 ASP.NET Core 範本。

  3. 選擇 Web API。

  4. 開啟 ServiceManifest.xml 檔案。

  5. 請注意針對您的服務所指定的端點名稱。 預設值為 ServiceEndpoint

  6. 開啟 ApplicationManifest.xml 檔案

  7. ServiceManifestImport 元素中,新增新的 RessourceOverrides 元素與您的 ServiceManifest.xml 檔案中端點的參考。

      <ServiceManifestImport>
        <ServiceManifestRef ServiceManifestName="Web1Pkg" ServiceManifestVersion="1.0.0" />
        <ResourceOverrides>
          <Endpoints>
            <Endpoint Name="ServiceEndpoint"/>
          </Endpoints>
        </ResourceOverrides>
        <ConfigOverrides />
      </ServiceManifestImport>
    
  8. Endpoint 元素中,您現在可以使用參數覆寫任何屬性。 在此範例中,您可以指定 Port,並使用方括號將它設為參數名稱 - 例如,[MyWebAPI_PortNumber]

      <ServiceManifestImport>
        <ServiceManifestRef ServiceManifestName="Web1Pkg" ServiceManifestVersion="1.0.0" />
        <ResourceOverrides>
          <Endpoints>
            <Endpoint Name="ServiceEndpoint" Port="[MyWebAPI_PortNumber]"/>
          </Endpoints>
        </ResourceOverrides>
        <ConfigOverrides />
      </ServiceManifestImport>
    
  9. 仍舊在 ApplicationManifest.xml 檔案中,然後指定 Parameters 元素中的參數

      <Parameters>
        <Parameter Name="MyWebAPI_PortNumber" />
      </Parameters>
    
  10. 並定義 DefaultValue

      <Parameters>
        <Parameter Name="MyWebAPI_PortNumber" DefaultValue="8080" />
      </Parameters>
    
  11. 開啟 ApplicationParameters 資料夾和 Cloud.xml 檔案

  12. 若要指定發行至遠端叢集時要使用不同的通訊埠,將包含連接埠號碼的參數新增到此檔案。

      <Parameters>
        <Parameter Name="MyWebAPI_PortNumber" Value="80" />
      </Parameters>
    

使用 Cloud.xml 發行設定檔從 Visual Studio 發行您的應用程式時,您的服務會設定為使用連接埠 80。 如果部署應用程式未指定 MyWebAPI_PortNumber 參數,則服務會使用連接埠 8080。

下一步

若要深入了解這篇文章所討論的某些核心概念,請參閱管理多個環境發行項的應用程式

如需 Visual Studio 中其他可用的應用程式管理功能的相關資訊,請參閱 在 Visual Studio 中管理 Service Fabric 應用程式