Exemplarische Vorgehensweise: Bereitstellen eines Webanwendungsprojekts mit einem Webbereitstellungspaket (Teil 4 von 4)

Artikel
10/15/2014

Dies ist die vierte in einer Reihe von exemplarischen Vorgehensweisen, in denen die Bereitstellung eines Webanwendungsprojekts mit einem Webbereitstellungspaket erörtert wird. Weitere Informationen über die Reihe finden Sie unter Exemplarische Vorgehensweise: Bereitstellen eines Webanwendungsprojekts mit einem Webbereitstellungspaket (Teil 1 von 4).

In dieser exemplarischen Vorgehensweise verwenden Sie das Paket, das Sie in der dritten exemplarischen Vorgehensweise erstellt haben, um die Webanwendung auf einem Remotecomputer zu installieren. In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Installieren eines Pakets auf einem Remotecomputer mithilfe der Datei deploy.cmd.
Verwendung von benutzerdefinierten Bereitstellungsparametern für Konfigurationswerte, die beim Installieren des Pakets änderbar sein sollen.

Vorbereitungsmaßnahmen

Eine Liste der Voraussetzungen finden Sie unter Exemplarische Vorgehensweise: Bereitstellen eines Webanwendungsprojekts mit einem Webbereitstellungspaket (Teil 1 von 4).

Vorbereiten des Zielservers

Wenn der Zielserver von einer anderen Person für Sie eingerichtet wird, gibt sie die zu verwendende Bereitstellungsmethode an. Wenn Sie den Zielserver einrichten, müssen Sie eine Methode auswählen. Die folgenden Methoden sind verfügbar:

Der Webverwaltungsdienst (WMSvc) und der Webbereitstellungshandler.
Der Webbereitstellungs-Agent-Dienst (MsDepSvc).
Die Web DeploytempAgent-Anbietereinstellung.

Weitere Informationen zu diesen Methoden oder Informationen zum Einrichten eines Zielservers für die Verwendung einer dieser Methoden finden Sie unter Gewusst wie: Installieren eines Bereitstellungspakets mit der Datei "deploy.cmd".

Neben der Konfiguration für die ausgewählte Bereitstellungsmethode muss der Zielserver folgende Voraussetzungen erfüllen:

IIS 7 ist aktiviert.
ASP.NET 4 wurde mit IIS 7 registriert.
Ein ASP.NET 4-Anwendungspool, der der Standardwebsite zugewiesen wird.

Der Zielserver sollte eingerichtet werden, bevor Sie mit dieser exemplarischen Vorgehensweise fortfahren.

Festlegen von Bereitstellungsparametern

In der folgenden Prozedur stellen Sie sicher, dass die Datei SetParameters.xml die richtigen Werte enthält. Dies entspricht dem Überprüfen oder Ändern von Parameterwerten, die im Dialogfeld Anwendungspaketinformationen eingeben angezeigt werden, wenn Sie mit IIS-Manager ein Paket installieren.

So ändern Sie die Datei SetParamters.xml

Öffnen Sie das Webanwendungsprojekt, das Sie in der ersten exemplarischen Vorgehensweise in dieser Reihe erstellt haben.
Erweitern Sie in Projektmappen-Explorer den Obj-Ordner, erweitern Sie den Ordner Shared und anschließend den Ordner Package. (In einer vorherigen exemplarischen Vorgehensweise haben Sie den Ordner Debug geöffnet. Stellen Sie sicher, dass Sie dieses Mal den Ordner Release anstelle des Ordners Debug verwenden.)
Öffnen Sie AdventureWorks.SetParameters.xml.

Der XML-Inhalt der Datei ähnelt dem folgenden Beispiel:
```
<parameters>
  <setParameter name="IIS Web Application Name" 
    value="Default Web Site/AdventureWorks" /> 
  <setParameter name="machineKey" value="staging" /> 
  <setParameter name="ApplicationServices-Deployment Connection String"
    value="... " /> 
  <setParameter name="AWLTConnectionString-Deployment Connection String"
    value="..." /> 
  <setParameter name="ApplicationServices-Web.config Connection String" 
    value="..." /> 
  <setParameter name="AWLTConnectionString-Web.config Connection String" 
    value="..." /> 
</parameters>
```
Das setParameter-Element, das machineKey als Wert des name-Attributs besitzt. Das value-Attribut dieses setParameter-Elements ist staging. Dabei handelt es sich um den Standardwert, den Sie in der dritten exemplarischen Vorgehensweise in dieser Reihe für Bereitstellungen auf einem Stagingserver festgelegt haben. Wenn Sie das Paket auf einem Produktionsserver installieren wollten, können Sie das value-Attribut dieses setParameter-Elements für den machineKey-Parameter in einen Produktionswert ändern. Die bereitgestellte Web.config-Datei würde anschließend aktualisiert, damit sie anstelle des Stagingwerts den Produktionswert enthält.

