Visual Studio Build Customization Guide nd 2 Edition 2012-07-02 Visual Studio ALM Rangers Microsoft Corporation Please consider the environment before printing this document Visual Studio ALM Rangers The Visual Studio ALM Rangers, a special group with members from the Visual Studio Product Team, Microsoft Services, Microsoft Most Valued Professionals (MVPs) and Visual Studio Community Leads, created this content. Build Customization Guide The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented after the date of publication. This document is for informational purposes only. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS DOCUMENT. Microsoft grants you a license to this document under the terms of the Creative Commons Attribution 3.0 License. All other rights are reserved. 2011 – 2012 Microsoft Corporation. Microsoft, Active Directory, Excel, Internet Explorer, SQL Server, Visual Studio, and Windows are trademarks of the Microsoft group of companies. All other trademarks are property of their respective owners. Copyright 2011 – 2012 Microsoft Corporation Page 2 Build Customization Guide Table of Contents TABLES............................................................................................................................................................................. 5 FIGURES ........................................................................................................................................................................... 6 Authors .................................................................................................................................................................... 12 Introduction ................................................................................................................................................................. 13 Welcome ................................................................................................................................................................. 13 Visual Studio ALM Rangers ...................................................................................................................................... 13 Codename “African Tawny Eagle” ATE ................................................................................................................... 13 What’s New in the 2nd Edition ................................................................................................................................. 13 Understanding the Personas ....................................................................................................................................... 15 Customer Types....................................................................................................................................................... 16 Personas .................................................................................................................................................................. 19 build and non-build scenarios in a Microsoft World ................................................................................................... 22 What’s new in Team Foundation Build 2012 .......................................................................................................... 23 Running Unit Tests within the Build Process ........................................................................................................... 32 Using TFSBuild.exe .................................................................................................................................................. 34 Build process template customization .................................................................................................................... 35 Built-in Build Process Templates ............................................................................................................................. 38 Working Effectively with Build Triggers .................................................................................................................. 53 When to create MSBuild Tasks versus Windows Workflow Activities ................................................................... 58 Build Process Template Customization 101 Checklist ............................................................................................. 61 Branching Process Templates.................................................................................................................................. 78 Managing Default Build Process Templates ............................................................................................................ 81 Map Team Foundation Build in Visual Studio Team System 2008 Extensibility Targets to Team Foundation Build in Visual Studio 2010 / Visual Studio 2012 .............................................................................................................. 83 Tracing Build Process Template and Custom Assembly Version ............................................................................. 90 The Team Foundation Build API .............................................................................................................................. 93 Managing Mega-Build Environments ...................................................................................................................... 99 Using Team Foundation Build in Heterogeneous Environments .......................................................................... 114 Empowering developers and build engineers with build activities ........................................................................... 138 Introduction .......................................................................................................................................................... 139 Recommended Resources ..................................................................................................................................... 139 Using Existing MSBuild tasks ................................................................................................................................. 140 Creating a Custom Activity .................................................................................................................................... 141 Storing Custom Activities in Team Foundation Server .......................................................................................... 153 Making a Custom Activity available in the Visual Studio toolbox ......................................................................... 155 Testing and Debugging Custom Activities ............................................................................................................. 158 Copyright 2011 – 2012 Microsoft Corporation Page 3 Build Customization Guide Versioning Assemblies........................................................................................................................................... 164 Managing Virtual Machines .................................................................................................................................. 173 Deployment of Applications and Data Stores ............................................................................................................ 175 Deploy Environments ............................................................................................................................................ 176 Database deployments.......................................................................................................................................... 182 Create and configure an IIS Web Application ....................................................................................................... 191 ASP.NET Web Application in Integration and QA Environments .......................................................................... 192 Integrating with NuGet ......................................................................................................................................... 199 Integrating with Windows Azure........................................................................................................................... 204 Deploying SharePoint Packages ............................................................................................................................ 223 Using Microsoft Dynamics CRM with Team Foundation Build .............................................................................. 231 Using ClickOnce with Team Foundation Build....................................................................................................... 232 Silverlight 4 Applications ....................................................................................................................................... 242 WCF REST Web Service ......................................................................................................................................... 246 Running automated integration tests during build in the Integration Environment ............................................ 250 Production Deployments .....................................................................................................................................