Verwenden von benutzerdefinierten Manifesten

von Faith A

Diese Kurzanleitung hilft Ihnen beim Erstellen eines benutzerdefinierten Manifests und beim Synchronisieren. Wir synchronisieren eine Website und schließen den Anwendungspool, ein externes Verzeichnis sowie ein Assembly- und COM-Objekt ein, das nicht automatisch für eine Website erfasst wird.

Voraussetzungen

Dieser Leitfaden erfordert die folgenden Voraussetzungen:

• .NET Framework 2.0 SP1 oder höher
• Web-Bereitstellungstool 1.1

Hinweis: Wenn Sie das Webbereitstellungstool noch nicht installiert haben, lesen Sie Web Deploy.

Übersicht über ein Manifest

Ein Manifest ist einfach eine Gruppierung von Anbietern in einer Definitionsdatei. Es ist eine Möglichkeit, mehrere Pfade anzugeben, die in eine Synchronisierung einbezogen werden, z. B. eine Website, einen Anwendungspool und eine Assembly. Sie kann verwendet werden, um mehrere Websites, mehrere Verzeichnisse oder andere Pfade anzugeben.

Hinweis: In diesem Artikel wird gezeigt, wie Sie einen IIS 7- und höher-Website- und Anwendungspool verschieben, aber Sie können auch das Manifest in IIS 6.0 verwenden, um eine IIS 6.0-Website und einen Anwendungspool anzugeben.

Beispielmanifest

<myCustomSite>
    <appHostConfig path="TestWebSite" />
    <appPoolConfig path="TestAppPool" />
    <dirPath path="C:\MyExtraFiles" />
    <gacAssembly path="'System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'" />
    <comObject path="Microsoft.ApplicationHost.AdminManager" />
</myCustomSite>

So erstellen und verwenden Sie ein benutzerdefiniertes Manifest

1. Öffnen Sie den Editor und erstellen Sie eine XML-Datei. Nennen wir es Custom.xml.

2. Kopieren Sie das Beispielmanifest in Custom.xml.

3. Kopieren Sie Custom.xml in Ihr Installationsverzeichnis, %programfiles%\IIS\Microsoft Web Deploy.

4. Erstellen Sie ein Verzeichnis namens "MyExtraFiles" auf Ihrem Laufwerk "C:".

5. Führen Sie den folgenden Befehl aus, um die Objekte im Manifest mit einer Paketdatei (komprimiert) zu synchronisieren:

   msdeploy.exe -verb:sync -source:manifest=Custom.xml -dest:package=c:\CustomPackage.zip > WebDeployPackage.log
   

   Wenn Sie WebDeployPackage.log angeben > , werden die Ergebnisse des Pakets in der Protokolldatei aufgeführt, und Sie können ganz einfach darauf verweisen.

Öffnen Sie das Paket. Du solltest die Website selbst und das zusätzliche Verzeichnis sehen.

Später können Sie das Paket als Quelle verwenden und mit einem Ziel synchronisieren, das von der Manifestdatei angegeben wird (d. h., Sie werden aus dem Paket mit den Anbietern synchronisiert, die in Ihrem Manifest angegeben sind).

Sie können auch einen Synchronisierungsvorgang mit einem Manifest live ausführen, ohne ein Paket zu verwenden. Um mit einem Manifest zu synchronisieren, müssen sowohl die Quell- als auch die Zielargumente eine Manifestdatei angeben.

So synchronisieren Sie eine Website mithilfe eines benutzerdefinierten Manifests

1. Führen Sie den folgenden Befehl aus, um das Manifest mit einem Remoteziel zu synchronisieren. Der Remotecomputer wird durch das Argument "Computername " angegeben.

   msdeploy.exe -verb:sync -source:manifest=custom.xml -dest:manifest=custom.xml,computername=Server1 > webdeploysync.log
   

Zusammenfassung

Sie haben nun ein benutzerdefiniertes Manifest erstellt und für die Synchronisierung verwendet. Sie können das Manifest weiter erweitern, indem Sie alle Anbieterpfade hinzufügen, die für Ihre Website oder Ihren Server wichtig sind, z. B. einen Registrierungsschlüssel oder eine Assembly im GAC. Weitere Informationen zum Manifestanbieter finden Sie unter Web Deploy Manifest Provider.