更新2014-01-28
VS / Azure SDKのバージョンの変更に合わせてカスタムスクリプトを最新の状態に保つのは大変な作業でした。そのため、実際には、生成されdeploy.cmd
たスクリプトの使用に戻りましたが、わずかな違いが1つあります。
私はすべてのパラメーター値をProfileName.pubxml
ファイルから除外し、代わりにそれらを(パッケージでProfileName.paramters.xml
生成された例、ここのドキュメント)に入れ始めました。これらは、慣例によりVisual Studio / MSBuildによって自動的に取得され、呼び出し時に渡すことで実行時に使用できます。.SetParameters.xml
-setParamFile:path\to\ProfileName.parameters.xml
deploy.cmd
更新-このスクリプトの新しいバージョンがGitHubで維持(および文書化)されています-https ://github.com/richardszalay/msdeploy-package-publish
よく調べてみると、Microsoft.Web.Publishing.targets(v10.5)にいくつかの問題があり、これが機能しないことがわかりました。これらの問題を回避するために、Webアプリケーションのcsprojと同じディレクトリに配置できる次のMSBuildスクリプトを作成しました。修正と実装の詳細に関連するコメントを追加しました。
スクリプトはMicrosoft.Web.Publishing.targetsを使用するため、ほとんどの標準プロパティは引き続き機能します。これを使用するいくつかの方法があります:
# Convention based
msbuild PackageDeploy.build /p:PublishProfile=Stage;WebPublishPipelineProjectName=Name_of_your_web_application
# Absolute paths to profile + package
msbuild PackageDeploy.build /p:PublishProfile=Path\To\Profile.pubxml;PackageFileName=Path\To\Package.zip;WebPublishPipelineProjectName==Name_of_your_web_application
VS2012を使用している場合はVisualStudioVersion=v11.0
、正しい公開ファイルをインポートすることを宣言していることを確認してください。
このスクリプトを使用すると、デプロイメントパイプラインの後続の段階でWebアプリケーションを再チェックアウトする必要はありません。ビルド/パッケージ段階の後、次のアーティファクトを保持する必要があります。
- PackageDeploy.build(下記)
- 公開プロファイル
- Webアプリケーションパッケージのzip
PackageDeploy.buildのソースは次のとおりです。
<!--
This build script supports deployment of a website package to a publish profile without rebuilding the project or package
If placed in the same directory as a web project that uses publish profiles, the following arguments will need to be defined:
Convention based required arguments:
PublishProfile: the name of the publish profile (or a path to a pubxml file if using non-convention based)
Configuration: Debug/Release
Convention based optional arguments:
VisualStudioVersion: Property specific to this build script that determines which WPP version to use (v10.5 [default] for VS2010+Azure updates, v11.0 for VS2012)
WebPublishPipelineProjectName:
WebPublishPipelineProjectDirectory: The root to the web project directory if this build script isn't there and PublishProfile isn't a path (to auto-detect publish profile directory)
Non-convention based optional arguments:
PackageFileName: The full path to the website package zip
UseDeclareParametersXMLInMsDeploy: true to save the parameters to a file and then use that file; false to inline the parameters
UseMsDeployExe: true to use msdeploy.exe; false to use the VS MSBuild task
-->
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" DefaultTargets="DeployFromPackage">
<PropertyGroup>
<!-- IMPL: Set this to v11.0 to use VS2012 -->
<VisualStudioVersion>v10.5</VisualStudioVersion>
</PropertyGroup>
<PropertyGroup>
<!-- IMPL: Declared in Microsoft.Web.Publishing.targets, but we need to declare PublishProfileRootFolder before it's imported -->
<WebPublishPipelineProjectDirectory Condition="'$(WebPublishPipelineProjectDirectory)'==''">$(MSBuildProjectDirectory)</WebPublishPipelineProjectDirectory>
<!-- IMPL: Usually detected by ".csproj" vs ".vbproj", but PackageDeploy.build is neither -->
<PublishProfileRootFolder Condition="'$(PublishProfileRootFolder)' == '' and Exists('My Project\PublishProfiles')">$(WebPublishPipelineProjectDirectory)\My Project\PublishProfiles</PublishProfileRootFolder>
<PublishProfileRootFolder Condition="'$(PublishProfileRootFolder)' == '' and Exists('Properties\PublishProfiles')">$(WebPublishPipelineProjectDirectory)\Properties\PublishProfiles</PublishProfileRootFolder>
</PropertyGroup>
<!-- IMPL: Select the correct version of Microsoft.Web.Publishing.targets (usually done by the csproj via WebApplication.targets) -->
<Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\$(VisualStudioVersion)\Web\Microsoft.Web.Publishing.targets" />
<!-- FIX: MSDeployPublish depends on building the package (can be skipped by clearing MSDeployPublishDependsOn) -->
<!-- IMPL: ImportPublishingParameterValues transforms all the MSDeployParameterValue+ParameterValue to MsDeployDeclareParameters+Value -->
<Target Name="DeployFromPackage" Condition="'$(PublishProfile)' != ''" DependsOnTargets="ImportPublishingParameterValues">
<PropertyGroup>
<_PublishMsDeployServiceUrl>$(MsDeployServiceUrl)</_PublishMsDeployServiceUrl>
<_PublishMsDeployServiceUrl Condition="('$(MSDeployPublishMethod)'=='INPROC')"></_PublishMsDeployServiceUrl>
</PropertyGroup>
<ItemGroup>
<!-- IMPL: Always uses "package" source -->
<MsDeploySourceProviderSetting Remove="@(MsDeploySourceProviderSetting)" />
<MsDeploySourceProviderSetting Include="package">
<Path>@(_MSDeployPackageFile->'%(FullPath)')</Path>
<EncryptPassword>$(DeployEncryptKey)</EncryptPassword>
<WebServerAppHostConfigDirectory>$(_MSDeploySourceWebServerAppHostConfigDirectory)</WebServerAppHostConfigDirectory>
<WebServerManifest>$(_MSDeploySourceWebServerManifest)</WebServerManifest>
<WebServerDirectory>$(_MSDeploySourceWebServerDirectory)</WebServerDirectory>
</MsDeploySourceProviderSetting>
<MsDeployDestinationProviderSetting Remove="@(MsDeployDestinationProviderSetting)" />
<MsDeployDestinationProviderSetting Include="auto">
<Path></Path>
<ComputerName>$(_PublishMsDeployServiceUrl)</ComputerName>
<UserName>$(UserName)</UserName>
<Password>$(Password)</Password>
<EncryptPassword>$(DeployEncryptKey)</EncryptPassword>
<IncludeAcls>False</IncludeAcls>
<AuthType>$(AuthType)</AuthType>
<WebServerAppHostConfigDirectory>$(_MSDeployDestinationWebServerAppHostConfigDirectory)</WebServerAppHostConfigDirectory>
<WebServerManifest>$(_MSDeployDestinationWebServerManifest)</WebServerManifest>
<WebServerDirectory>$(_MSDeployDestinationWebServerDirectory)</WebServerDirectory>
</MsDeployDestinationProviderSetting>
</ItemGroup>
<!--Debug/Diagnostic message is not localized-->
<Message Text="MSDeployPublish MsDeploySourceProviderSetting is @(MsDeploySourceProviderSetting)" Condition="$(EnablePackageProcessLoggingAndAssert)" />
<Message Text="MSDeployPublish MsDeployDestinationProviderSetting is @(MsDeployDestinationProviderSetting)" Condition="$(EnablePackageProcessLoggingAndAssert)"/>
<ExportParametersFile
Condition="!$(UseDeclareParametersXMLInMsDeploy) And $(EnablePackageProcessLoggingAndAssert)"
Parameters="@(MsDeployDeclareParameters)"
DeclareSetParameterFile="$(PackageLogDir)\MSDeployPublish.parameters.xml"
GenerateFileEvenIfEmpty="True"
/>
<!--First delete the ParameterFile-->
<Delete Files="$(PublishParametersFile)" Condition="Exists($(PublishParametersFile))" ContinueOnError="true"/>
<!-- FIX: Use SetParameterFile (rather than DeclareSetParameterFile), which isn't used anywehere in Microsoft.Web.Publishing.targets -->
<ExportParametersFile
Parameters="@(MsDeployDeclareParameters)"
SetParameterFile="$(PublishParametersFile)"
GenerateFileEvenIfEmpty="True"
Condition="$(UseDeclareParametersXMLInMsDeploy)"
/>
<PropertyGroup>
<_VsPublishParametersFile></_VsPublishParametersFile>
<_VsPublishParametersFile Condition="$(UseDeclareParametersXMLInMsDeploy) and '$(_VsPublishParametersFile)'==''">$(PublishParametersFile)</_VsPublishParametersFile>
</PropertyGroup>
<ItemGroup Condition="!$(UseDeclareParametersXMLInMsDeploy)">
<_VsPublish_MsDeployDeclareParameters Remove="@(_VsPublish_MsDeployDeclareParameters)" />
<_VsPublish_MsDeployDeclareParameters Include="@(MsDeployDeclareParameters)" />
<!-- IMPL: Utilising the real version of this has way too much baggage (simplifying it could have repercussions, though) -->
<_VsPublish_MsDeployDeclareParameters Include="$(DeployParameterIISAppName)" Condition="'$(DeployIisAppPath)' != ''">
<Value>$(DeployIisAppPath)</Value>
</_VsPublish_MsDeployDeclareParameters>
</ItemGroup>
<!-- FIX: Microsoft.Web.Publishing.targets uses "SetParameterItems", which doens't appear to work. This uses SimpleSetParameterItems instead -->
<VSMSDeploy
Condition="!$(UseMsdeployExe)"
MSDeployVersionsToTry="$(_MSDeployVersionsToTry)"
Source="@(MsDeploySourceProviderSetting)"
Destination="@(MsDeployDestinationProviderSetting)"
DisableLink="$(PublishDisableLinks)"
EnableLink="$(PublishEnableLinks)"
AllowUntrustedCertificate="$(AllowUntrustedCertificate)"
BuildingInsideVisualStudio="$(BuildingInsideVisualStudio)"
SkipExtraFilesOnServer="$(SkipExtraFilesOnServer)"
SkipRuleItems="@(MsDeploySkipRules)"
OptimisticParameterDefaultValue="$(EnableOptimisticParameterDefaultValue)"
SimpleSetParameterItems="@(_VsPublish_MsDeployDeclareParameters)"
ImportSetParametersItems="$(_VsPublishParametersFile)"
RetryAttempts="$(RetryAttemptsForDeployment)"
InvokedByPublish="true"
>
<Output TaskParameter="Result" PropertyName="_PublishResult" />
</VSMSDeploy>
<!-- FIX: Microsoft.Web.Publishing.targets uses "SetParameterItems", which doens't appear to work. This uses SimpleSetParameterItems instead -->
<MSdeploy
Condition="$(UseMsdeployExe)"
Verb="sync"
Source="@(MsDeploySourceProviderSetting)"
Destination="@(MsDeployDestinationProviderSetting)"
DisableLink="$(PublishDisableLinks)"
EnableLink="$(PublishEnableLinks)"
EnableRule="$(MsDeployDoNotDeleteRule)"
AllowUntrusted="$(AllowUntrustedCertificate)"
SkipRuleItems="@(MsDeploySkipRules)"
OptimisticParameterDefaultValue="$(EnableOptimisticParameterDefaultValue)"
SimpleSetParameterItems="@(_VsPublish_MsDeployDeclareParameters)"
ImportSetParametersItems="$(_VsPublishParametersFile)"
RetryAttempts="$(RetryAttemptsForDeployment)"
ExePath="$(MSDeployPath)" />
</Target>
</Project>