Lektion 2: Bereitstellen des HRApplicationServices-Workflowdiensts

Artikel
03/05/2012

Lernziel: Erlernen, wie die Bereitstellungseinstellungen für ein Workflowdienstprojekt in Visual Studio festgelegt werden, und Erstellen des Bereitstellungspakets (einer ZIP-Datei). Anschließendes Verwenden des IIS-Verwaltungstools (Internet Information Services, Internetinformationsdienste) zum Bereitstellen des Pakets unter IIS.

Zweck: Bereitstellen einer Anwendung, die WCF- und/oder WF-Dienste umfasst.

Voraussetzungen

Beachten Sie die folgenden Anforderungen, bevor Sie mit dieser Übungseinheit beginnen:

Sie müssen AppFabric installieren und konfigurieren. Weitere Informationen finden Sie unter Lektion 1: Erste Schritte.
Sie müssen die Lernprogrammdateien installieren. Weitere Informationen finden Sie unter Lektion 1: Erste Schritte.

Erstellen eines Bereitstellungspakets

So legen Sie Bereitstellungswerte in Visual Studio fest

Öffnen Sie Visual Studio 2010, und führen Sie die Anwendung dann als Administrator aus. Klicken Sie im Startmenü auf Alle Programme, öffnen Sie Visual Studio 2010, klicken Sie mit der rechten Maustaste auf Microsoft Visual Studio 2010, und klicken Sie dann auf Als Administrator ausführen.
Erstellen Sie das Projekt. Klicken Sie im Menü Erstellen auf Projektmappe erstellen, oder drücken Sie F6.
Erweitern Sie den Knoten HRApplicationServices. Dieser Knoten enthält den Workflowdienst, den Sie bereitstellen.
Erweitern Sie den Knoten Web.config. Beachten Sie, dass zwei Unterknoten vorhanden sind: Web.Debug.config und Web.Release.config.

Öffnen Sie die Datei Web.Release.config, und untersuchen Sie deren Inhalt. Die Standarddatei enthält nur vier Elemente: <xml>, <configuration>, <system.web> und <compiliation>. Die fertig gestellte Konfigurationsdatei enthält jedoch den folgenden Code:

<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>

Beachten Sie das Element <appSettings>.

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

Wenn die Bereitstellung mithilfe von MSDeploy erfolgt, weist die Transformation den MSBuild-Prozess an, den Knoten BaseURI im XML-Element <appSettings> zu ermitteln und dann den Attributwert durch den hier definierten Wert zu ersetzen: https://localhost/HRApplicationServices.

Wenn das Projekt und die Konfigurationsdatei erstellt werden, wird die folgende Zeile der transformierten Datei web.config hinzugefügt:

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

Die Konfiguration enthält außerdem das Element <system.ServiceModel>, das die WCF-Werte (Windows Communication Foundation) definiert, die zum Herstellen einer Verbindung mit dem Dienst erforderlich sind. Der Abschnitt stellt also zusammengefasst die Adress-, Bindungs- und Kontraktinformationen für den Dienst zur Verfügung. Weitere Informationen finden Sie unter Konfigurieren von Diensten mithilfe von Konfigurationsdateien.
Schalten Sie die Konfiguration auf der Visual Studio-Symbolleiste von Debuggen in Freigabe um.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe HRApplicationServices, und klicken Sie dann auf Einstellungen packen/veröffentlichen. Auf diese Weise wird der Abschnitt Web packen/veröffentlichen der Eigenschaftenseite der Projektmappe geöffnet.
Stellen Sie unter Bereitzustellende Elemente (gilt für alle Bereitstellungsmethoden) sicher, dass die Option Nur die zum Ausführen dieser Anwendung erforderlichen Dateien ausgewählt ist.
Stellen Sie unter Einstellungen für Webbereitstellungspaket sicher, dass das Kontrollkästchen Bereitstellungspaket als ZIP-Datei erstellen aktiviert ist.
Kopieren Sie den Speicherort, an dem das Paket erstellt werden soll, in die Zwischenablage. Standardmäßig ist dies der folgende Speicherort:

