Angeben der Portnummer eines Diensts mithilfe von Parametern in Service Fabric

In diesem Artikel erfahren Sie, wie Sie mit Visual Studio die Portnummer eines Diensts mithilfe von Parametern in Service Fabric angeben.

Verfahren für die Angabe der Portnummer eines Diensts mit Parametern

In diesem Beispiel legen Sie die Portnummer für Ihre ASP.NET Core-Web-API mithilfe eines Parameters fest.

1. Öffnen Sie Visual Studio, und erstellen Sie eine neue Service Fabric-Anwendung.

2. Wählen Sie die Vorlage „Zustandsloses ASP.NET Core“ aus.

3. Wählen Sie die Web-API aus.

4. Öffnen Sie die Datei „ServiceManifest.xml“.

5. Notieren Sie den Namen des Endpunkts, der für Ihren Dienst angegeben wird. Der Standardwert ist ServiceEndpoint.

6. Öffnen Sie die Datei „ApplicationManifest.xml“.

7. Fügen Sie im ServiceManifestImport-Element ein neues RessourceOverrides-Element mit einem Verweis auf den Endpunkt in der Datei „ServiceManifest.xml“ hinzu.

     <ServiceManifestImport>
       <ServiceManifestRef ServiceManifestName="Web1Pkg" ServiceManifestVersion="1.0.0" />
       <ResourceOverrides>
         <Endpoints>
           <Endpoint Name="ServiceEndpoint"/>
         </Endpoints>
       </ResourceOverrides>
       <ConfigOverrides />
     </ServiceManifestImport>
   

8. Sie können nun im Endpoint-Element alle Attribute mit einem Parameter überschreiben. Geben Sie in diesem Beispiel Port an, und legen Sie als Wert einen Parameternamen mit eckigen Klammern fest – z.B.[MyWebAPI_PortNumber]

     <ServiceManifestImport>
       <ServiceManifestRef ServiceManifestName="Web1Pkg" ServiceManifestVersion="1.0.0" />
       <ResourceOverrides>
         <Endpoints>
           <Endpoint Name="ServiceEndpoint" Port="[MyWebAPI_PortNumber]"/>
         </Endpoints>
       </ResourceOverrides>
       <ConfigOverrides />
     </ServiceManifestImport>
   

9. Geben Sie dann, ebenfalls in der Datei „ApplicationManifest.xml“, den Parameter im Parameters-Element an.

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

10. Definieren Sie nun einen Standardwert (DefaultValue).

      <Parameters>
        <Parameter Name="MyWebAPI_PortNumber" DefaultValue="8080" />
      </Parameters>
    

11. Öffnen Sie den Ordner „ApplicationParameters“ und die Datei Cloud.xml.

12. Um einen anderen Port anzugeben, der beim Veröffentlichen in einem Remotecluster verwendet werden soll, fügen Sie in dieser Datei den Parameter mit der Portnummer hinzu.

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

Wenn Sie Ihre Anwendung aus Visual Studio über das Veröffentlichungsprofil „Cloud.xml“ veröffentlichen, wird Ihr Dienst für die Verwendung von Port 80 konfiguriert. Wenn Sie die Anwendung bereitstellen, ohne den MyWebAPI_PortNumber-Parameter anzugeben, verwendet der Dienst den Port 8080.

Nächste Schritte

Weitere Informationen zu einigen der grundlegenden Konzepte, die in diesem Artikel behandelt werden, finden Sie im Artikel Verwalten von Anwendungen für mehrere Umgebungen.

Informationen zu anderen App-Verwaltungsfunktionen in Visual Studio finden Sie unter Verwalten Ihrer Service Fabric-Anwendungen in Visual Studio.