Partage via

Guide pratique pour spécifier le numéro de port d’un service à l’aide de paramètres dans Service Fabric

  • Article

Cet article vous explique comment spécifier le numéro de port d’un service à l’aide de paramètres dans Service Fabric à l’aide de Visual Studio.

Procédure permettant de spécifier le numéro de port d’un service à l’aide de paramètres

Dans cet exemple, vous définissez le numéro de port pour votre API web ASP.NET Core à l’aide d’un paramètre.

  1. Ouvrez Visual Studio et créez une nouvelle application Service Fabric.

  2. Choisissez le modèle ASP.NET Core sans état.

  3. Choisissez l’API Web.

  4. Ouvrez le fichier ServiceManifest.xml.

  5. Notez le nom du point de terminaison spécifié pour votre service. La valeur par défaut est ServiceEndpoint.

  6. Ouvrez le fichier ApplicationManifest.xml

  7. Dans l’élément ServiceManifestImport, ajoutez un nouvel élément RessourceOverrides avec une référence au point de terminaison dans votre fichier ServiceManifest.xml.

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

  8. Dans l’élément Endpoint, vous pouvez désormais remplacer n’importe quel attribut à l’aide d’un paramètre. Dans cet exemple, vous spécifiez Port et lui attribuer un nom de paramètre à l’aide de crochets, par exemple, [MyWebAPI_PortNumber]

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

  9. Toujours dans le fichier ApplicationManifest.xml, spécifiez ensuite le paramètre dans l’élément Parameters

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

  10. Puis définissez un élément DefaultValue

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

  11. Ouvrez le dossier ApplicationParameters et le fichier Cloud.xml

  12. Pour spécifier un autre port à utiliser lors de la publication sur un cluster distant, ajoutez le paramètre avec le numéro de port à ce fichier.

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

Lors de la publication de votre application depuis Visual Studio à l’aide du profil de publication Cloud.xml, votre service est configuré pour utiliser le port 80. Si vous déployez l’application sans spécifier le paramètre MyWebAPI_PortNumber, le service utilise le port 8080.

Étapes suivantes

Pour en savoir plus sur certains des principaux concepts abordés dans cet article, consultez les articles Gérer des applications pour plusieurs environnements.

Pour plus d’informations sur les autres fonctionnalités de gestion d’application disponibles dans Visual Studio, consultez la section Gestion de vos applications de Service Fabric dans Visual Studio.