Cómo especificar el número de puerto de un servicio mediante parámetros en Service Fabric

Este artículo muestra cómo especificar el número de puerto de un servicio mediante parámetros en Service Fabric con Visual Studio.

Procedimiento para especificar el número de puerto de un servicio mediante parámetros

En este ejemplo se establece el número de puerto de la API web de ASP.NET Core usando un parámetro.

1. Abra Visual Studio y cree una nueva aplicación de Service Fabric.

2. Elija la plantilla de ASP.NET Core sin estado.

3. Elija Web API.

4. Abra el archivo ServiceManifest.xml.

5. Tome nota del nombre del punto de conexión especificado para el servicio. El valor predeterminado es ServiceEndpoint.

6. Abra el archivo ApplicationManifest.xml

7. En el elemento ServiceManifestImport, agregue un nuevo elemento RessourceOverrides con una referencia al punto de conexión en el archivo ServiceManifest.xml.

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

8. En el elemento Endpoint, ahora puede invalidar cualquier atributo mediante un parámetro. En este ejemplo, especifique Port y establézcalo en un nombre de parámetro utilizando corchetes: por ejemplo, [MyWebAPI_PortNumber]

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

9. Todavía en el archivo ApplicationManifest.xml, a continuación, especifique el parámetro en el elemento Parameters

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

10. Y defina un DefaultValue

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

11. Abra la carpeta ApplicationParameters y el archivo Cloud.xml

12. Para especificar un puerto diferente que se usará al publicar en un clúster remoto, agregue el parámetro con el número de puerto en este archivo.

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

Al publicar la aplicación desde Visual Studio con el perfil de publicación Cloud.xml, el servicio está configurado para utilizar el puerto 80. Si implementa la aplicación sin especificar el parámetro MyWebAPI_PortNumber, el servicio utiliza el puerto 8080.

Pasos siguientes

Para más información sobre algunos de los conceptos principales que se describen en este artículo, consulte los artículos de Administración de aplicaciones para varios entornos.

Para obtener más información sobre otras funcionalidades de administración de aplicaciones disponibles en Visual Studio, vea Administración de aplicaciones de Service Fabric en Visual Studio.