CreateApp (Anwendungsbereitstellungsbeispiel)

In diesem Thema wird erläutert, wie Sie das CreateApp-Beispiel verwenden, das die Verwendung des BTSTask-Befehlszeilentools zum Bereitstellen und Aufheben der Bereitstellung einer BizTalk-Anwendung veranschaulicht. Sie können Skripts wie die in diesem Beispiel enthaltenen Skripts verwenden, um Ihren nächtlichen Buildprozess zum Bereitstellen und Aufheben der Bereitstellung von BizTalk-Anwendungen zu automatisieren.

Funktionsweise dieses Beispiels

Das Beispiel enthält Skripts, die Anwendungsbereitstellungsaufgaben automatisieren. Um diese Aufgaben auszuführen, führen Sie ein Skript aus, das das BizTalk-Projekt und die Dateien generiert. Anschließend führen Sie ein Skript aus, das zwei BizTalk-Anwendung .msi Dateien generiert– eine .msi Datei, die alle Artefakte in einer Anwendung enthält, und eine andere, die nur eine Assembly in der Anwendung enthält. Als Nächstes führen Sie ein Skript aus, das eine .msi Datei verwendet, um eine Anwendung in eine BizTalk-Gruppe zu importieren und die Anwendung auf dem lokalen Computer zu installieren. Während der Installation erstellt ein in der Anwendung enthaltenes Vorverarbeitungsskript Ordner, die von der Anwendung verwendet werden, und protokolliert seine Aktionen in einer Datei. Schließlich führen Sie ein Skript aus, das die Anwendung löscht und deinstalliert. Während der Deinstallation entfernt ein in der Anwendung enthaltenes Vorverarbeitungsskript die Dateien und Ordner, die während der Installation erstellt wurden, und protokolliert seine Aktionen in einer Datei.

Im Folgenden sind die skripts aufgeführt, die in diesem Beispiel enthalten sind:

• Build.bat. Generiert eine Schlüsseldatei, erstellt das Projekt in Visual Studio und signiert die .dll Dateien.

• CreateFullAndPartialMSI.bat. Führt die folgenden Aktionen in der folgenden Reihenfolge aus:

  1. Verwendet den BEFEHL "BTSTask AddApp ", um eine Anwendung zu erstellen.

  2. Verwendet den Befehl BTSTask AddResource, um der Anwendung drei BizTalk-Assemblies sowie andere Ressourcen hinzuzufügen, die von Build.bat generiert wurden.

  3. Verwendet den Befehl BTSTask ExportApp, um die Artefakte der Anwendung in eine .msi-Datei namens CreateApplicationSample.msi zu exportieren.

  4. Verwendet den BTSTask ListApp Command , um ein Anwendungsmanifest mit dem Namen AppManifest.xmlzu generieren, das alle in der Anwendung enthaltenen Artefakte auflistet.

  5. Verwendet den Befehl BTSTask ExportApp, um nur die Orchestrierungs-Assembly in eine .msi-Datei mit dem Namen CreateApplicationSamplePartial.msi zu exportieren. Dazu stellen Sie ResourceSpecPartial.xml für den Parameter ResourceSpec bereit. ResouceSpecPartial.xml ist eine bearbeitete Version von ResourceSpecComplete.xml, die mit diesem Beispiel bereitgestellt wurde. Diese Datei wurde so bearbeitet, dass sie nur einen Verweis auf die Orchestrierungsassembly enthält. Wenn dieser Parameter bereitgestellt wird, exportiert BTSTask nur die Artefakte, die in der datei ResourceSpecPartial.xml aufgeführt sind – in diesem Fall die Orchestrierungsassembly.

  6. Löscht die Anwendung aus der BizTalk Management-Datenbank für die Gruppe.

• CreateNewAppFromMSI.bat. Verwendet CreateApplicationSample.msi, die von CreateFullAndPartialMSI.bat generiert wurden, um eine Anwendung namens CreateApplicationSample auf dem lokalen Computer zu installieren und die Anwendung in die BizTalk-Gruppe zu importieren. Während der Installation wird PreProcScript.bat automatisch ausgeführt, wie später beschrieben.

• RemoveApp.bat. Führt die folgenden Aktionen in der folgenden Reihenfolge aus:

  1. Verwendet den BEFEHL "BTSTask RemoveApp" , um die CreateApplicationSample-Anwendung aus der BizTalk-Verwaltungsdatenbank für die Gruppe zu löschen.

  2. Verwendet den BTSTask UninstallApp Command , um die CreateApplicationSample-Anwendung vom lokalen Computer zu deinstallieren. Während der Installation wird PreProcScript.bat automatisch ausgeführt, wie weiter beschrieben.

