Gewusst wie: Generieren von Bereitstellungsberichten

  • Artikel

Aktualisiert: November 2007

Im Bereitstellungs-Designer können Sie Eigenschaften für einen Bereitstellungsbericht festlegen und anschließend den Bereitstellungsbericht anhand eines Bereitstellungsdiagramms generieren. Bereitstellungsberichte unterstützen Sie beim Erstellen eines Installationsskripts anhand strukturierter XML-Informationen im Bericht. Der Bericht enthält erforderliche Einstellungen für die Anwendungs- und Datencenterkonfiguration sowie eine Liste aller SDM (System Definition Model)-Metadaten, aus denen die Bereitstellungsvalidierung besteht. Diese SDM-Metadaten werden von der Anwendung und den Anwendungshostebenen bereitgestellt und beschreiben den Großteil der Informationen, die zum Bereitstellen einer Anwendung erforderlich sind. Weitere Informationen finden Sie unter Übersicht über Bereitstellungsberichte.

Hinweis:

Vom Fertigstellen einer Bereitstellungsdefinition auf der Grundlage von Bereitstellungsdiagrammen oder -berichten, die anhand von Standardsystemen generiert wurden, ist abzuraten. Standardsysteme empfehlen sich für die schnelle Evaluierung der Bereitstellung einzelner Anwendungen im Datencenter. Sie sollten jedoch nicht für die endgültige Bereitstellung verwendet werden. Weitere Informationen finden Sie unter Mithilfe von Anwendungs- und Systemdiagrammen erstellte Bereitstellungsdefinitionen.

So legen Sie Eigenschaften von Bereitstellungsberichten fest

  1. Klicken Sie auf die Oberfläche des Bereitstellungsdiagramms, um es auszuwählen.

  2. Legen Sie im Eigenschaftenfenster die Eigenschaft Zielpfad fest.

    Tipp:

    Wenn das Eigenschaftenfenster nicht geöffnet ist, drücken Sie F4, oder klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

    Dieser Pfad gibt an, an welchen Speicherort die Dateien kopiert werden, wenn die Eigenschaft Inhaltsdateien einschließen, Quelldateien einschließen oder Binäre Dateien einschließen auf True festgelegt ist.

    Hinweis:

    Sie müssen die Eigenschaft Zielpfad nur festlegen, wenn Sie die Eigenschaft Inhaltsdateien einschließen, Quelldateien einschließen oder Binäre Dateien einschließen auf True festlegen. Die Eigenschaft Zielpfad verfügt über keinen Standardwert.

  3. Legen Sie die Eigenschaft Inhaltsdateien einschließen fest.

    Mit dieser Eigenschaft wird angegeben, welche Inhaltsdateien in den Bereitstellungsbericht aufgenommen und für die Skripterstellung in das Verzeichnis des Zielpfads kopiert werden.

    Wenn Sie True auswählen, werden die folgenden Typen von Dateien eingeschlossen:

    • Webprojekte – Codedateien, Projektdateien, Ressourcendateien, CONFIG-Dateien, Assemblys, auf die verwiesen wird, SDM-Dateien und alle anderen Dateien, bei denen es sich weder um Quelldateien noch um Binärdateien handelt. Hierzu zählen XSD,- DISCO- und WSDL-Dateien.

    • Windows-Projekte – SDM-Dateien, Assemblys im Projektmappenordner und alle anderen Dateien, bei denen es sich weder um Quelldateien noch um Binärdateien handelt.

    • Office-Projekte – SDM-Dateien, Assemblys im Projektmappenordner und alle anderen Dateien, bei denen es sich weder um Quelldateien noch um Binärdateien handelt.

  4. Legen Sie die Eigenschaft Quelldateien einschließen fest.

    Mit dieser Eigenschaft wird angegeben, welche Quelldateien in den Bereitstellungsbericht aufgenommen und in das Verzeichnis des Zielpfads kopiert werden.

    Wenn Sie True auswählen, werden die folgenden Typen von Dateien eingeschlossen:

    • Webprojekte – Keine.

    • Windows-Projekte – Codedateien, Projektdateien, Ressourcendateien und CONFIG-Dateien.

    • Office-Projekte – Codedateien, Projektdateien, Ressourcendateien und CONFIG-Dateien.

  5. Legen Sie die Eigenschaft Binäre Dateien einschließen fest.

    Mit dieser Eigenschaft wird angegeben, welche Binärdateien in den Bereitstellungsbericht aufgenommen und in das Verzeichnis des Zielpfads kopiert werden.

    Wenn Sie True auswählen, werden die folgenden Typen von Dateien eingeschlossen:

    • Webprojekte – Keine.

    • Windows-Projekte – Ausführbare Dateien und App.config-Dateien, die auch eingeschlossen werden, wenn Sie Quelldateien einschließen auf True festlegen.

    • Office-Projekte – Generierte Assemblys und App.config-Dateien, die auch eingeschlossen werden, wenn Sie Quelldateien einschließen auf True festlegen.

  6. Um Diagrammbilder in den HTML-Bereitstellungsbericht aufzunehmen, legen Sie die Option Diagramme einschließen auf True (Standardeinstellung) fest.

  7. Wenn keine Aufforderung zum Überschreiben von Dateien angezeigt werden soll, legen Sie die Eigenschaft Aktion beim Überschreiben von Dateien auf Ja fest.

  8. Legen Sie die Eigenschaft Fehlerbehebung auf Eingabeaufforderung, Ignorieren oder Abbrechen fest.

    Wenn Sie den Bereitstellungsbericht mit Automatisierung generieren, legen Sie diese Eigenschaft auf Ignorieren fest, wenn Sie den Bericht trotz Fehlern erstellen möchten. Wenn die Berichterstellung beim Auftreten eines Fehlers fehlschlagen soll, legen Sie die Eigenschaft auf Abbrechen fest.

  9. Legen Sie die Eigenschaft Nur Fehler auf einen der folgenden Werte fest:

    • True

      Der HTML-Bericht enthält nur eine Liste mit Validierungsfehlern und -warnungen.

    • False

      Der HTML-Bericht enthält eine Liste mit allen anderen Inhalten (Endpunkte, Einstellungen, Ressourcen usw.).

      Hinweis:

      In einigen Fällen weicht der Text der Fehlermeldungen im Bereitstellungsbericht vom Fehlermeldungstext im Fenster Fehlerliste ab.

