[NPANDAY-488] Packaging for Web Applications (also Azure Web Roles)

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.4-incubating
• Fix Version/s: 1.5.0-incubating
• Component/s: Maven Plugins, Visual Studio Add-in
• Assignee: Lars Corneliussen
• Reporter: Lars Corneliussen
• Created: 22/Nov/11 17:03
• Updated: 02/May/13 02:29
• Resolved: 19/Apr/12 08:53

Description

MSDeploy is an extensible tool for creating deployment packages, which then can be deployed to IIS (or Windows Services, e.g.)

This is also a prerequisite for Azure Web Roles.

High-level Requirements

• Must support Package creation
• Must support full MSDeploy feature set (through -source:manifest?)
• Must choose reasonable defaults for file inclusion
• Must be configurable from the VS Add-in
• Should support XDT transformations
• Should support filtering (Maven-Properties)
• Should support Parametrization (through -declareParamFile)
• Should make it hard to let default connection strings and passwords "leak" into the package

Implementation Details

• instead of reinventing the wheel, we could utilize maven-assembly-plugin:single with package-type "dir"
  • or: Syntax should be similar to maven-assembly-plugin; maybe code reuse is possible?
  • Externalized descriptors for file-inclusions should be possible (NPanday then provides reasonable defaults)
• Package type is named msdeploy-package with extension msdeploy.zip (must end with .zip)
• XDT should be delegated to MSBuild (partially depends on NPANDAY-486)

Flow

To test how this could work out, I used default Maven/NPanday tools + registration of msdeploy-package as msdeploy.zip. Then, as soon as we know how this should exactly work, we can start creating the needed plugins.

prepare-package

• assembly:single -> target/prepare-package/01-source-raw
  • includes dotnet-library dependencies in bin
  • includes *.as?x + config + css + js + graphics

• exec:exec: msbuild copy-transformed.xml -> XDT-Transforms using *.package.config -> target/prepare-package/03-transformed

• (Optional) exec:exec -> msdeploy - apply parameter configuration
  • This would avoid leaking developer default values into the package

package

• exec:exec: msdeploy -verb:sync -source:dirPath=target/prepare-package/03-transformed -dest:package=target/${artifactId}.msdeploy.zip

• build-helper:attach artifact target/${artifactId}.msdeploy.zip as msdeploy-package

Build runs locally:

[INFO] Installing target\HelloWorld_WebRole.dll to .m2\...\HelloWorld_WebRole\1.0.0-SNAPSHOT\HelloWorld_WebRole-1.0.0-SNAPSHOT.dll
[INFO] Installing target\HelloWorld_WebRole.msdeploy.zip to .m2\...\HelloWorld_WebRole\1.0.0-SNAPSHOT\HelloWorld_WebRole-1.0.0-SNAPSHOT.msdeploy.zip

Issue Links

• depends upon: NPANDAY-486 Implement integrated XBuild/MSBuild lifecycle (superseeds current MSBuild integration)
• is depended upon by: NPANDAY-480 Support Windows Azure Cloud Service Project and Packaging (CCPack)