Obj\Release\Package\<Projektmappenname.zip>
Legen Sie den Namen der IIS-Website/Anwendung fest, der auf dem Zielserver verwendet werden soll.
Speichern Sie alle Dateien in der Projektmappe.

So erstellen Sie das Bereitstellungspaket

Klicken Sie mit der rechten Maustaste auf HRApplicationServices, und klicken Sie dann auf Bereitstellungspaket erstellen. Nachdem die Aktion abgeschlossen ist, sollte Veröffentlichen erfolgreich als Status in der unteren linken Ecke angezeigt werden.

Importieren der Anwendung in IIS

In diesem Abschnitt stellen Sie die Anwendung bereit und bearbeiten die Einstellung Bindungen so, dass AppFabric für die Verwendung des net.pipe-Protokolls für die Kommunikation aktiviert wird.

So importieren Sie die Anwendung HRApplicationServices

Öffnen Sie IIS-Manager, indem Sie auf Start und auf Ausführen klicken, und geben Sie dann inetmgr ein.
Erweitern Sie Server, erweitern Sie Website, und klicken Sie dann mit der rechten Maustaste auf Standardwebsite. Klicken Sie auf Bereitstellen/Importieren, und klicken Sie dann auf Anwendung importieren.
Fügen Sie den Pfad der ZIP-Datei der Anwendung in das Dialogfeld ein.
Im Dialogfeld Anwendungspaket installieren werden die Anwendung und die Datenbank angezeigt. Übernehmen Sie die Standardwerte.
Klicken Sie auf den restlichen Assistentenseiten von Anwendungspaket importieren drei Mal auf Weiter, um die Standardwerte zu verwenden. Wenn Sie gefragt werden, ob diese Anwendung im .NET 4-Standardanwendungspool ausgeführt werden soll, klicken Sie auf Ja.
Die Seite Zusammenfassung stellt eine Übersicht auf hoher Ebene für einige Elemente bereit, die aus dem Paket installiert wurden. Die Registerkarte Details bietet detaillierte Informationen zu den hinzugefügten Komponenten.

Aktivieren des „net.pipe“-Protokolls

AppFabric installiert einen Workflowverwaltungsdienst (Workflow Management Service, WMS), der mit dem Workflowpersistenzspeicher zusammenarbeitet, um Zuverlässigkeit und Instanzsteuerung bereitzustellen. WMS kommuniziert mithilfe des net.pipe-Protokolls mit dem Workflowdienst. Dieses Protokoll muss daher für die Anwendung aktiviert sein.

So aktivieren Sie die „net.pipe“-Bindung

Klicken Sie in IIS-Manager mit der rechten Maustaste auf Standardwebsite, und klicken Sie dann auf Bindungen bearbeiten.
Suchen Sie in der Liste nach net.pipe mit einem Sternchen (*) als Bindungsinformationen. Gehen Sie folgendermaßen vor, wenn diese Angabe nicht vorhanden ist.
1. Klicken Sie auf die Schaltfläche Hinzufügen.
2. Wählen Sie im Dialogfeld Sitebindung hinzufügen die Option net.pipe aus.
3. Geben Sie im Feld Bindungsinformationen ein Sternchen (*) ein.

Schritte dieser Übungseinheit

In dieser Übungseinheit haben Sie die Bereitstellungseinstellungen in Visual Studio festgelegt und dann ein Bereitstellungspaket erstellt. Außerdem haben Sie die Anwendung bereitgestellt, indem Sie das Paket in IIS-Manager importiert haben. Schließlich haben Sie AppFabric für die Kommunikation mit Ihrer Anwendung mithilfe des net.pipe-Protokolls aktiviert.

Weitere Schritte

Lesen Sie Lektion 3: Konfigurieren der Anwendung HRApplicationServices, um AppFabric für Überwachung und Persistenz zu konfigurieren.

Siehe auch

Konzepte

Lektion 1: Erste Schritte
Lektion 3: Konfigurieren der Anwendung HRApplicationServices
Lektion 4: Überwachen der Integrität der Anwendung HRApplicationServices
Lektion 5: Fortsetzen eines angehaltenen Workflows mithilfe von AppFabric

Weitere Ressourcen

Lesson 6: Monitoring the Order Service for Exceptions

2012-03-05

Freigeben über