Como especificar o número da porta de um serviço usando parâmetros no Service Fabric

Este artigo mostra como especificar o número da porta de um serviço usando os parâmetros no Service Fabric usando o Visual Studio.

Procedimento para especificar o número da porta de um serviço usando parâmetros

Neste exemplo, você poderá definir o número da porta para a API Web do asp.net core usando um parâmetro.

1. Abra o Visual Studio e crie um novo aplicativo do Service Fabric.

2. Escolha o modelo do ASP.NET Core sem monitoração de estado.

3. Escolha a API Web.

4. Abra o arquivo ServiceManifest.xml.

5. Observe o nome do ponto de extremidade especificado para o serviço. O padrão é ServiceEndpoint.

6. Abra o arquivo ApplicationManifest.xml

7. No elemento ServiceManifestImport, adicione um novo elemento RessourceOverrides com uma referência para o ponto de extremidade no arquivo ServiceManifest.xml.

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

8. No elemento Endpoint, agora você pode substituir qualquer atributo usando um parâmetro. Neste exemplo, você deverá especificar Port e defini-lo como um nome de parâmetro usando colchetes – por exemplo,[MyWebAPI_PortNumber]

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

9. Ainda no arquivo ApplicationManifest.xml, especifique o parâmetro no elemento Parameters

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

10. E defina um DefaultValue

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

11. Abra a pasta ApplicationParameters e o arquivo Cloud.xml

12. Para especificar uma porta diferente a ser usada ao publicar em um cluster remoto, adicione o parâmetro com o número da porta a esse arquivo.

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

Ao publicar seu aplicativo do Visual Studio usando o perfil de publicação Cloud.xml, o serviço será configurado para usar a porta 80. Se você implantar o aplicativo sem especificar o parâmetro MyWebAPI_PortNumber, o serviço usará a porta 8080.

Próximas etapas

Para saber mais sobre alguns dos principais conceitos que são discutidos neste artigo, veja os artigos sobre Gerenciar aplicativos de vários ambientes.

Para obter informações sobre outras funcionalidades de gerenciamento de aplicativo disponíveis no Visual Studio, confira Gerenciar seus aplicativos do Service Fabric no Visual Studio.