演练：部署基本 BizTalk 应用程序

项目
07/21/2023

Microsoft BizTalk Server 包括可简化 BizTalk 业务解决方案管理和部署的功能。它现在为企业解决方案中的各项（例如业务流程、架构、映射、管道和 .NET 程序集等）提供一个 BizTalk 应用程序容器。可以将应用程序中的所有项作为单个单元进行管理、修改、部署和安装。 BizTalk Server还包括帮助自动执行应用程序部署任务的向导。有关背景信息，请参阅应用程序部署和管理功能和应用程序部署和管理工具。

本演练提供使用BizTalk Server部署功能的分步说明，以便你可以了解它们如何协同工作。本演练中阐述的部署过程不一定反映在你的公司管理应用程序部署的方式。

在本演练中，你将创建一个简单的 BizTalk 应用程序，然后将它从开发环境部署到测试环境，再从那里部署到过渡环境和生产环境。在完成本演练后，你将了解如何执行以下任务：

在开发计算机上的 Visual Studio 中，使用 Deploy 命令将 BizTalk 程序集部署到 BizTalk Server 的本地实例。这将创建一个用这些程序集填充的 BizTalk 应用程序。 BizTalk 程序集将包含各种资源信息，例如要在 BizTalk 解决方案中使用的业务流程、管道、架构和映射。
在 BizTalk Server 管理控制台中，根据需要添加、创建、配置和删除 (称为项目的任何项，) 创建功能齐全的业务解决方案，例如发送和接收端口、策略、程序集和脚本。
使用导出、导入和安装向导，将 BizTalk 应用程序部署到某一测试计算机，以用于功能和系统测试。
使用导出、导入和安装向导，将应用程序部署到过渡服务器，以用于最终配置和部署到生产服务器。

必备条件

你可以采用以下两个选项之一来针对本演练设置你的测试环境：

你可以在单台计算机上执行本演练中的任务。
你可以通过设置不同的计算机以便分别用作部署、测试、过渡和生产计算机，更准确地模拟真实的部署。但是，本演练中涉及的任何任务都不应在实际生产环境中执行。

若要执行本演练中的这些步骤，请确保你的测试环境满足以下先决条件：
从中部署 BizTalk 程序集的开发计算机已安装 Microsoft Visual Studio。
本演练中所述的应用程序部署过程中使用的每台计算机（包括开发计算机）都已安装BizTalk Server。
每个 BizTalk Server 实例都是单独的安装；换言之，它具有自己的 BizTalk Server 数据库和组。

除了上述要求外，还需要提供包含 BizTalk 程序集的 Visual Studio 解决方案或项目。如果没有现有解决方案或项目，可以使用 BizTalk Server SDK 附带的 ErrorHandling 示例解决方案来实现此目的。在本演练的后面部分中包括有关使用此示例的说明。

在用于执行本演练中的任务的计算机上，您的用户帐户还必须是 BizTalk Server 管理员组以及本地管理员组的成员。

有关安装和配置BizTalk Server的详细信息，请参阅新增功能、安装、配置和升级。

假设

本演练假定以下内容：

你对BizTalk Server有基本的了解。 BizTalk Server入门应该会有所帮助。
你所使用的 BizTalk 程序集以前未部署到你的测试环境的应用程序中。如果已部署，则应该取消部署已部署了这些程序集的 BizTalk 应用程序。有关说明，请参阅取消部署 BizTalk 应用程序。
没有应用程序资源与其他应用程序共享。

读者

本演练面向的读者是：

