Guide pratique pour spécifier des variables d’environnement pour des services dans Service Fabric

Cet article vous explique comment spécifier des variables d’environnement pour un service ou un conteneur dans Service Fabric.

Procédure permettant de spécifier des variables d’environnement pour des services

Dans cet exemple, vous définissez une variable d’environnement pour un conteneur. Cet article suppose que vous disposez déjà d’un manifeste d’application et de service.

  1. Ouvrez le fichier ServiceManifest.xml.

  2. Dans l’élément CodePackage, ajoutez un nouveau élément EnvironmentVariables et un élément EnvironmentVariable pour chaque variable d’environnement.

    <CodePackage Name="MyCode" Version="CodeVersion1">
            ...
            <EnvironmentVariables>
                  <EnvironmentVariable Name="MyEnvVariable" Value="DefaultValue"/>
                  <EnvironmentVariable Name="HttpGatewayPort" Value="19080"/>
            </EnvironmentVariables>
    </CodePackage>
    

    Les variables d’environnement peuvent être remplacées dans le manifeste de l’application.

  3. Pour remplacer les variables d’environnement dans le manifeste de l’application, utilisez l’élément EnvironmentOverrides.

      <ServiceManifestImport>
        <ServiceManifestRef ServiceManifestName="Guest1Pkg" ServiceManifestVersion="1.0.0" />
        <EnvironmentOverrides CodePackageRef="MyCode">
          <EnvironmentVariable Name="MyEnvVariable" Value="OverrideValue"/>
        </EnvironmentOverrides>
      </ServiceManifestImport>
    

Spécification de variables d’environnement dynamiques à l’aide de Docker Compose

Service Fabric prend en charge la possibilité d’utiliser Docker Compose pour le déploiement. Les fichiers Compose peuvent approvisionner les variables d’environnement à partir de l’interpréteur de commandes. Ce comportement peut être utilisé pour remplacer dynamiquement les valeurs d’environnement souhaitées :

environment:
  - "hostname:${hostname}"

Étapes suivantes

Pour en savoir plus sur certains des concepts de base abordés dans cet article, consultez la Gérer les 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.