Vorbereiten einer Remoteinstallation mit der Datei Deploy.cmd

In der folgenden Prozedur wird die Ausführung der Datei deploy.cmd durch Öffnen einer Befehlseingabeaufforderung und durch Navigieren zu dem Ordner vorbereitet, der die Datei deploy.cmd beinhaltet.

So bereiten Sie eine Remoteinstallation mit der Datei Deploy.cmd vor

Wählen Sie in Projektmappen-Explorer die Datei AdventureWorks.SetParameters.xml aus.
Notieren Sie im Fenster Eigenschaften den Wert der Eigenschaft Vollständiger Pfad.
Klicken Sie in Windows im Startmenü auf Eingabeaufforderung.
Wechseln Sie zu dem Ordner, der die Datei AdventureWorks.SetParameters.xml enthält.

Im Eingabeaufforderungsfenster kann nun der Befehl eingegeben werden, mit dem die Datei deploy.cmd ausgeführt wird.

Die Syntax für die Datei deploy.cmd unterscheidet sich abhängig von der verwendeten Bereitstellungsmethode. Verwenden Sie die für die ausgewählte Methode geeignete Prozedur.

Die Syntaxbeispiele in den folgenden Abschnitten enthalten die folgenden Platzhalter:

Servername. Ersetzen Sie diesen Platzhalter durch den Namen des Zielservers.
Benutzername und Kennwort. Ersetzen Sie diese Platzhalter ggf. durch die tatsächlichen Anmeldeinformationen, die für die Bereitstellung eingerichtet wurden.

Remoteinstallation mit dem Webbereitstellungshandler

Die folgende Prozedur beschreibt, wie das Paket mit dem Webverwaltungsdienst (WMSvc) und dem Webbereitstellungshandler installiert wird.

So führen Sie Bereitstellungen mit dem Webverwaltungsdienst und dem Webbereitstellungshandler aus

Geben Sie den folgenden Befehl ein, um einen Testlauf der Paketinstallation auszuführen:
```
AdventureWorks.deploy.cmd /t /m:https://ServerName:8172/MSDeploy.axd /u:username /p:password /a:basic
```
Für die Bereitstellung des Webverwaltungsdiensts erhalten Sie in der Regel ein Benutzerkonto für Bereitstellungen.

Mit der t-Option wird der Befehl im Testmodus ausgeführt. So können Sie die Ergebnisse des Befehls vor der eigentlichen Bereitstellung der Anwendung untersuchen.

Hinweis

In bestimmten Szenarien kann es bei Verwendung der t-Option zu einem Fehler bei der Bereitstellung kommen, wohingegen die Bereitstellung mit der y-Option erfolgreich verläuft.Weitere Informationen finden Sie unter FAQ zur Bereitstellung von ASP.NET-Webanwendungsprojekten.)
Wenn die Ausgabe der Testausführung nicht Ihren Erwartungen entspricht, nehmen Sie die erforderlichen Änderungen vor.
Wenn die Ausgabe der Testausführung Ihren Erwartungen entspricht, wiederholen Sie den Befehl, indem Sie das t-Flag (Test) wie im folgenden Beispiel gezeigt durch ein y-Flag (Ja) ersetzen:
```
AdventureWorks.deploy.cmd /y /m:https://ServerName:8172/MSDeploy.axd /u:username /p:password /a:basic
```

Remoteinstallation mit dem Webbereitstellungs-Agent-Dienst

Die folgende Prozedur beschreibt, wie das Paket mit dem Webbereitstellungs-Agent-Dienst (MsDepSvc) installiert wird.

So führen Sie eine Bereitstellung mit dem Webbereitstellungs-Agent-Dienst aus