BizTalk 应用程序开发人员。 开发人员可以了解如何在 Visual Studio 中设置项目属性，以及如何将 BizTalk 程序集从 Visual Studio 部署到 BizTalk 应用程序。开发人员还要了解如何将项目添加到应用程序、然后将应用程序导出到某一 .msi 文件。有关开发人员的应用程序部署任务的背景信息，请参阅 BizTalk 应用程序部署的开发任务。
BizTalk 应用程序测试人员。 测试人员可以了解如何将 .msi 文件导入到正在其测试计算机上运行的 BizTalk Server（将它注册为 BizTalk 应用程序）。然后，测试人员可以了解如何在测试计算机上安装应用程序以及如何验证安装。有关用于测试的应用程序部署任务的背景信息，请参阅 BizTalk 应用程序部署的测试任务。
BizTalk Server IT 管理员。 负责将 BizTalk 应用程序部署到过渡服务器和生产服务器的 IT 管理员可以了解此任务所需的基本步骤。有关 IT 管理员的应用程序部署任务的背景信息，请参阅 BizTalk 应用程序部署的暂存任务和 BizTalk 应用程序部署的生产任务。

本演练概述

本演练的目的是为了在实验室环境中部署一个 BizTalk 应用程序，以便评估在生产环境中部署此程序时这一技术的作用。本演练中包含的简单方案（在单台计算机上将单个 .msi 文件作为 BizTalk 应用程序部署）将帮助你熟悉在应用程序部署中涉及的基本任务。

注意

本演练并不提供应用程序正常运行所需的应用程序配置（例如绑定业务流程、配置端口等）指导。本演练只是为了介绍新的应用程序部署功能。

本文中提供的指导涵盖以下任务：

配置要求的权限。 在开始本演练之前，你需要确保具有执行各任务的相应权限。
从 Visual Studio 部署 BizTalk 程序集。 此步骤由应用程序开发人员执行。从 Visual Studio 内部署 BizTalk 程序集将自动生成程序集并将其内容部署到 BizTalk 应用程序中。如果该应用程序已不存在，则部署程序集也会创建该应用程序。该应用程序的项目将被注册，并且其数据存储在 BizTalk 管理数据库中。此外，默认情况下，这些程序集安装在本地计算机的全局程序集缓存 (GAC) 中。在创建该应用程序后，您可以从 BizTalk Server 管理控制台内查看和管理其项目。在管理控制台中，每个应用程序都存储在各自的文件夹中，并且子文件夹中将包含对该应用程序的所有项目的引用。
配置应用程序。 此步骤可由应用程序开发人员或 IT 管理员执行，以便添加、创建和配置为使应用程序正常工作所需的任何项目。从管理控制台中，你可以轻松地添加、创建、配置和删除项目，例如发送和接收端口、脚本和附加程序集。如果你对包含所需项目的应用程序感到满意并且正确配置了它们，则按下述内容将其导出到某一 .msi 文件中。
将应用程序导出到 .msi 文件。 此步骤可由开发人员、测试人员或 IT 管理员执行，以便生成可用于将 BizTalk 应用程序部署到不同环境中的 .msi 文件。例如，开发人员可以将某一 .msi 文件导出，测试人员可使用该 .msi 文件将应用程序部署到测试服务器中。在测试完成后，IT 管理员可以使用经过测试的 .msi 文件将应用程序部署到过渡或生产服务器中（如下文所述）。本演练介绍如何使用导出向导（在 BizTalk Server 管理控制台中提供）将某一应用程序导出到 .msi 文件中。
从 .msi 文件导入和安装应用程序。 此步骤可由测试人员或 IT 管理员执行，以便将 BizTalk 应用程序部署到过渡或生产服务器。例如，测试人员可以将应用程序从开发人员提供的 .msi 文件导入测试计算机上的 BizTalk 组，然后从该 .msi 文件安装此应用程序以便对其进行测试。同样，IT 管理员可以将应用程序从测试人员提供的 .msi 文件部署到过渡或生产服务器上。本演练介绍如何使用导入向导将该 .msi 文件导入到 BizTalk 组中的应用程序。与第 2 步中一样，注册该应用程序的项目并且将其数据存储于 BizTalk Server 数据库中。本演练还介绍如何通过使用安装向导或通过双击该 .msi 文件，将该应用程序安装到当前服务器上。这将允许你在当前服务器上运行该应用程序。

部署 BizTalk 应用程序的分步指南

本部分介绍部署 BizTalk 应用程序的分步过程，包括从开发到测试、过渡和生产的所有阶段。如前所述，你可以在同一台计算机上执行所有这些步骤，但也可以在多台计算机上执行，以便更准确地模拟你的环境。

