Anwendungsinformationen in Bereitstellungsberichten

  • Artikel

Aktualisiert: November 2007

Im XML-Bereitstellungsbericht enthält das <Applications>-Element Informationen über die Anwendungen, die in einem verteilten System bereitgestellt werden müssen. Sie benötigen diese Informationen, um diese Anwendungen für die Bereitstellung zu konfigurieren. Dieses Element enthält möglicherweise Informationen nur für Anwendungen in diesem System, oder es enthält Informationen für andere Systeme in diesem System. Dieses Element enthält außerdem Informationen über Einstellungen, Ressourcen und Endpunkte für jede Anwendung. Weitere Informationen finden Sie unter Übersicht über Hauptabschnitte in Bereitstellungsberichten.

Wenn der Bereitstellungsbericht zum Beispiel für ein "Standard"-System generiert wurde, enthält dieses Element alle Anwendungen in diesem Standardsystem, aber keine anderen Systeme. Das Standardsystem stellt jedoch dar, wie diese Anwendungen in der Entwicklungsumgebung verbunden und konfiguriert werden, nicht in der Bereitstellungsumgebung. Weitere Informationen finden Sie unter Mithilfe von Anwendungs- und Systemdiagrammen erstellte Bereitstellungsdefinitionen.

Das <Applications>-Element enthält ein oder mehrere <Application>-Elemente, die jede Anwendung im Bereitstellungsbericht identifizieren. Die folgenden Abschnitte enthalten weitere Informationen zum <Application>-Element:

  • Application Information in the <Application> Element

  • Paths to Application Files

  • Configuration File Settings for Applications

  • IIS Metabase Settings for ASP.NET Applications

  • Information about Application Connections

  • Web Service and Web Content Absolute URIs

Anwendungsinformationen im &lt;Application&gt;-Element

Das folgende Beispiel enthält ein <Application>-Element für eine Windows-Anwendung. Das "Extends"-Attribut "Microsoft_WindowsApplication:WindowsApplication" identifiziert die Windows-Anwendung:

<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="ed22d434-f40d-48b1-bbec-0b4e93ad2a9f">
   ...
</Application>

Innerhalb dieses Elements finden Sie die folgenden Informationen:

  • Pfade zu Anwendungsdateien, die für die Bereitstellung benötigt werden.

  • Einstellungen, die in Anwendungskonfigurationsdateien aktualisiert werden müssen.

  • Von ASP.NET-Anwendungen für die Bereitstellung angeforderte IIS-Metabasiseinstellungen (Internetinformationsdienste).

  • Verbindungsinformationen für Anwendungen.

  • Absolute URIs (Bereitstellungsspeicherort) für Webdienst- und Webinhalts-Anbieterendpunkte.

Der Anwendungstyp bestimmt die Typen von Dateien, Einstellungen und anderen Informationen, die im Bereitstellungsbericht enthalten sind.

Pfade zu Anwendungsdateien

Der Bereitstellungsbericht enthält Pfadinformationen für die Dateien, die für die Bereitstellung von Anwendungen benötigt werden. Zu diesen Dateien gehören beispielsweise Bibliotheken, ausführbare Dateien, Inhaltsdateien und Konfigurationsdateien. Sie benötigen diese Informationen, um diese Dateien für die Bereitstellung zu suchen. Um diese Dateien zu kopieren, müssen Sie aber einen Speicherort angeben, bevor Sie den Bereitstellungsbericht generieren. Sie können diesen Speicherort in der Destination Path-Eigenschaft im Bereitstellungsdiagramm angeben, mit dem der Bereitstellungsbericht generiert wird. Sie müssen mithilfe der entsprechenden Eigenschaften auch angeben, ob Quell-, Inhalts- und Binärdateien enthalten sein sollen. Dadurch können Sie diese Dateien einschließen und sie über den angegebenen Speicherort erfassen. Wenn Sie den Bereitstellungsbericht generieren, erstellt der Generierungsprozess die entsprechenden Projektverzeichnisse und kopiert die Dateien an diesen Speicherort. Weitere Informationen finden Sie unter Gewusst wie: Generieren von Bereitstellungsberichten.

Hinweis:

Für jede Anwendungsdefinition im Anwendungsdiagramm, die die Implementierung unterstützt, ist in der Projektmappe für diese Definition nur ein Projekt vorhanden. Es können aber mehrere Verwendungen dieser Definition im System, das Sie bereitstellen, vorhanden sein. Ihr System enthält zum Beispiel möglicherweise mehrere Verwendungen mit unterschiedlichen Sicherheitseinstellungen, die auf unterschiedlichen Servern bereitgestellt werden. Der Bereitstellungsbericht enthält diese mehrfachen Verwendungen. Der Generierungsprozess erstellt jedoch für die gesamten Verwendungen nur ein Projektverzeichnis. Deshalb muss der Bereitstellungsprozess jede Verwendung mithilfe von Informationen im Bereitstellungsbericht erstellen und konfigurieren.

Für jede ASP.NET-, Windows- oder Office-Anwendung im Bereitstellungsbericht enthält das <Application>-Element ein <Resource>-Element mit dem Namen "Directory". Das "Directory"-Element enthält <Resource>-Elemente mit Informationen über die Verzeichnisse am Ausgabespeicherort und die in diese Verzeichnisse kopierten Dateien. Weitere Informationen finden Sie unter Speicherort- und Verzeichnisstruktur von Bereitstellungsausgabedateien.

Jedes <Resource>-Element im "Directory"-Element verweist im Dateisystempfad auf eine Datei oder ein Verzeichnis am Ausgabespeicherort. Ein <Resource>-Element, das auf ein Verzeichnis verweist, enthält möglicherweise andere <Resource>-Elemente, die auf Unterverzeichnisse verweisen. Alle <Resource>-Elemente, die auf Dateien verweisen, befinden sich aber auf Blattebene.

Hinweis:

Diese Gruppe von <Resource>-Elementen verfügt über die gleiche Hierarchie wie die Projektstruktur in der Projektmappe. Allerdings werden <Resource>-Elemente, die Verzeichnisse auf derselben Ebene darstellen, möglicherweise in einer anderen Reihenfolge dargestellt als die zugehörigen Ordner in der Projektmappe oder auf dem Datenträger. Außerdem ändert das Umbenennen von Projekten in einer Projektmappe nicht ihre Ordnernamen auf dem Datenträger. Allerdings wird nicht der Projektname in der Projektmappe, sondern der Projektordnername auf dem Datenträger dazu verwendet, das Projektverzeichnis am Ausgabespeicherort zu erstellen. Daher ist der Projektverzeichnisname am Ausgabespeicherort möglicherweise nicht derselbe wie der Projektname in der Projektmappe.

Außerdem enthält jedes <Resource>-Element, das ein Verzeichnis oder eine Datei darstellt, ein "Path" genanntes <Setting>-Element. Dieses "Path"-Element enthält drei <Facet>-Elemente: "Assigned", "Parent" und "Current."

Die folgende Tabelle enthält Informationen über diese Elemente.

<Facet>-Element

Beschreibung

"Assigned"

Enthält den durch die Destination Path-Eigenschaft im Bereitstellungsbericht angegebenen Pfad des Ausgabespeicherorts. Aber nur das "Path"-Element im "Directory"-Element enthält diesen Wert.

"Parent"

Enthält den Pfad vom Projektverzeichnis zum übergeordneten Verzeichnis eines Unterverzeichnisses oder einer Datei. Aber nur das "Path"-Element dieses Unterverzeichnisses oder dieser Datei enthält diesen Wert.

Hinweis:
Wenn das Projekt ein übergeordnetes Verzeichnis besitzt, enthält das "Parent"-Element des "Path"-Elements im "Directory"-Element nicht den Pfad zu diesem übergeordneten Verzeichnis.

"Current"

Enthält den Pfad vom Projektverzeichnis zu einem Unterverzeichnis oder einer Datei. Das "Path"-Element für das Projektverzeichnis, ein Unterverzeichnis oder eine Datei enthält diesen Wert.

Daher können Sie den vollständigen Pfad zu einem Unterverzeichnis oder einer Datei abrufen, indem Sie das "Assigned"-Element vom "Path"-Element im "Directory"-Element mit dem "Current"-Element eines Unterverzeichnisses oder einer Datei kombinieren.

Hinweis:

Sie müssen möglicherweise einen umgekehrten Schrägstrich (\) hinzufügen, um einen gültigen Pfad zu erstellen.

