Leçon 2 : déploiement du service de flux de travail HRApplicationServices

Article
03/05/2012

Objectif : apprendre à définir les paramètres de déploiement d'un projet de service de flux de travail dans Visual Studio et à créer le package de déploiement (fichier *.zip). Utiliser ensuite l'outil Gestionnaire des services Internet (IIS) pour déployer le package sous IIS.

Fonction : déployer une application incluant des services WCF et/ou WF.

Configuration préalable

Les conditions suivantes sont requises avant de commencer cette leçon :

Vous devez installer et configurer AppFabric. Pour plus d'informations, consultez la rubrique Leçon 1 : mise en route.
Vous devez installer les fichiers du didacticiel. Pour plus d'informations, consultez la rubrique Leçon 1 : mise en route.

Création d'un package de déploiement

Pour définir les valeurs de déploiement dans Visual Studio

Ouvrez Visual Studio 2010 et exécutez-le en tant qu'administrateur. Dans le menu Démarrer, cliquez sur Tous les programmes, ouvrez le dossier Visual Studio 2010, cliquez avec le bouton droit sur Microsoft Visual Studio 2010, puis cliquez sur Exécuter en tant qu'administrateur.
Générez la solution. Dans le menu Générer, cliquez sur Générer la solution ou appuyez sur F6.
Développez le nœud HRApplicationServices. Celui-ci contient le service de flux de travail que vous allez déployer.
Développez le nœud Web.config. Deux sous-nœuds existent : Web.Debug.config et Web.Release.config.

Ouvrez le fichier Web.Release.config et examinez-en le contenu. Le fichier par défaut ne contient que quatre éléments : <xml>, <configuration>, <system.web> et <compiliation>. Le fichier de configuration complet contient le code suivant :

<configuration xmlns:xdt=
       "https://schemas.microsoft.com/XML-Document-Transform">
  <!--Modify the BaseURI key -->
  <appSettings>
    <add key="BaseURI"
         value="https://localhost/HRApplicationServices"
         xdt:Transform="SetAttributes(value)"
         xdt:Locator="Match(key)"/>    
  </appSettings>
  <system.serviceModel>
    <client>
      <!--Modify the endpoint addresses for production -->
      <endpoint
        address="https://localhost/HRApplicationServices/SubmitApplication.xamlx"
        binding="basicHttpBinding"
        bindingConfiguration="BasicHttpBinding_IApplicationService"
        contract="IApplicationService"
        name="BasicHttpBinding_IApplicationService"
        xdt:Transform="SetAttributes(address)" xdt:Locator="Match(name)"/>
    </client>
  </system.serviceModel>
  <system.web>
    <compilation xdt:Transform="RemoveAttributes(debug)" />
  </system.web>  
</configuration>

Remarquez la présence de l'élément <appSettings>.

<appSettings>
    <add key="BaseURI"
         value="https://localhost/HRApplicationServices"
         xdt:Transform="SetAttributes(value)"
         xdt:Locator="Match(key)"/>    
  </appSettings>

Une fois déployé via MSDeploy, le fichier de transformation demande au processus MSBuild de localiser le nœud BaseURI dans l'élément XML <appSettings> et remplace la valeur d'attribut par celle définie ici : https://localhost/HRApplicationServices

Une fois le projet généré et le fichier de configuration créé, la ligne suivante apparaît dans le fichier web.config de transformation :

<appSettings>
    <add key="BaseURI" value="https://localhost/HRApplicationServices" />
  </appSettings>