Geben Sie den folgenden Befehl ein, um einen Testlauf der Paketinstallation auszuführen:
```
AdventureWorks.deploy.cmd /t /m:ServerName
```
Für den Webbereitstellungs-Agent-Dienst verwenden Sie normalerweise Windows-Authentifizierung und geben weder Benutzername noch Kennwort an.

Mit der t-Option wird der Befehl im Testmodus ausgeführt. So können Sie die Ergebnisse des Befehls vor der eigentlichen Bereitstellung der Anwendung untersuchen.

Hinweis

In bestimmten Szenarien kann es bei Verwendung der t-Option zu einem Fehler bei der Bereitstellung kommen, wohingegen die Bereitstellung mit der y-Option erfolgreich verläuft.Weitere Informationen finden Sie unter FAQ zur Bereitstellung von ASP.NET-Webanwendungsprojekten.)
Wenn die Ausgabe der Testausführung nicht Ihren Erwartungen entspricht, nehmen Sie die erforderlichen Änderungen vor.
Wenn die Ausgabe der Testausführung Ihren Erwartungen entspricht, wiederholen Sie den Befehl, indem Sie das t-Flag (Test) wie im folgenden Beispiel gezeigt durch ein y-Flag (Ja) ersetzen:
```
AdventureWorks.deploy.cmd /y /m:ServerName
```

Remoteinstallation mit der tempAgent-Anbietereinstellung

Die folgende Prozedur beschreibt, wie das Paket mit der Web Deploy tempAgent-Anbietereinstellung installiert wird.

So führen Sie mit der tempAgent-Anbietereinstellung für Webbereitstellung Bereitstellungen aus

Geben Sie den folgenden Befehl ein, um einen Testlauf der Paketinstallation auszuführen:
```
AdventureWorks.deploy.cmd /t /m:ServerName /g:true
```
Für die tempAgent-Anbietereinstellung wird normalerweise Windows-Authentifizierung verwendet, und es wird weder Benutzername noch Kennwort angegeben.

Mit der t-Option wird der Befehl im Testmodus ausgeführt. So können Sie die Ergebnisse des Befehls vor der eigentlichen Bereitstellung der Anwendung untersuchen.

Hinweis

In bestimmten Szenarien kann es bei Verwendung der t-Option zu einem Fehler bei der Bereitstellung kommen, wohingegen die Bereitstellung mit der y-Option erfolgreich verläuft.Weitere Informationen finden Sie unter FAQ zur Bereitstellung von ASP.NET-Webanwendungsprojekten.)
Wenn die Ausgabe der Testausführung nicht Ihren Erwartungen entspricht, nehmen Sie die erforderlichen Änderungen vor.
Wenn die Ausgabe der Testausführung Ihren Erwartungen entspricht, wiederholen Sie den Befehl, indem Sie das t-Flag (Test) wie im folgenden Beispiel gezeigt durch ein y-Flag (Ja) ersetzen:
```
AdventureWorks.deploy.cmd /y /m:ServerName /g:true
```

Nächste Schritte

In den ersten zwei exemplarischen Vorgehensweisen in dieser Reihe haben Sie ein Dateisystem-Webanwendungsprojekt für eine IIS-Webanwendung zu Testzwecken auf dem Entwicklungscomputer bereitgestellt. In der dritten exemplarischen Vorgehensweise haben Sie ein Paket für Bereitstellungen auf einem Staging- oder Produktionsserver erstellt. In dieser exemplarischen Vorgehensweise, die die letzte in der Reihe ist, haben Sie das Paket mithilfe der Datei deploy.cmd, die von Visual Studio beim Erstellen des Pakets generiert wird, auf einem Remotecomputer bereitgestellt.

Einige andere typische Szenarien für die Bereitstellung auf Staging- und Produktionsservern schließen folgende Schritte ein:

Verwendung des gleichen Pakets für die Bereitstellung auf mehreren Servern in einer Webfarm, wobei die Datenbankbereitstellung für jede Installation nach der ersten Installation unterdrückt wird.
Verhindern der Bereitstellung von bestimmten Dateien (z. B. Web.config-Dateien), da sie manuell auf dem Zielserver aktualisiert werden und die Änderungen nicht überschrieben werden sollen.
Informationen zum Umgang mit diesen Szenarien finden Sie unter Gewusst wie: Installieren eines Bereitstellungspakets mit der Datei "deploy.cmd".

Siehe auch

Konzepte

Einstieg in die ASP.NET-Bereitstellung

Freigeben über