创建并运行部署命令文件

作者： Jason

下载 PDF

本主题介绍如何生成一个命令文件，该文件将允许使用 Microsoft 生成引擎（MSBuild）项目文件作为单步骤、可重复的过程运行部署。

本主题介绍一系列教程的一部分，这些教程基于名为 Fabrikam，Inc. 的虚构公司的企业部署要求。本教程系列使用一个示例解决方案—，该解决方案使用—联系人管理器解决方案来表示具有真实复杂性级别的 WEB 应用程序，包括 ASP.NET MVC 3 应用程序、Windows Communication Foundation （WCF）服务和数据库项目。

这些教程核心的部署方法基于理解生成过程中所述的拆分项目文件方法，其中，生成过程由两个项目文件—控制，其中一个包含适用于每个目标环境的生成说明，另一个包含特定于环境的生成和部署设置。 在生成时，特定于环境的项目文件将合并到环境无关的项目文件中，以形成一组完整的生成说明。

流程概述

在本主题中，你将了解如何创建并运行一个命令文件，该文件使用这些项目文件来执行目标环境的可重复部署。 实质上，命令文件只需包含以下 MSBuild 命令：

• 指示 MSBuild 执行环境无关的Publish文件。
• 指示Publish文件，其中包含特定于环境的项目设置以及在何处可以找到它。

创建 MSBuild 命令

如了解生成过程中所述，环境特定的项目文件（例如，环境—特定的项目文件—）设计为在生成时导入到与环境无关的Publish文件中。 这两个文件一起提供了一组完整的说明，告诉 MSBuild 如何生成和部署解决方案。

Publish文件使用import元素导入特定于环境的项目文件。

<Import Project="$(TargetEnvPropsFile)"/>

因此，当你使用 Msbuild.exe 生成并部署 Contact Manager 解决方案时，你需要：

• 在Publish文件上运行 msbuild.exe。
• 通过提供名为TargetEnvPropsFile的命令行参数来指定环境特定的项目文件的位置。

为此，MSBuild 命令应如下所示：

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj

从这里开始，这是一个简单的步骤，可以将其迁移到可重复的单步部署。 只需将 MSBuild 命令添加到 .cmd 文件即可。 在 "联系人管理器" 解决方案中，"发布" 文件夹包含一个名为 "Publish-Dev" 的文件，该文件执行此命令。

%windir%\Microsoft.NET\Framework\v4.0.30319\msbuild.exe Publish.proj /fl /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj
echo 
pause

若要部署或重新部署 Contact Manager 解决方案，只需运行Publish-Dev文件。 运行该文件时，MSBuild 将：

• 生成解决方案中的所有项目。
• 为 web 应用程序项目生成可部署的 web 包。
• 为数据库项目生成 .dbschema 和 deploymanifest 文件。
• 将 web 包部署到 web 服务器。
• 将数据库部署到数据库服务器。

运行部署

为目标环境创建了命令文件后，只需运行该文件就能完成整个部署。

将 Contact Manager 解决方案部署到测试环境

1. 在开发人员工作站上，打开 Windows 资源管理器，然后浏览到Publish-Dev文件的位置。

2. 双击该文件以运行该文件。

3. 如果出现 "打开文件–安全警告" 对话框，请单击 "运行"。

4. 如果正确设置了配置设置和测试服务器，则 "命令提示符" 窗口将在 MSBuild 完成项目文件处理后显示 "生成成功" 消息。

   

5. 如果这是你第一次将解决方案部署到此环境中，则需要将测试 web 服务器计算机帐户添加到ContactManager数据库上db_datawriter和db_datareader角色。 为Web 部署发布配置数据库服务器中介绍了此过程。

   Note

   仅需在创建数据库时分配这些权限。 默认情况下，生成过程将不会在每次部署—时重新创建数据库，而是将现有数据库与最新架构进行比较，并仅进行所需的更改。 因此，在首次部署解决方案时，只需映射这些数据库角色。

6. 打开 Internet Explorer 并浏览到联系人管理器应用程序的 URL （例如 http://testweb1:85/ContactManager/）。

7. 验证应用程序是否按预期工作，以及是否能够添加联系人。

   

结束语

通过创建包含 MSBuild 说明的命令文件，可以快速轻松地构建多项目解决方案并将其部署到特定目标环境。 如果需要反复将解决方案部署到多个目标环境，可以创建多个命令文件。 在每个命令文件中，MSBuild 命令将生成相同的通用项目文件，但它会指定其他特定于环境的项目文件。 例如，要发布到开发人员或测试环境的命令文件可能包含以下 MSBuild 命令：

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj

要发布到过渡环境的命令文件可能包含以下 MSBuild 命令：

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Stage.proj

还可以通过在 MSBuild 命令中重写属性或设置各种其他开关，为每个环境自定义生成过程。 有关详细信息，请参阅MSBuild 命令行参考。