如何：生成部署报告

更新：2007 年 11 月

在部署设计器中，可以设置部署报告的属性，然后从部署关系图生成部署报告。部署报告旨在协助您从该报告中的结构化 XML 信息创建安装脚本。该报告包含必需的应用程序和数据中心配置设置，以及包含部署验证的所有系统定义模型 (SDM) 元数据列表。此 SDM 元数据由应用程序和应用程序宿主层提供，用于描述部署应用程序时所需的大部分信息。有关更多信息，请参见部署报告概述。

说明：
建议您不要从通过默认系统生成的部署关系图或部署报告完成部署定义。若要快速评估数据中心中各个应用程序的部署，可以使用默认的系统。但是，这些系统不能用于最终的部署。有关更多信息，请参见从应用程序和系统关系图创建的部署定义。

设置部署报告属性

1. 单击部署关系图面以将其选中。

2. 在“属性”窗口中，设置“目标路径”属性。

   提示：
   如果“属性”窗口未打开，请按 F4 或从“视图”菜单中选择“属性窗口”。

   此路径指示了将“包括内容文件”、“包括源文件”或“包括二进制文件”属性设置为“True”时要复制项目文件的位置。

   说明：
   只有还要将“包括内容文件”、“包括源文件”或“包括二进制文件”属性设置为“True”时，才需要设置“目标路径”属性。“目标路径”属性没有默认值。

3. 设置“包括内容文件”属性。

   此属性指示哪些内容文件将包括在部署报告中并复制到目标路径目录，以供编写脚本时使用。

   如果选择“True”，将包括下列文件类型：

   • Web 项目 - 代码文件、项目文件、资源文件、.config 文件、引用的程序集、SDM 文件以及所有其他非源文件和非二进制文件。这些文件包括 .xsd、.disco 和 .wsdl 文件。

   • Windows 项目 - SDM 文件、解决方案文件夹中存在的程序集以及所有其他非源文件和非二进制文件。

   • Office 项目 - SDM 文件、解决方案文件夹中存在的程序集以及所有其他非源文件和非二进制文件。

4. 设置“包括源文件”属性。

   此属性指示哪些源文件将包括在部署报告中并复制到目标路径目录。

   如果选择“True”，将包括下列文件类型：

   • Web 项目 - 无。

   • Windows 项目 - 代码文件、项目文件、资源文件和 .config 文件。

   • Office 项目 - 代码文件、项目文件、资源文件和 .config 文件。

5. 设置“包括二进制文件”属性。

   此属性指示哪些二进制文件将包括在部署报告中并复制到目标路径目录。

   如果选择“True”，将包括下列文件类型：

   • Web 项目 - 无。

   • Windows 项目 - 可执行文件和 App.config 文件。如果将“包括源文件”设置为“True”，也包括这些文件。

   • Office 项目 - 生成的程序集和 App.config 文件。如果将“包括源文件”设置为“True”，也包括这些文件。

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 自动生成部署报告，或者使用命令行输入创建部署报告。有关更多信息，请参见 如何：对部署报告使用自动化操作 和 如何：从命令行创建部署报告。

说明：
当应用程序运行时，它在名为 <appname>.exe.config 的文件中查找设置。如果此文件不存在，则应用程序可能不会正常运行。部署报告不会复制或列出 <appname>.exe.config -- 它仅包含 app.config，这是 <appname>.exe.config 的副本。若要解决此问题，请确保部署脚本相应地重命名 app.config。

安全性

部署报告包含的数据可能包括敏感或机密的公司或机构数据。分发或释放该报告之前，应该注意这一点。

说明：
将“包括源文件”或“包括内容文件”设置为“True”时，将会出现一则警告，指示输出目录可能不安全。

请参见

任务

如何：自定义部署报告

概念

部署报告概述