Weitere Informationen finden Sie unter Gewusst wie: Suchen von Pfaden zu Bereitstellungsausgabedateien in Bereitstellungsberichten und unter Speicherort- und Verzeichnisstruktur von Bereitstellungsausgabedateien.

Konfigurationsdateieinstellungen für Anwendungen

Sie müssen die Konfigurationsdatei (Web.config für ASP.NET-Anwendungen, App.config für Windows- oder Office-Anwendungen) für jede Verwendung einer Anwendung im System mit den richtigen Bereitstellungseinstellungen aktualisieren. Zunächst stellen die Einstellungen in der Konfigurationsdatei die Anwendungskonfiguration in der Entwicklungsumgebung, nicht in der Bereitstellungsumgebung, dar. Sie können allerdings die für die Bereitstellung erforderlichen Konfigurationsdateieinstellungen aus dem Bereitstellungsbericht abrufen.

Das <Application>-Element für eine Anwendung enthält ein "Directory" genanntes <Resource>-Element. Weitere Informationen finden Sie unter Paths to Application Files. Dieses "Directory"-Element enthält ein weiteres <Resource>-Element mit dem Namen "Configuration". Dieses "Configuration"-Element enthält <Setting>-Elemente und <Resource>-Elemente, die die für die Bereitstellung benötigten Konfigurationsdateieinstellungen identifizieren. Weitere Informationen finden Sie unter Gewusst wie: Suchen nach Einstellungen von Anwendungskonfigurationsdateien in Bereitstellungsberichten.

Hinweis:

Konfigurationsdateieinstellungen im Bereitstellungsbericht sollten die gleichen Namen tragen wie ihre Äquivalente in der Konfigurationsdatei. Die Ressourcennamen, unter denen im Bereitstellungsbericht Einstellungen angezeigt werden, unterscheiden sich aber möglicherweise von den entsprechenden Abschnitten in der Konfigurationsdatei. Weitere Informationen finden Sie unter Konfigurationsdateiabschnitte in Bereitstellungsberichten.

IIS-Metabasiseinstellungen für ASP.NET-Anwendungen

Das <Application>-Element für eine ASP.NET-Anwendung enthält ein "WebApplication" genanntes <Resource>-Element. Dieses "WebApplication"-Element enthält <Setting>-Elemente, die die für die Bereitstellung erforderlichen IIS-Metabasiseinstellungen beschreiben. Einige dieser Einstellungsnamen, -werte oder -typen unterscheiden sich jedoch von den jeweiligen IIS-Entsprechungen und müssen vor dem Konfigurieren auf dem Zielserver übersetzt werden. Weitere Informationen finden Sie unter den folgenden Themen:

Informationen über Anwendungsverbindungen

Das <Application>-Element enthält ein <Endpoint>-Element für jeden Endpunkt in einer Anwendung. Ein <Endpoint>-Element enthält ein "ConnectedToEndpoints" genanntes <Setting>-Element, wenn ein Endpunkt eine Verbindung mit einem anderen Endpunkt herstellt. Sie können mit dem "ConnectedToEndpoints"-Element alle mit diesem Endpunkt verbundenen Endpunkte identifizieren. Das "ConnectedToEndpoints"-Element enthält einen eindeutigen globalen Bezeichner (GUID), der dem "Instanceld"-Attribut für den verbundenen Endpunkt entspricht. Andere <Setting>-Elemente im <Endpoint>-Element enthalten Informationen über die Einstellungen des Endpunkts.

Tipp:

Sie können diese Einstellungen anzeigen, indem Sie den Endpunkt im Anwendungsdiagramm oder im Systemdiagramm (von dem das Bereitstellungsdiagramm erstellt wurde) auswählen. Zeigen Sie anschließend im Einstellungs- und Einschränkungs-Editor den Knoten Einstellungen für den Anwendungsendpunkt an. Weitere Informationen finden Sie unter Einstellungs- und Einschränkungs-Editor.

Das folgende Beispiel enthält ein "ConnectedToEndpoints"-Element für einen Consumerendpunkt des Webdiensts in einer Windows-Anwendung. Dieses Element enthält eine GUID, die den verbundenen Webdienst-Anbieterendpunkt in einer ASP.NET-Webanwendung identifiziert. Das <Endpoint>-Element für den Webdienst-Anbieterendpunkt wiederum verfügt über ein "ConnectedToEndpoints"-Element, das den GUID-Wert für den verbundenen Consumerendpunkt des Webdiensts enthält:

<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="6b36995a-a6cf-47d6-9dcb-679d07db23ef">
   <Endpoint Name="MyWebServiceConsumer" Definition="MyWinAppDefinition:MyWinAppDefinition.WebServiceConsumer1" Extends="Microsoft_Web:WebServiceClient" InstanceId="a18fb424-c1a4-49e3-b4af-e6d7e2e9d063"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>9c4e0dc0-a29d-4bb7-8061-a9d3e2075581</Value></Setting>
      ...
   </Endpoint>
...
</Application>
<Application Name="MyWebApp1" Definition="MyWebApp1:MyWebApp1" Extends="Microsoft_WebApplication:WebApplication" InstanceId="1a912802-d7f3-4b53-89a5-b8bc7f378411">
   ...
   <Endpoint Name="WebService1" Definition="MyWebApp1:MyWebApp1.WebService1" Extends="Microsoft_Web:WebService" InstanceId="9c4e0dc0-a29d-4bb7-8061-a9d3e2075581"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>a18fb424-c1a4-49e3-b4af-e6d7e2e9d063</Value></Setting>
      ...
   ...
   </Endpoint>
...
</Application>

Absolute Webdienst- und Webinhalts-URIs

Sie müssen die Consumerendpunkte für jede Anwendung, die einen Webdienst oder einen Webinhalt verwendet, mit dem Bereitstellungsspeicherort des Webdiensts oder des Webinhalts konfigurieren. Das <Application>-Element für eine ASP.NET-Anwendung, die einen Webdienst oder Webinhalt verfügbar macht, enthält ein <Endpoint>-Element. Dieses <Endpoint>-Element enthält ein <Setting>-"Uri"-Element, das drei <Facet>-Elemente enthält: "Relative", "Base" und "Absolute".

Die folgende Tabelle enthält weitere Informationen über diese Elemente.

<Facet>-Element

Beschreibung

"Relative"

Enthält die Service URL-Einstellung von einem Webdienst-Anbieterendpunkt. Diese Einstellung kann einen relativen oder absoluten Webdienst-URL enthalten.

– oder –

Enthält die Relative Path-Einstellung von einem Webinhalts-Anbieterendpunkt. Diese Einstellung enthält einen relativen Pfad, der auf einen Inhalt an einem anderen Speicherort als dem Stammverzeichnis der Anwendung verweist.

"Base"

Enthält die URL-Einstellung von einem Websiteendpunkt. Dieser Websiteendpunkt befindet sich auf dem IIS-Webserver, der den Webdienst oder den Webinhalt hostet.

"Absolute"

Enthält den absoluten URI des Webdienst- oder Webinhalts-Anbieterendpunkts.

Hinweis:
Wenn die Service URL-Einstellung oder die Relative Path-Einstellung einen relativen URL oder Pfad enthält, kombiniert dieses Element die URL-Einstellung und die Service URL-Einstellung oder die Relative Path-Einstellung. Wenn aber die Service URL-Einstellung oder die Relative Path-Einstellung einen absoluten URL oder Pfad enthält, enthält dieses Element diesen absoluten URL oder Pfad.

Weitere Informationen finden Sie unter Gewusst wie: Suchen von absoluten Webdienst- und Webinhalts-URIs in Bereitstellungsberichten.
Tipp:

Sie können die Einstellungen für einen Webdienst- oder Webinhalts-Anbieterendpunkt anzeigen, indem Sie ihn im Anwendungsdiagramm auswählen und im Einstellungs- und Einschränkungs-Editor den Knoten Einstellungen für den Anwendungsendpunkt anzeigen. Sie können Einstellungen für einen Websiteendpunkt anzeigen, indem sie ihn im Diagramm für ein logisches Datencenter auswählen und im Einstellungs- und Einschränkungs-Editor den Knoten Einstellungen für den Endpunkt des logischen Servers anzeigen. Weitere Informationen finden Sie unter Einstellungs- und Einschränkungs-Editor.

Siehe auch

Konzepte

Übersicht über die Bereitstellung mit Bereitstellungsberichten