共用方式為

HOW TO：產生部署報告

  • 發行項

更新：2007 年 11 月

在 [部署設計工具] 中，您可以設定部署報告的屬性 (Property)，然後從部署圖表產生部署報告。部署報告是設計用於協助您從報告中的結構化 XML 資訊建立安裝指令碼。此報告包含必要的應用程式和 DataCenter 組態設定，以及構成部署驗證的所有系統定義模型 (SDM) 中繼資料 (Metadata) 清單。此 SDM 中繼資料是由應用程式和應用程式裝載層所提供，並且會描述大部分部署應用程式所需的資訊。如需詳細資訊，請參閱部署報告概觀。

注意事項：

不建議從產生自預設系統的部署圖表或部署報告完成部署定義。預設系統對於快速評估 DataCenter 內個別應用程式的部署十分有用，但是不應用於最後部署。如需詳細資訊，請參閱從應用程式和系統圖表建立的部署定義。

若要設定部署報告屬性

  1. 按一下部署圖表介面來選取它。

  2. 在 [屬性] 視窗中，設定 [目的路徑] 屬性。

    秘訣

    如果 [屬性] 視窗並未開啟，請按 F4，或從 [檢視] 功能表中選擇 [屬性視窗]。

    這個路徑指出將 [包含內容檔]、[包含原始程式檔] 或 [包含二進位檔] 屬性設定為 [True] 時，專案將會複製到哪裡。

    注意事項：

    只有在將 [包含內容檔]、[包含原始程式檔] 或 [包含二進位檔] 屬性設定為 [True] 時，您才需要設定 [目的路徑] 屬性。[目的路徑] 屬性沒有預設值。

  3. 設定 [包含內容檔] 屬性。

    這個屬性會指出哪些內容檔將會包含在部署報告中並複製到目的路徑目錄，以便用於編寫指令碼。

    如果您選擇 [True]，則會包括下列檔案類型：

    • Web 專案：程式碼檔、專案檔、資源檔、.config 檔、參考的組件 (Assembly)、SDM 檔，以及所有其他非原始程式檔和非二進位檔。這包含 .xsd、.disco 及 .wsdl 檔。

    • Windows 專案：SDM 檔、存在於方案資料夾中的組件，以及所有其他非原始程式檔和非二進位檔。

    • Office 專案：SDM 檔、存在於方案資料夾中的組件，以及所有其他非原始程式檔和非二進位檔。

  4. 設定 [包含原始程式檔] 屬性。

    這個屬性會指出哪些原始程式檔將會包含在部署報告中並複製到目的路徑目錄。

    如果您選擇 [True]，則會包括下列檔案類型：

    • Web 專案：無。

    • Windows 專案：程式碼檔、專案檔、資源檔及 .config 檔。

    • Office 專案：程式碼檔、專案檔、資源檔及 .config 檔。

  5. 設定 [包含二進位檔] 屬性。

    這個屬性會指出哪些二進位檔將會包含在部署報告中並複製到目的路徑目錄。

    如果您選擇 [True]，則會包括下列檔案類型：

    • Web 專案：無。

    • Windows 專案：如果您將 [包含原始程式檔] 設定為 [True]，還會包含可執行檔和 App.config 檔。

    • Office 專案：如果您將 [包含原始程式檔] 設定為 [True]，還會包含產生的組件和 App.config 檔。

  6. 若要將圖表影像包含在 HTML 部署報告中，請將 [包含圖表] 選項設定為 [True] (預設)。

  7. 若要避免系統提示您覆寫檔案，請將 [覆寫檔案動作] 屬性設定為 [是]。

  8. 將 [錯誤解析] 屬性設定為 [提示]、[忽略] 或 [中止]。

    如果您是使用自動化功能來產生部署報告，若不論錯誤為何都要建立報告，請將這個屬性設定為 [忽略]。如果您希望在錯誤事件中報告建立會失敗，則將此屬性設定為 [中止]。

  9. 將 [僅限錯誤] 屬性設定為下列其中一項：

    • True

      HTML 報告只會包含驗證錯誤和警告清單。

    • False

      HTML 報告會包含清單及所有的其他內容 (端點、設定、資源等等)。

      注意事項：

      在某些執行個體中，部署報告中的錯誤文字會不同於 [錯誤清單] 視窗中的錯誤文字。

您現在即可產生部署報告。

若要產生部署報告

  1. 一旦設定好所有部署報告屬性，請選擇 [圖表] 功能表中的 [產生部署報告]。

    秘訣

    您也可以以滑鼠右鍵按一下部署圖表介面，並選擇 [產生部署報告]。

  2. 如果部署圖表已有報告存在，且 [覆寫檔案動作] 屬性不是設定為 [是]，則系統將提示您覆寫現有的報告。

    注意事項：

    只會覆寫現有的報告。其餘的檔案和目錄結構維持不變。這會保留您可能已寫入目錄結構的任何其他檔案。若要避免日後系統提示您覆寫檔案，請將 [覆寫檔案動作] 屬性設定為 [是]。

    當系統提示您時，請選擇下列其中一項：

    • 是：覆寫目前的檔案，再次發生相同的情況時會提示您。

    • 否：不覆寫目前的檔案，再次發生相同的情況時會提示您。

    • 取消：停止報告產生處理程序。

    [部署設計工具] 會在 [方案總管] 中產生兩份部署報告，其中一份為 HTML (.html) 格式，而另一份為 XML (.xml) 格式。完成報告產生時，.html 和 .xml 檔案都會加入至與部署圖表關聯之系統的方案資料夾。

HTML 和 XML 格式的報告會包含大部分相同的資訊。不過，HTML 報告還會包含方案中的圖表影像和擁有人清單。此外，HTML 報告不會包含其預設值設定為 NULL 且未修改的資源，而 XML 檔案則會包含這些資源以用於編寫指令碼。

您也可以使用 Visual Studio 的自動化功能，或使用命令列輸入來產生部署報告。如需詳細資訊，請參閱 HOW TO：將 Automation 用於部署報告 和 HOW TO：從命令列建立部署報告。

注意事項：

當應用程式執行時，它會在名為 <appname>.exe.config 的檔案中搜尋設定。如果這個檔案不存在，應用程式可能無法正確運作。部署報告並不會複製或列出 <appname>.exe.config — 它僅包含 app.config (<appname>.exe.config 的複本)。若要解決這個問題，請確定您的部署指令碼會正確重新命名 app.config。

安全性

部署報告所包含的資料可能會包括敏感性或機密的公司或機構資料。在分配或處置報告前，請注意這個考量。

注意事項：

當 [包含原始程式檔] 或 [包含內容檔] 設定為 [True] 時，會顯示警告表示輸出目錄可能不安全。

請參閱

工作

HOW TO：自訂部署報告

概念

部署報告概觀