1. 配置权限

第一步是要确保你具有执行本演练中各任务的相应权限。请参阅部署和管理 BizTalk 应用程序所需的权限和最低安全权限。

2.部署 BizTalk 程序集

在开发计算机上的 Microsoft Visual Studio 中，使用此步骤中的过程将 BizTalk 程序集部署到 BizTalk 应用程序中。

在开始之前，您必须在 Visual Studio 中已具有某一 BizTalk 解决方案。可以创建自己的解决方案或项目，也可以设置BizTalk Server随附的 ErrorHandling 示例。可以在 Visual Studio 中设置 ErrorHandling 示例解决方案，如下所示：

设置 ErrorHandling 解决方案

在开发计算机上，导航到：

\Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\Samples\Messaging\ErrorHandling\ErrorHandler
双击 ErrorHandler.btproj。

ErrorHandler 解决方案将在 Visual Studio 中打开。此解决方案由两个项目组成：ErrorHandler 和 PipelinesAndSchemas。

接下来，你必须为该解决方案中的每个项目都设置属性。 ErrorHandling 示例解决方案包括两个应为其设置属性的项目：ErrorHandler 和 PipeLinesAndSchemas。配置属性以反映开发计算机的环境。例如，你指定的 SQL 服务器应该是在开发计算机上运行的实例，并且是本地 BizTalk 管理数据库的宿主。

配置项目属性

在 Visual Studio 解决方案资源管理器中，右键单击要为其配置属性的项目，然后单击“属性”。
单击 Project Designer 中的“部署”选项卡。

属性表

按下表中所述配置项目属性，然后单击“ 确定”。

