部署报告概述
更新:2007 年 11 月
部署报告可以编译与部署关系图上的应用程序、逻辑服务器、区域和终结点关联的元数据,还可以用 HTML 和 XML 格式的报告显示这些数据。根据部署报告生成的配置方式,该部署报告的 HTML 和 XML 版本可以提供下列信息:
HTML 部署报告 - 是一个图形报告,可以显示每个关系图以及部署关系图上每个应用程序、逻辑服务器、终结点或区域的所有资源和设置的列表。此外,可以将部署关系图验证错误和警告的列表包括在该报告中。应用程序开发和基础结构团队可以使用此报告共享评估应用程序要求与数据中心策略之间的冲突时所需的信息。有关更多信息,请参见 验证部署关系图、添加资源 和 应用设置。
XML 部署报告 - 可用来编写脚本的部署所需设置的清单。此后,可以使用此报告中的 XML 元数据编写满足自定义部署要求的脚本。
说明:
建议您不要从通过默认系统生成的部署关系图或部署报告完成部署定义。若要快速评估数据中心中各个应用程序的部署,可以使用默认的系统。但是,这些系统不能用于最终的部署。有关更多信息,请参见从应用程序和系统关系图创建的部署定义。
以下各节包含有关部署报告的更多信息:
Key Deployment Report Properties
Settings in the Deployment Report
Windows Applications in the Deployment Report
Web Applications in the Deployment Report
Generic Applications in the Deployment Report
重要的部署报告属性
生成部署报告之前,有一些应该使用“属性”窗口进行设置的属性。使用这些属性,可以执行下列操作:
“目标路径” - 指定磁盘路径或 UNC 路径,以便复制与应用程序关联的源文件、内容文件或二进制文件。这样可以集中收集部署应用程序时所需的文件。如果未设置此属性,将会生成部署报告,但该报告将不会包含文件和目录资源。因此,将不会向目标路径位置复制文件。
“包括内容文件”、“包括二进制文件”和“包括源文件” - 指示如何将源文件、内容文件或二进制文件复制到目标路径位置。有关每种应用程序类型的这些文件的更多信息,请参见部署报告中的泛型应用程序。
“覆盖文件操作” - 与自动化功能结合使用时,可以确定是否在覆盖文件时显示用户可解除的提示。
“错误分析” - 与自动化功能结合使用时,可以确定是否在生成部署报告时显示提示或是否应该忽略提示。此外,如果出现错误,可以选择中止创建部署报告。
“仅错误” - 如果设置为 True,HTML 部署报告将只包含验证错误和警告列表。如果设置为 False,HTML 报告将包含所有其他内容(终结点、设置和资源等),以及验证错误和警告列表。
有关更多信息,请参见如何:生成部署报告。
部署报告中的设置
在部署报告中,在每个资源之下列出了关联的设置。对于默认值已被修改的设置,列出了默认值和已赋予的值。修改默认值后,只列出已为其赋予的值。修改默认值后,只列出已为其赋予的值。对于所有设置,都会显示最终的设置值。如果在得知最终设置之前需要评估条件或其他设置,则得到的值与已赋予的值有所不同。因此,在设置和约束编辑器中赋予的值可能与部署报告中得到的值不同,因为在验证部署关系图之前不会计算得到的值。但事实上,已赋予的值和最终的值基本上总是相同的。
![]() |
---|
根据 XML 部署报告编写脚本时,请编写相应的脚本,以使用最终得到的值。 |
部署报告中的 Windows 应用程序
向应用程序关系图中添加 Windows 应用程序时,只有在指定的目标路径目录中生成的文件才是应用程序定义文件 (.sdm)。实现之前,该部署报告将会提供空的“目录”资源以及位于 Windows 应用程序下面的“操作系统”、“CLR”和“GAC”设置资源。实现之后,“目录”资源会显示源代码的路径。
![]() |
---|
如果在生成应用程序之前先实现 Windows 应用程序,然后生成部署报告,则在将“包括二进制文件”属性设置为 True 时,“错误列表”窗口中会显示一则警告,指示缺少可执行文件。若要解决此错误,请生成所需的项目。 |
部署报告中的 Web 应用程序
如果在实现 Web 应用程序之前生成部署报告,该报告中将会显示默认 Web.config 设置的列表。这些设置可以使用 Machine.config 配置文件进行填充。但是,在实现该应用程序之前,解决方案资源管理器中不会显示 Web.config 文件。实现之后,如果默认设置已修改或将资源添加到设置和约束编辑器的“配置”部分中,解决方案资源管理器中将会显示 Web.config 文件。有关更多信息,请参见 如何:指定 Web.config 设置。
部署报告中的泛型应用程序
因为泛型应用程序不支持代码生成,所以,不能实现这些应用程序。如果要对系统中 Windows 应用程序、Office 应用程序和 ASP.NET 应用程序之外的应用程序类型的存在进行记录,应该包括泛型应用程序。泛型应用程序可以部署在 Windows 和 IIS Web 服务器以及泛型逻辑服务器上。有关更多信息,请参见用于定义应用程序的应用程序类型和原型和逻辑数据中心设计器中的逻辑服务器原型。
对于 Windows、Web 或 Office 应用程序,如果将“包括内容文件”、“包括源文件”或“包括二进制文件”属性设置为 True,解决方案中包括的文件和程序集会被复制到用于部署的目标路径位置。但是,因为泛型应用程序不支持代码生成,所以,除 .sdm 文件之外,不会复制与其关联的任何文件或程序集。通过添加包含此信息的自定义设置,可以在部署报告中记录这些文件和程序集的位置。或者,可以为泛型应用程序创建包容关系。通过该关系,它可以包含 Windows、Web 和 Office 应用程序中包括的默认“文件”和“目录”资源。但是,即便添加“文件”和“目录”资源,也不会将这些项目复制到目标路径位置,因为这些项目不包含在解决方案内。有关更多信息,请参见 如何:创建应用程序、服务器、终结点和区域的自定义设置。