CreateApp (Beispiel für die Anwendungsbereitstellung)

In diesem Thema wird die Verwendung des Beispiels zum Erstellen einer Anwendung (CreateApp) erläutert. Mit diesem Beispiel wird die Verwendung des Befehlszeilentools BTSTask zum Bereitstellen einer BizTalk-Anwendung und zum Zurücknehmen der Bereitstellung gezeigt. Sie können Skripts wie diejenigen in diesem Beispiel verwenden, um den in der Nacht stattfindenden Erstellungsprozess so zu automatisieren, dass BizTalk-Anwendungen bereitgestellt und Bereitstellungen zurückgenommen werden.

Ziel des Beispiels

Das Beispiel umfasst Skripts, durch die Aufgaben der Anwendungsbereitstellung automatisiert werden. Um diese Aufgaben durchzuführen, führen Sie ein Skript aus, mit dem das BizTalk-Projekt und die Dateien generiert werden. Dann führen Sie ein Skript aus, mit dem zwei MSI-Dateien für die BizTalk-Anwendung erstellt werden: eine MSI-Datei, die alle Elemente in einer Anwendung enthält, und eine MSI-Datei, die nur eine einzige Assembly in der Anwendung enthält. Anschließend führen Sie ein Skript aus, das eine MSI-Datei zum Importieren einer Anwendung in eine BizTalk-Gruppe und zum Installieren der Anwendung auf dem lokalen Computer verwendet. Während der Installation werden von einem vorab verarbeiteten Skript, das in der Anwendung enthalten ist, die von der Anwendung verwendeten Ordner erstellt, und die Aktionen werden in einer Datei protokolliert. Zum Schluss führen Sie ein Skript aus, mit dem die Anwendung gelöscht und deinstalliert wird. Während der Deinstallation werden von einem vorab verarbeiteten Skript, das in der Anwendung enthalten ist, die bei der Installation erstellten Dateien und Ordner entfernt, und die Aktionen werden in einer Datei protokolliert.

Dieses Beispiel umfasst die folgenden Skripts:

• 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 angegebenen Reihenfolge aus:

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

  2. Verwendet den Befehl BTSTask AddResource , um der Anwendung drei BizTalk-Assemblys 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 Befehl BTSTask ListApp , um ein Anwendungsmanifest namens AppManifest.xml zu generieren, das alle in der Anwendung enthaltenen Artefakte auflistet.

  5. Verwendet den Befehl BTSTask ExportApp , um nur die Orchestrierungsassembly in eine .msi-Datei namens CreateApplicationSamplePartial.msi zu exportieren. Dazu wird ResourceSpecPartial.xml für den ResourceSpec-Parameter bereitgestellt. Bei ResouceSpecPartial.xml handelt es sich um eine bearbeitete Version von ResourceSpecComplete.xml, die in diesem Beispiel enthalten ist. Diese Datei wurde so bearbeitet, dass sie nur einen Verweis auf die Orchestrierungsassembly enthält. Bei Bereitstellung mit diesem Parameter exportiert BTSTask nur die in der Datei ResourceSpecPartial.xml aufgelisteten Elemente, in diesem Fall also die Orchestrierungsassembly.

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

• CreateNewAppFromMSI.bat. Verwendet CreateApplicationSample.msi, die von CreateFullAndPartialMSI.bat generiert werden, 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 automatisch PreProcScript.bat ausgeführt. Dies wird an späterer Stelle beschrieben.

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

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

  2. Verwendet den Befehl BTSTask UninstallApp, um die CreateApplicationSample-Anwendung vom lokalen Computer zu deinstallieren. Während der Installation wird automatisch PreProcScript.bat ausgeführt, wie es nachfolgend erläutert ist.

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

  • Legt bei jeder Ausführung das vom Benutzer bereitgestellte öffentliche Schlüsseltoken für die Assembly fest.

  • Erstellt während der Anwendungsinstallation die folgenden Ordner, die von der Anwendung CreateApplicationSample für Nachrichten verwendet werden:

    C:\CreateApplicationSample\Out

    C:\CreateApplicationSample\In

  • Löscht während der Deinstallation der Anwendung die Dateien und Ordner, die bei der Installation erstellt wurden. Deinstalliert außerdem im globalen Assemblycache (GAC) alle Assemblys, die bei der Installation im GAC installiert wurden, und protokolliert die Aktionen in einer Datei. Zum Deinstallieren der Assemblys aus dem GAC wird auf das vom Benutzer bereitgestellte öffentliche Schlüsseltoken verwiesen.

  • Erstellt sowohl bei der Installation als auch der Deinstallation eine Protokolldatei an folgendem Speicherort:

    C:\ScriptLog.txt

Speicherort dieses Beispiels

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 (Ordner)

  • Orchestrations.btproj

  • HelloOrchestration.odx

• CreateApp\HelloApplicationDeployment\Schemas (Ordner)

  • Schemas.btproj

  • POSchema.xsd

  • InvoiceSchema.xsd

Verwenden dieses Beispiels

Gehen Sie zum Verwenden des Beispiels wie folgt vor:

So verwenden Sie das Beispiel

1. Führen Sie Build.bat aus. Dadurch wird eine Schlüsseldatei generiert, die Projekte unter dem Ordner HelloApplicationDeployment erstellt, die resultierende .dll Dateien signiert und the.dll Dateien im Ordner Dlls platziert.

2. Öffnen Sie die Datei PreProcScript.bat, die sich im Ordner CreateApp\Scripts befindet. Entfernen Sie in der folgenden Codezeile den Eintrag 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 .msi 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. Prüfen Sie die Skriptprotokolldatei in C:\ScriptLog.txt, um festzustellen, ob das Skript die Installationsaktionen protokolliert hat.

6. Vergewissern Sie sich, dass die Anwendung CreateApplicationSample sowohl in der BizTalk Server-Verwaltungskonsole als auch unter Software angegeben ist.

7. Führen Sie RemoveApp.bat aus. Dadurch wird createApplicationSample aus der BizTalk-Verwaltungsdatenbank gelöscht und vom lokalen Computer deinstalliert.

8. Prüfen Sie die Skriptprotokolldatei in C:\ScriptLog.txt, um festzustellen, ob das Skript die Deinstallationsaktionen protokolliert hat. Diese sollten nach den Installationsaktionen, die zuvor während der Installation protokolliert wurden, angegeben sein.

9. Vergewissern Sie sich, dass die Anwendung CreateApplicationSample weder in der BizTalk Server-Verwaltungskonsole noch unter Software angegeben ist.

10. Stellen Sie sicher, dass die während der Installation erstellten Ordner gelöscht wurden.

11. Vergewissern Sie sich, dass die Assemblys im GAC deinstalliert wurden.

Weitere Informationen

Anwendungsbereitstellung (Ordner für BizTalk Server-Beispiele)
Bereitstellen von BizTalk-Anwendungen