Deployment Framework for BizTalk VSTS release tasks

This extension facilitates the release (not build) of BizTalk applications to server(s) with a private agent (deployment group members qualify). It started as a decomposition of the monolithic Install-BizTalkApplication PowerShell script into more granular tasks for greater flexibility and enhanced feedback within the scope of a vsts release.

The BTDF Deploy/Undeploy tasks require artifacts built using the Deployment Framework for BizTalk (BTDF). For those unfamiliar, I recommend starting with Thomas F. Abraham's recently published Deployment Framework for BizTalk Visual Studio extensions.

Tasks

1. BTDF Deploy

   Deployment Framework for BizTalk btdfproj project target: Deploy.

2. BTDF Undeploy

   Deployment Framework for BizTalk btdfproj project target: Undeploy.

3. MSI Install

   Install any MSI using the command msiexec.exe /i [msi file]. Not limited to MSIs built by BTDF.

4. MSI Uninstall

   Uninstall any MSI using the command msiexec.exe /x[InstallGuid]. Not limited to MSIs built by BTDF.

5. Terminate Suspended

   Terminate suspended service instances and optionally save the relevant messages and metadata.

   BTDF Undeploy will fail if there are any suspended service instances associated with the BizTalk application being deployed. This task terminates and (by default) saves the messages and metadata to disk for future reference.

Typical Usage

For a simple, standalone BizTalk application

1. Terminate Suspended
   • Save messages checked for production, unchecked for non-production.
2. BTDF Undeploy
3. MSI Uninstall
4. MSI Install
5. BTDF Deploy

For BizTalk applications referenced by other BizTalk applications. (i.e. projects B and C both reference project A)

1. Terminate Suspended
   • Save messages checked for production, unchecked for non-production.
2. BTDF Undeploy C
3. BTDF Undeploy B
4. BTDF Undeploy A
5. MSI Uninstall A
6. MSI Install A
7. BTDF Deploy A
8. BTDF Deploy B
9. BTDF Deploy C

See Also

• Deployment Framework for BizTalk Visual Studio extensions
• Deployment Framework for BizTalk (BTDF)
• Deployment Framework For BizTalk Documentation
• Understanding the BizTalk Deployment Framework – Introduction
• BizTalk ALM with VSTS
• BizTalk Application Deployment using BTDF and PowerShell