La configuration inclut également l'élément <system.ServiceModel> qui définit les valeurs WCF (Windows Communication Foundation) requises pour la connexion au service. En bref, la section fournit les informations d'adresse, de liaison et de contrat du service. Pour plus d'informations, consultez la rubrique Configuration des services à l'aide des fichiers de configuration.
Dans la barre d'outils de Visual Studio, basculez la configuration de Débogage à Version finale.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet HRApplicationServices, puis cliquez sur Paramètres de package/publication. Ceci permet d'ouvrir la section Package/Publication Web de la page des propriétés du projet.
Sous Éléments à déployer (s'applique à toutes les méthodes de déploiement), vérifiez que l'option Uniquement les fichiers nécessaires à l'exécution de cette application est sélectionnée.
Sous Paramètres du package de déploiement Web, vérifiez que l'option Créer un package de déploiement en tant que fichier zip est sélectionnée.
Copiez l'emplacement de création du package dans le Presse-papiers. Par défaut, il s'agit de l'emplacement suivant :

Obj\Release\Package\<nom_solution.zip>
Définissez le nom de site Web IIS/d'application à utiliser sur le serveur de destination.
Enregistrez tous les fichiers dans la solution.

Pour créer le package de déploiement

Cliquez avec le bouton droit sur HRApplicationServices, puis cliquez sur Générer un package de déploiement. Une fois l'action terminée, le statut Publication réussie doit apparaître dans le coin gauche inférieur.

Importation de l'application dans IIS

Dans cette section, vous allez déployer l'application et modifier le paramètre Liaisons pour permettre à AppFabric d'utiliser le protocole net.pipe pour la communication.

Pour importer l'application HRApplicationServices

Ouvrez le Gestionnaire des services Internet en cliquant sur Démarrer > Exécuter, puis en tapant inetmgr.
Développez le nœud Serveur, puis Sites, puis cliquez avec le bouton droit sur Site Web par défaut. Cliquez sur Déployer/Importer, puis sur Importer l'application.
Collez le chemin d'accès au fichier .zip de l'application dans la boîte de dialogue.
La boîte de dialogue Installer un package d'application affiche l'application et la base de données. Acceptez les valeurs par défaut.
Cliquez sur Suivant à trois reprises pour utiliser les valeurs par défaut dans les pages restantes de l'Assistant Importer un package d'application. Lorsque vous êtes invité à exécuter cette application dans le pool d'applications .NET 4 par défaut, cliquez sur Oui.
La page Résumé donne une vue d'ensemble de haut niveau de certains éléments installés à partir du package. L'onglet Détails donne des informations sur les éléments ajoutés.

Activation du protocole net.pipe

AppFabric installe un service de gestion du flux de travail qui fonctionne avec le magasin de persistance des flux de travail pour garantir la fiabilité et le contrôle des instances. Ce service communique avec le service de flux de travail via le protocole net.pipe. Ce protocole doit donc être activé sur l'application.

Pour activer la liaison net.pipe

Dans le Gestionnaire des services Internet, cliquez avec le bouton droit sur Site Web par défaut, puis cliquez sur Modifier les liaisons….
Dans la liste, recherchez la valeur net.pipe avec un astérisque (*) pour consulter les informations sur la liaison. Si la liaison n'est pas présente :
1. Cliquez sur le bouton Ajouter.
2. Dans la boîte de dialogue Ajouter la liaison de site, sélectionnez net.pipe.
3. Dans la zone Informations sur la liaison, entrez un astérisque (*).

Actions effectuées

Au cours de cette leçon, vous avez défini les paramètres de déploiement dans Visual Studio, puis créé un package de déploiement. Vous avez également déployé l'application en important le package dans le Gestionnaire des services Internet. Enfin, vous avez activé la communication entre AppFabric et votre application via le protocole net.pipe.

Étapes suivantes

Passer à la Leçon 3 : configuration de l'application HRApplicationServices pour configurer AppFabric pour la surveillance et la persistance.

Voir aussi

Concepts

Leçon 1 : mise en route
Leçon 3 : configuration de l'application HRApplicationServices
Leçon 4 : surveillance du fonctionnement de l'application HRApplicationServices
Leçon 5 : reprise d'un flux de travail interrompu à l'aide d'AppFabric

Autres ressources

Leçon 6 : surveillance des exceptions de l'application Order Service

2012-03-05

Partage via