Come specificare tramite parametri il numero di porta di un servizio in Service Fabric

Questo articolo illustra come specificare tramite parametri il numero di porta di un servizio in Service Fabric usando Visual Studio.

Procedura per specificare tramite parametri il numero di porta di un servizio

In questo esempio si imposta il numero di porta per un'API Web ASP.NET Core usando un parametro.

1. Aprire Visual Studio e creare una nuova applicazione di Service Fabric.

2. Scegliere il modello ASP.NET Core senza stato.

3. Scegliere API Web.

4. Aprire il file ServiceManifest.xml.

5. Prendere nota del nome dell'endpoint specificato per il servizio. Il valore predefinito è ServiceEndpoint.

6. Aprire il file ApplicationManifest.xml.

7. Nell'elemento ServiceManifestImport aggiungere un nuovo elemento RessourceOverrides con un riferimento all'endpoint nel file ServiceManifest.xml.

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

8. Nell'elemento Endpoint è ora possibile eseguire l'override di qualsiasi attributo usando un parametro. In questo esempio specificare Port e impostare l'attributo su un nome di parametro usando le parentesi quadre, ad esempio [MyWebAPI_PortNumber].

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

9. Sempre nel file ApplicationManifest.xml specificare quindi il parametro nell'elemento Parameters.

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

10. Definire DefaultValue.

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

11. Aprire la cartella ApplicationParameters e il file Cloud.xml.

12. Per specificare una porta diversa da usare per la pubblicazione in un cluster remoto, aggiungere al file il parametro con il numero di porta.

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

Quando si pubblica l'applicazione da Visual Studio usando il profilo di pubblicazione Cloud.xml, il servizio è configurato per l'uso della porta 80. Se si distribuisce l'applicazione senza specificare il parametro MyWebAPI_PortNumber, il servizio usa la porta 8080.

Passaggi successivi

Per altre informazioni su alcuni dei concetti principali trattati in questo articolo, vedere Gestire le applicazioni per più ambienti.

Per informazioni su altre funzionalità di gestione delle app disponibili in Visual Studio, vedere Usare Visual Studio per semplificare la scrittura e la gestione delle applicazioni di Service Fabric.