• PreProcScript.bat. Führt die folgenden Aktionen aus:

  • Jedes Mal wenn es ausgeführt wird, legt es das öffentliche Schlüsseltoken für die vom Benutzer bereitgestellte Assembly fest.

  • Erstellt während der Anwendungsinstallation die folgenden Ordner, die von der CreateApplicationSample-Anwendung verwendet werden, um Nachrichten zu enthalten:

    C:\CreateApplicationSample\Out

    C:\CreateApplicationSample\In

  • Beim Aufheben der Anwendungsinstallation werden die Dateien und Ordner gelöscht, die während der Installation erstellt wurden. Deinstalliert auch vom globalen Assemblycache (GAC) alle Assemblys, die während der Installation im GAC installiert wurden, und protokolliert seine Aktionen in einer Datei. Um die Assemblys vom GAC zu deinstallieren, bezieht es sich auf das öffentliche Schlüsseltoken, das vom Benutzer bereitgestellt wird.

  • Erstellt während der Installation und Deinstallation eine Protokolldatei am folgenden Speicherort:

    C:\ScriptLog.txt

Wo finde ich dieses Beispiel?

Die Beispieldateien finden Sie in den folgenden Ordnern unter <"Beispielpfad>\Anwendungsbereitstellung\":

• CreateApp (Ordner)

  • Build.bat

  • CreateFullAndPartialMSI.bat

  • CreateNewAppFromMSI.bat

  • RemoveApp.bat

• CreateApp\Bindings (Ordner)

  • CreateApplicationSampleBindings.xml

• CreateApp\Dlls (Ordner)

  • Leer

• CreateApp\ResourceSpecs (Ordner)

  • ResourceSpecPartial.xml

  • ResourceSpecComplete.xml

• CreateApp\Scripts (Ordner)

  • PreProcScript.bat

• CreateApp\HelloApplicationDeployment (Ordner)

  • HelloApplicationDeployment.suo

  • HelloApplicationDeployment.sln

• CreateApp\HelloApplicationDeployment\Maps (Ordner)

  • POToInvoice.btm

  • Maps.btproj

• CreateApp\HelloApplicationDeployment\Orchestrations (Folder)

  • Orchestrations.btproj

  • HelloOrchestration.odx

• CreateApp\HelloApplicationDeployment\Schemas (Ordner)

  • Schemas.btproj

  • POSchema.xsd

  • InvoiceSchema.xsd

Verwendung dieses Beispiels

Verwenden Sie das folgende Verfahren, um dieses Beispiel zu verwenden.

So verwenden Sie das Beispiel

1. Führen Sie Build.bat aus. Dadurch wird eine Schlüsseldatei generiert, die Projekte im Ordner "HelloApplicationDeployment" gebaut, die resultierenden .dll-Dateien signiert und die .dll-Dateien im Ordner "Dlls" abgelegt.

2. Öffnen Sie die PreProcScript.bat Datei, die sich im Ordner "CreateApp\Scripts" befindet. Entfernen Sie in der folgenden Codezeile REM, und stellen Sie das öffentliche Schlüsseltoken für die Assembly bereit:

   REM set PublicKeyToken=

   Beispiel:

   set PublicKeyToken=1234a5b6c1234567

3. Führen Sie CreateFullAndPartialMSI.bat aus. Dadurch werden zwei Anwendungsdateien im .msi-Format erstellt: CreateApplicationSample.msi und CreateApplicationSamplePartial.msi.

4. Führen Sie CreateNewAppFromMSI.bat aus. Dadurch wird die CreateApplicationSample-Anwendung in die BizTalk-Gruppe importiert und auf dem lokalen Computer installiert.

5. Überprüfen Sie die Skriptprotokolldatei unter C:\ScriptLog.txt, um zu überprüfen, ob das Skript seine Installationsaktionen protokolliert hat.

6. Stellen Sie sicher, dass die CreateApplicationSample-Anwendung sowohl in der BizTalk Server-Verwaltungskonsole als auch in "Programme hinzufügen oder entfernen" angezeigt wird.

7. Führen Sie RemoveApp.bat aus. Dadurch wird das CreateApplicationSample aus der BizTalk Management-Datenbank gelöscht und vom lokalen Computer deinstalliert.

8. Überprüfen Sie die Skriptprotokolldatei unter C:\ScriptLog.txt, um zu überprüfen, ob das Skript seine Deinstallationsaktionen protokolliert hat. Sie sollten nach den zuvor protokollierten Installationsaktionen während der Installation angezeigt werden.

9. Stellen Sie sicher, dass die CreateApplicationSample-Anwendung nicht mehr in der BizTalk Server-Verwaltungskonsole oder in "Programme hinzufügen oder entfernen" angezeigt wird.

10. Überprüfen Sie, ob die Ordner, die während der Installation erstellt wurden, gelöscht wurden.

11. Stellen Sie sicher, dass die Assemblys vom GAC deinstalliert wurden.

Siehe auch

Anwendungsbereitstellung (BizTalk Server Samples Folder)
Bereitstellen von BizTalk-Anwendungen