模板(应用程序部署示例)
本主题介绍如何使用“模板”示例来进行应用程序部署。
可以创建和使用两种类型的部署脚本来自定义 BizTalk 应用程序部署:预处理脚本和后期处理脚本。 预处理脚本在应用程序安装和导入开始前以及在卸载完成后调用。 后续处理脚本在应用程序安装和导入完成后以及在卸载开始前调用。
您可以编写预处理脚本和后续处理脚本,以便针对上述每项操作进行调用。 或者,您也可以将脚本配置为仅在其中一项操作后执行。 有关编写脚本的详细信息,请参阅 使用预处理和后处理脚本自定义应用程序部署。
本主题演示如何编写并部署脚本,使其仅在一项操作之前或之后调用。 具体方法是:编写一段脚本,此脚本通过检查三个环境变量的值来决定操作调用上下文中的操作。 根据此上下文,脚本将继续执行或停止执行。
本主题介绍如何执行以下步骤:
设置日志文件位置,以便生成脚本操作的日志文件。
注意
最佳做法是,始终生成日志文件以便验证脚本操作并解决任何问题。
新建一个 BizTalk 应用程序,并向该应用程序添加示例脚本。
导出包含应用程序项目的 .msi 文件。
从 BizTalk 组删除此应用程序,以便将此 .msi 文件导入回原来的组中,并从此 .msi 文件进行安装。
导入此应用程序,然后检查日志文件以查看是否已记录导入操作。
安装此应用程序,然后检查日志文件以查看是否已将安装日志附加到该日志文件中。
查看日志文件,注意脚本执行了哪些操作以及执行这些操作的时间。
本示例的用途
针对本示例提供的两个 .bat 文件包含用于导入、安装和卸载的环境变量的值。 SamplePreProcessing.bat 包含预处理脚本的变量。 SamplePostProcessing.bat 包含后处理脚本的变量。 这些文件还演示了如何记录来自脚本的消息。 您可以将这些文件的相关部分复制到脚本中。
重要
脚本文件中的某些注释不正确,具体如下:
在 SamplePreProcessing.bat 中,脚本注释“Pre uninstall part of the script called for an existing application”应为“Post uninstall part of the script called for an existing application”。
在 SamplePostProcessing.bat 中,脚本注释“Post uninstall part of the script called for an existing application”应为“Pre uninstall part of the script called for an existing application”。
本示例所在的位置
示例位于 BizTalk Server 安装文件夹中,如下所示:
<示例路径>\应用程序部署\模板
如前所述,本示例包括下列两个文件:
SamplePreProcessing.bat
SamplePostProcessing.bat
如何使用本示例
若要运行本示例,请执行下列步骤。
设置日志记录位置
打开这两个脚本示例并更改 LogFile 变量,使其指向日志文件的写入位置。 您必须提供包含文件名的完整路径。 如果该路径包含空格,则必须将该路径括在双引号 (") 中。
例如:
set LogFile=“<Samples Path>\ApplicationDeployment\Templates\SampleLogOut.txt”
新建应用程序
依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
在控制台树中,展开“BizTalk Server 管理”,然后展开 BizTalk 组。
右键单击“ 应用程序 ”,然后单击“ 新建”。
在 “应用程序名称”中,键入
SamplesTemplate
,然后单击“ 确定”。
将脚本添加到应用程序
展开刚刚创建的 SamplesTemplate 应用程序的文件夹,并在左窗格中右键单击“ 资源 ”。
指向 “添加 ”,然后单击“ 预处理脚本”。
单击“ 添加 ”并浏览到 SamplePreProcessing.bat。
选择该文件,然后单击“打开”。
在“ 文件类型”中,单击“ System.BizTalk:PreprocessingScript”,然后单击“ 确定”。
SamplePreProcessing.bat 将添加到应用程序中,并且显示在应用程序的“资源”文件夹中。
再次右键单击“资源”,指向“ 添加”,然后单击“ 后期处理脚本”。
单击“ 添加 ”并浏览到 SamplePostProcessing.bat。
选择该文件,然后单击“打开”。
在“ 文件类型”中,单击“ System.BizTalk:PostprocessingScript”,然后单击“ 确定”。
SamplePostProcessing.bat 将添加到应用程序中,并且显示在应用程序的“资源”文件夹中。
导出 .msi 文件
在BizTalk Server管理控制台中,右键单击 SamplesTemplate 应用程序,指向“导出”,然后单击“MSI 文件”。
在“欢迎使用导出向导”页上,单击“ 下一步”。
在“选择资源”页上,单击“ 下一步”。
在“指定 IIS 主机”页上,单击“ 下一步”。
在“依赖项”页上,单击“ 下一步”。
在“目标”页上的“ 目标应用程序名称”中,键入应用程序名称。
在 要生成的 MSI 文件中,键入 MSI 文件的完整路径,然后单击“ 导出”。 示例:C:\MSI\SamplesTemplate.msi
在 “概要” 页上,单击 “完成”。
删除应用程序
- 在BizTalk Server管理控制台中,右键单击 SamplesTemplate 应用程序,然后单击“删除”。
导入 .msi 文件
在BizTalk Server管理控制台中,右键单击“应用程序”,指向“导入”,然后单击“MSI 文件”。
在“欢迎使用导入向导”页上的 “要导入的 MSI 文件中,键入之前导出的 .msi 文件的路径,然后单击” 下一步”。 如有必要,可以通过单击 “ (...”) 按钮来浏览 MSI 文件。
在“应用程序设置”页上的“ 应用程序名称 ”下拉列表中,选择应用程序名称。
在 “要添加引用的可用应用程序”中,选择要向其添加引用的应用程序(如果有),然后单击“ 下一步”。
在“应用程序目标环境设置”页上,单击“ 下一步”。
注意
在本示例中,您无需指定目标环境。 有关此功能的背景信息,请参阅 绑定文件和应用程序部署。 有关添加绑定文件的说明,请参阅 如何将绑定文件添加到应用程序。
在“导入摘要”页上,确认摘要信息正确,然后单击“ 导入”。
在“结果”页上,单击“ 完成”。
打开执行脚本时创建的日志文件,并验证是否已记录导入操作。
安装应用程序
双击 .msi 文件并运行安装向导。
打开日志文件,并验证是否已将安装操作添加到日志纪录信息中。
验证脚本运行是否正常
- 打开日志文件,验证脚本在指定操作期间是否执行。