属性	值	说明
应用程序名称	<名称>	用于将此项目中的程序集部署到的 BizTalk 应用程序的名称。如果该应用程序已存在，则在你部署该项目时这些程序集将添加到该应用程序中。如果该应用程序不存在，则将创建该应用程序。如果此字段为空，则这些程序集将部署到当前组中的默认 BizTalk 应用程序（默认情况下为“BizTalk Application 1”）中。包含空格的名称必须括在双引号 (") 中。
配置数据库	<BizTalk 管理数据库名称>	用于组的 BizTalk 管理数据库的名称，默认情况下为 BizTalkMgmtDb。
服务器	<服务器名称>	作为本地计算机上 BizTalk 管理数据库宿主的 SQL Server 实例的名称。在单台计算机安装中，该名称通常是本地计算机的名称。注意：如果将此 BizTalk 项目移动到其他计算机，则需要修改 Server 属性以反映新的计算机名称，然后才能部署程序集。
重新部署	是或否	如果将此项设置为 True（默认设置），你将能够在不更改版本号的情况下重新部署 BizTalk 程序集。
安装到全局程序集缓存	是或否	如果将此项设置为 True（默认设置），则可以在部署程序集时将程序集安装到本地计算机上的全局程序集缓存 (GAC) 中。
重新启动主机实例	是或否	如果将此项设置为 True，则可以在重新部署程序集时自动重新启动在本地计算机上运行的所有主机实例。如果将此项设置为 False（默认设置），则必须在你重新部署某一程序集时手动重新启动这些主机实例。注意：如果要从解决方案级别重新部署程序集，则将为此选项设置为 True 的每个项目重启一次主机实例。这样可能导致多次重新启动。如果计划在解决方案级重新部署，你可能希望针对解决方案中的一个项目将此属性设置 True，以避免多次主机实例重新启动。此设置应针对将在解决方案中重新部署的最后一个项目进行。此外，如果在你执行重新部署时，主机实例停止，它将不会被启动。
启用单元测试	是或否	指定是否启用项目的单元测试。

对于解决方案中的每个项目，重复执行步骤 1、2 和 3。

部署过程要求程序集是强签名的。你可以通过将该项目与一个强名称程序集密钥文件相关联，使你的程序集成为强名称程序集。如果尚未这样做，则使用以下过程生成一个强名称程序集密钥文件。

创建强名称程序集密钥文件

启动 Visual Studio 命令提示符。
在命令提示符下，从你要存储密钥文件的文件夹，键入以下命令，然后按 Enter 键：

sn -kfile_name.snk

示例： sn -k ErrorHandling.snk

命令行上会显示一条确认消息，即写入 file_name.snk>, 的密钥<对。

接下来，你需要将解决方案中的每个项目都与密钥文件相关联。

将你的项目与密钥文件相关联

在 Visual Studio 解决方案资源管理器中，右键单击项目，然后单击“属性”。
单击 Project Designer中的“签名”选项卡。
在右窗格中，检查“为程序集签名”框。
单击“ 选择强名称密钥文件”下的下拉框，单击“ <浏览...”>，然后浏览到密钥文件。
单击密钥文件，然后单击“ 打开”。
对于你的解决方案中的每个项目，重复执行步骤 1 到 5。

现在，你可以按如下所示通过一步在解决方案中生成和部署所有程序集。

在解决方案中部署程序集

在 Visual Studio 解决方案资源管理器中，右键单击解决方案，然后单击“部署解决方案”。

生成和部署过程的状态显示在该页的左下角中。如果你在使用 ErrorHandling 示例解决方案，则在输出窗口中将显示几个警告消息。就本演练的目的而言，你可以忽略这些警告。部署完成后，Visual Studio“输出”窗口中会显示“部署：2 成功，0 失败，0 已跳过”。

部署 BizTalk 程序集可将它们作为 BizTalk 管理数据库中指定 BizTalk 应用程序的一部分注册。它还使用程序集中包含的所有项或项目填充数据库。如果该应用程序在部署前已不存在，则此步骤还创建新的应用程序。您现在可以从开发计算机上的 BizTalk Server 管理控制台内查看 BizTalk 应用程序和其项目。

查看 BizTalk 应用程序和其项目

依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”、“BizTalk Server管理”。
在控制台树中，依次展开“BizTalk Server管理”、“BizTalk 组”和“应用程序”。
展开你刚部署了程序集的应用程序的文件夹。
单击该应用程序文件夹下的文件夹，以查看其内容。在相应的文件夹中，你应该看到在部署的程序集中已包含的项目。如果你部署了 ErrorHandling 示例 BizTalk 解决方案，则应在“业务流程”、“架构”和“资源”文件夹中看到项目。可以右键单击项目并单击“ 属性” 以查看其配置设置。
展开 “资源” 文件夹，右键单击其中一个程序集，然后单击“ 修改”。
在 “选项 ”框中，记下为程序集配置的部署选项。
在 “目标位置”中，记下安装应用程序时将复制程序集文件的位置的路径。默认情况下，该位置是程序集的源位置。

注意

如果应用程序未显示，请右键单击“ BizTalk 组 ”，然后单击“ 刷新”。

有关部署程序集的详细信息，请参阅将 BizTalk 程序集从 Visual Studio 部署到 BizTalk 应用程序中。

3.配置应用程序

在 BizTalk Server 管理控制台中，可以通过创建、添加和配置项目来配置应用程序。

为使应用程序正常运行，必须正确配置该应用程序。例如，业务流程必须绑定到某一主机，并且必须配置有发送端口和接收位置。如果你部署了 ErrorHandling 示例解决方案，则请注意，该应用程序没有发送端口、接收端口或接收位置。这意味着，这些业务流程不能发送或接收消息。有关配置应用程序的指导已超出了本演练的范围。不过，如果你想进行配置，最快的方法就是使用“配置应用程序”对话框，你可以通过右键单击应用程序并单击“配置”来访问该对话框。有关详细信息，请参阅如何配置应用程序。除了此方法之外，你还可以配置业务流程，以及单独创建、配置和删除发送端口、发送端口组、接收端口和接收位置。有关详细信息，请参阅管理项目中的相应主题。

你可能还想要添加到你的应用程序项目中（例如预处理脚本或自述文件），或者想要删除项目。你可以使用以下过程尝试此功能。（ErrorHandling 示例并不包括你可以添加的附加项目；但你可以通过添加已在你的环境中存在的项，测试此功能。）

注意

你可以使用预处理和后处理脚本，在应用程序导入、安装或卸载之前或之后执行操作。例如，可能要在卸载后使用预处理脚本从 GAC 卸载程序集。有关详细信息，请参阅使用预处理和后处理脚本自定义应用程序部署。

向应用程序添加项目

打开BizTalk Server管理控制台。依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
在控制台树中，依次展开“BizTalk Server管理”、“BizTalk 组”和“应用程序”。
若要添加以下类型的项目，请右键单击 ErrorHandling 应用程序文件夹，然后单击“ 添加”。请注意，在你添加某一 BizTalk 程序集时，它所包含的项目也会添加到该应用程序的相应文件夹中。
- BizTalk 程序集
- 预处理脚本
- 后处理脚本
- 资源 (BizTalk 程序集、.NET 程序集、预处理脚本、后处理脚本、文件、证书、COM 组件。BAM 项目、绑定文件和虚拟目录)
- 策略
你也可以从应用程序中删除项目。

从应用程序中删除项目

打开BizTalk Server管理控制台。依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
在控制台树中，依次展开“BizTalk Server管理”、“BizTalk 组”和“应用程序”。
展开包含项目的文件夹，右键单击项目，然后单击“ 删除”。

有关配置应用程序的详细信息，请参阅创建和修改 BizTalk 应用程序。

4. 导出应用程序

在您创建了某一 BizTalk 应用程序并根据需要进行修改后，可以通过使用 BizTalk Server 管理控制台中的导出 MSI 文件向导导出该应用程序。这将生成一个 .msi 文件，你以后可将此文件导入到其他 BizTalk 组中，以在新组中重新创建该应用程序。若要在特定服务器上运行该应用程序，还必须通过 .msi 文件从本地安装它。

导出应用程序

打开BizTalk Server管理控制台。依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
在控制台树中，依次展开“BizTalk Server管理”、“BizTalk 组”和“应用程序”。
右键单击 BizTalk 应用程序，指向 “导出”，然后单击“ MSI 文件”。
在 “欢迎使用导出 MSI 文件向导” 页上，单击“ 下一步”。
在 “选择资源” 页上，选择要导出到 .msi 文件的资源，然后单击“ 下一步”。就本演练而言，你可以接受显示的默认值。
如果出现提示，请在“ 指定 IIS 主机” 页上，键入托管要包含的虚拟目录的计算机的服务器名称，然后单击“ 下一步”。仅当先前没有将虚拟目录添加到 BizTalk 管理数据库时（比如将虚拟目录添加到应用程序或将其导入应用程序时），系统才会提示你指定服务器。

注意

在 ErrorHandling 示例解决方案中没有包括任何虚拟目录。
在 “依赖项 ”页上，查看应用程序的依赖项，然后单击“ 下一步”。
在“ 目标 ”页上的“ 目标应用程序名称”中，键入应用程序名称。
在 要生成的 MSI 文件中，键入 .msi 文件的完整路径，然后单击“ 导出”。示例：C:\MSI\Errorhandling.msi

注意

建议你将 .msi 文件存储在安全的文件夹中。
在 “摘要 ”页上，记下此操作的日志文件的位置，然后单击“ 完成”。

在文件系统中，确认已在你指定的位置中创建了该 .msi 文件。

注意

为安全起见，在导出应用程序的过程中，密码从应用程序绑定中删除。从 .msi 文件安装应用程序后，需要重新配置密码，以便使应用程序可以正常运行。不过，密码并没有被从添加到应用程序中的任何绑定文件中删除。

有关导出应用程序和项目的详细信息，请参阅如何导出 BizTalk 应用程序。

5.导入并安装应用程序

下一步骤是要将应用程序从你刚生成的 .msi 文件导入某一 BizTalk 组，并且还在本地计算机上安装该应用程序。您可以使用 BizTalk Server 管理控制台中的导入 MSI 向导和安装向导执行此操作。

注意

该应用程序必须安装在将运行该应用程序的组中的每台计算机上。你可以双击该 .msi 文件以便将它安装在其他计算机上。

每次你要将一个应用程序从一个 BizTalk 组迁移到另一个组时（例如，在从开发环境迁移到测试环境时、从测试环境迁移到过渡环境时或从过渡环境迁移到生产环境时），都可以重复该步骤中的任务。

此时，如果你只使用一台计算机用于本演练，则应从 BizTalk 组中删除该应用程序。你还应从全局程序集缓存 (GAC) 中删除这些程序集。这样，在你导入应用程序时，将能够确认它已正确重新创建。如果你将多台计算机用于本演练，则无需执行这些任务。

从 BizTalk 组中删除应用程序

打开BizTalk Server管理控制台。依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
右键单击该应用程序，然后单击“ 删除”。

从 GAC 中删除程序集

在文件系统中，导航到 %systemdrive%\Windows\assembly。
右键单击为解决方案生成的每个程序集文件，单击“ 卸载”，然后单击“ 是 ”进行确认。例如，与 ErrorHandling 项目相关联的程序集文件是 ErrorHandling.ErrorHandler 和 ErrorHandling.PipelinesAndSchemas。

中删除程序集

现在，你可以将应用程序导入 BizTalk 组中了。如果你想要将该应用程序导入在其他计算机上运行的某一 BizTalk 组中，则该 .msi 文件必须可从其他计算机访问。

注意

在安装任何应用程序之前，请确保接收的 .msi 文件来自可信来源。恶意用户可在 .msi 文件中包括代码，可能会对系统或网络造成不良影响。有关详细信息，请参阅安全性和 Windows 安装程序。

导入并安装应用程序

打开要导入应用程序的BizTalk Server实例的BizTalk Server管理控制台。依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
在控制台树中，展开“BizTalk Server管理”，然后展开“BizTalk 组”。
右键单击“ 应用程序”，指向“ 导入”，然后单击“ MSI 文件”。
在 “欢迎使用导入向导” 页上的 “要导入的 MSI 文件中，键入 .msi 文件的完整路径，然后单击” 下一步”。示例：C:\msi\MyApplication.msi
在 “应用程序设置” 页上的 “要添加引用的可用应用程序”中，选择要向其添加引用的应用程序，然后单击“ 下一步”。如果你在使用 ErrorHandling 示例解决方案，则可以接受默认值。

引用
在“ 应用程序目标环境设置” 页上，确认 <已选择“默认值> ”，然后单击“ 下一步”。
在 “导入摘要 ”页上，确认摘要信息正确，然后单击“ 导入”。
在“导入 MSI 向导”的最后一个屏幕上，选择“ 运行应用程序安装向导”以在本地计算机上安装该应用程序，然后单击“ 完成”。

开始安装
在 “选择安装文件夹” 页上的 “文件夹”中，键入 BizTalk 应用程序的安装路径，然后单击“ 下一步”。
单击接下来三个页面上的“ 下一步 ”以继续安装。

Windows Installer 会将该应用程序安装在本地计算机上。
在 “安装完成 ”页上，单击“ 关闭”。

有关导入应用程序的详细信息，请参阅如何导入 BizTalk 应用程序。有关安装应用程序的详细信息，请参阅如何安装 BizTalk 应用程序。

接下来，你可以通过验证以下内容，确保该应用程序已导入和安装：

该应用程序及其所有项目均存在于管理控制台的该应用程序的文件夹中。
应用程序的程序集存在于 GAC 中。
与该应用程序相关联的文件存在于你安装该应用程序时指定的路径中。
该应用程序显示在“添加或删除程序”控制面板中。
如果已将应用程序配置为可以正常运行（例如通过指定发送和接收端口），则现在可以通过右键单击应用程序并单击“ 启动”来启动该应用程序。但默认情况下，ErrorHandling 示例应用程序没有设置为可供使用。因此，除非你已手动配置它，否则，将不能启动它。
若要从 BizTalk 组和本地计算机中完全删除应用程序，请按照取消部署 BizTalk 应用程序中的说明进行操作。

另请参阅

了解 BizTalk 应用程序的部署和管理