Jetzt können Sie einen Bereitstellungsbericht generieren.

So generieren Sie einen Bereitstellungsbericht

  1. Wenn alle Eigenschaften für den Bereitstellungsbericht festgelegt sind, wählen Sie im Menü Diagramm die Option Bereitstellungsbericht generieren aus.

    Tipp:

    Sie können auch mit der rechten Maustaste auf die Oberfläche des Bereitstellungsdiagramms klicken und Bereitstellungsbericht generieren auswählen.

  2. Wenn bereits ein Bericht für das Bereitstellungsdiagramm vorhanden und die Eigenschaft Aktion beim Überschreiben von Dateien nicht auf Ja festgelegt ist, werden Sie aufgefordert, den vorhandenen Bericht zu überschreiben.

    Hinweis:

    Es werden nur vorhandene Berichte überschrieben. Die übrigen Dateien und die Verzeichnisstruktur bleiben unverändert erhalten. Hierdurch bleiben zusätzliche Dateien erhalten, die Sie eventuell in die Verzeichnisstruktur geschrieben haben. Wenn zukünftig keine Aufforderung zum Überschreiben von Dateien angezeigt werden soll, legen Sie die Eigenschaft Aktion beim Überschreiben von Dateien auf Ja fest.

    Wenn eine Aufforderung angezeigt wird, wählen Sie eine der folgenden Aktionen aus:

    • Ja – Überschreiben der aktuellen Datei und Anzeigen einer Aufforderung, wenn dieselbe Situation erneut eintritt

    • Nein – Kein Überschreiben der aktuellen Datei und Anzeigen einer Auforderung, wenn dieselbe Situation erneut eintritt

    • Abbrechen – Beenden der Berichtsgenerierung

    Der Bereitstellungs-Designer generiert zwei Bereitstellungsberichte im Projektmappen-Explorer – einen im HTML-Format (.html) und einen im XML-Format (.xml). Nach Abschluss der Berichtsgenerierung werden dem Projektmappenordner des Systems, das dem Bereitstellungsdiagramm zugeordnet ist, sowohl die HTML-Datei als auch die XML-Datei hinzugefügt.

Der Bericht im HTML-Format und der Bericht im XML-Format enthalten nahezu dieselben Informationen. Der HTML-Bericht enthält jedoch auch Bilder von Diagrammen in der Projektmappe und eine Liste von Besitzern. Außerdem enthält der HTML-Bericht keine Ressourcen, in denen Standardwerte auf NULL festgelegt sind und nicht geändert wurden, während die XML-Datei diese Ressourcen für die Skripterstellung enthält.

Sie können auch in Visual Studio mithilfe von Automatisierung Bereitstellungsberichte generieren oder sie mithilfe eines Befehlszeileneintrags erstellen. Weitere Informationen finden Sie unter Gewusst wie: Verwenden von Automatisierung für Bereitstellungsberichte und Gewusst wie: Erstellen von Bereitstellungsberichten über die Befehlszeile.

Hinweis:

Wenn eine Anwendung ausgeführt wird, sucht diese in der Datei mit der Bezeichnung <Anwendungsname>.exe.config nach Einstellungen. Ist diese Datei nicht vorhanden, kann die Anwendung möglicherweise nicht korrekt ausgeführt werden. Im Bereitstellungsbericht wird <Anwendungsname>.exe.config weder kopiert noch aufgeführt. Nur app.config ist enthalten, und dabei handelt es sich um eine Kopie von <Anwendungsname>.exe.config. Um dieses Problem zu umgehen, stellen Sie sicher, dass im Bereitstellungsskript app.config entsprechend umbenannt wird.

Sicherheit

Ein Bereitstellungsbericht kann vertrauliche Daten von Firmen oder Einrichtungen enthalten. Berücksichtigen Sie diese Möglichkeit, bevor Sie den Bericht verteilen oder verwerfen.

Hinweis:

Wenn Quelldateien einschließen oder Inhaltsdateien einschließen auf True festgelegt ist, wird eine Warnung mit dem Hinweis angezeigt, dass das Ausgabeverzeichnis möglicherweise nicht sicher ist.

Siehe auch

Aufgaben

Gewusst wie: Anpassen von Bereitstellungsberichten

Konzepte

Übersicht über Bereitstellungsberichte