Web Deployment Content Map for Visual Studio and ASP.NET
This topic provides links to documentation resources about how to deploy (publish) ASP.NET web applications to IIS by using Visual Studio 2010, Visual Web Developer 2010, and later versions.
If you know a great blog post, stackoverflow thread, or any other link that would be useful, send us an email with the link.
We are seeking feedback on some experimental new approaches to presenting annotated lists of recommended resources. Some of them have a narrower scope than this content map; for a deployment example, see How to deploy an ASP.NET web application to a Windows Azure Web Site using Visual Studio. Another example is How to secure an ASP.NET MVC app .
If you want to deploy a web site project, make sure that you have installed the latest release of the Visual Studio Web Publish Update. In earlier releases, some deployment features work only with web application projects. In the current release, the deployment tools also work with web site projects. For information about how to deploy web site projects when you are using earlier releases of the deployment tools, see the ASP.NET 4 version of this page on MSDN.
This topic contains the following sections:
- Understanding deployment options for web projects
- Finding hosting providers for an ASP.NET application
- Deploying a web application from Visual Studio
- Deploying a web application by creating and installing a web deployment package
- Deploying a web application in an enterprise environment, using a continuous integration (CI) process
- Using Web.config transformations to change settings in the destination Web.config file or app.config file during deployment
- Using Web Deploy parameters to change settings in the destination web application during deployment
- Making sure an application is off-line during deployment
- Deploying a database or changes to a database as part of web application deployment
- Deploying a database separately from web application deployment
- Deploying a web application that uses ASP.NET application services such as membership and profiling
- Precompiling for deployment
- Deploying an intranet web application
- Automating common deployment tasks that are not automated out of the box
- Configuring web servers so that developers can deploy web applications to them using Web Deploy
- Configuring servers for a hosting provider
- Troubleshooting deployment problems
- Getting help with a specific deployment question
- Additional Resources
Understanding deployment options for web projects
- Web Deployment Overview for Visual Studio and ASP.NET (MSDN)
- Visual Studio 2012 Web Publishing Improvements (Video by Scott Hanselman. Produced before deployment features were extended to web site projects.)
- Overview Post for Web Deployment in VS 2010 (Vishal Joshi's blog. An older blog post but some of the Visual Studio 2010 resources it links to have information that is still relevant for Visual Studio 2012.)
Finding hosting providers for an ASP.NET application
Deploying a web application from Visual Studio
- ASP.NET Web Deployment using Visual Studio (12-part tutorial series, shows how to deploy web applications with SQL Server databases. For database deployment uses both the dbDacFx provider and Entity Framework Code First Migrations. Also includes information about Web.config file transformations, deploying individual files, command-line deployment, and how to customize the Visual Studio web publish pipeline by editing .pubxml files. Applies to all ASP.NET web projects, including Web Forms, MVC, and Web API.)
- How to: Deploy a Web Project Using One-Click Publish in Visual Studio (Reference information for the Visual Studio Web Publish wizard.)
- Deploying an ASP.NET Web Application with SQL Server Compact using Visual Studio (An earlier version of ASP.NET Web Deployment using Visual Studio listed at the top of this section. Mainly useful now for its information about how to deploy SQL Server Compact databases and how to migrate from SQL Server Compact to a full edition of SQL Server.)
- Deploying an ASP.NET Web Application to a Windows Azure Web Site and SQL Database (windowsazure.com site. A short and simple getting-started tutorial that includes an Entity Framework Code First database and Code First Migrations deployment. )
- .NET Multi-Tier Application Using Storage Tables, Queues, and Blobs (windowsazure.com site. 5-part tutorial series, shows how to create an MVC project and deploy it to a Windows Azure Cloud Service.)
- Deploying an ASP.NET Website to Azure in Visual Studio 2012 from a Git Repository directly (by Suprotim Agarwal. How to deploy an ASP.NET web application, using the Git plug-in to commit the code to Git and connecting Windows Azure to the repository.
Deploying a web application by creating and installing a web deployment package
- How to: Create a Web Deployment Package in Visual Studio (MSDN)
- How to: Install a Deployment Package Using the deploy.cmd File Created by Visual Studio (MSDN)
- Using a Web Deploy package to deploy to IIS on the dev box and to a third party host (Sayed Hashimi's blog. How to use IIS Manager to install a deployment package in IIS on the local computer and at a hosting company that supports IIS Manager for Remote Administration.)
- Building a Web Deploy Package From Visual Studio 2010 (IIS.NET web site. Includes instructions for command-line package creation and installation.)
- Package Once Publish Anywhere (Sayed Hashimi's blog. Introduces a NuGet package that automates the process of transforming the Web.config file for multiple destination environments, so that you can deploy one package to multiple servers.)
See also the following section.
Deploying a web application in an enterprise environment, using a continuous integration (CI) process
- Deploying Web Applications in Enterprise Scenarios (40-part tutorial series, shows how to automate deployment in a CI process using Visual Studio 2010 and Team Foundation Server 2010).
- Inside the Microsoft Build Engine: Using MSBuild and Team Foundation Build, by Sayed Hashimi and William Bartholomew (This is a book, not a web resource, but it is an essential guide for learning how to configure MSBuild for continuous integration scenarios.)
- MSBuild Extension Pack (CodePlex site. Includes deployment tasks.)
- Team Foundation Build Customization Guide (CodePlex site. Documentation by ALM Rangers on setting up Team Foundation Server covers web deployment and includes tutorials and videos.)
- Continuous Delivery for Cloud Applications in Windows Azure (windowsazure.com site)
- Announcing Continuous Deployment to Azure with Team Foundation Service (Brian Harry's blog)
- SlowCheetah XML transforms from a CI server (Sayed Hashimi's blog. Explains how to use SlowCheetah, A Visual Studio add-in for transforming app.config and other XML files.)
See also Making sure an application is off-line during deployment later in this page.
Using Web.config transformations to change settings in the destination Web.config file or app.config file during deployment
- Web.config File Transformations
- Web.config Transformation Syntax for Web Project Deployment Using Visual Studio (MSDN)
- Web Tools 2012.2 - web.config transforms (YouTube video by Sayed Hashimi, shows how to set up and preview Web.config transforms.)
- How do I disable Web.config transformation? (MSDN)
- When should I use Web Deploy parameters instead of Web.config transformations? (MSDN)
- XDT (XML Document Transform) released on codeplex.com (.NET Web Development and Tools blog. Announces availability of the source code for the Web.config file transformation engine and lists some tools that use it.)
Using Web Deploy parameters to change settings in the destination web application during deployment
- How to: Use Web Deploy Parameters in a Web Deployment Package (MSDN)
- MSDeploy: How to update app settings on publish based on the publish profile (Sayed Hashimi's blog. Shows how to integrate Web deploy parameters into Visual Studio publish profiles.)
- Web Deploy Parameterization (IIS.NET web site)
- Web Deploy Parameterization in Action (Vishal Joshi's blog)
- Web Deploy Parameterization vs. Web.config Transformation (Vishal Joshi's blog)
Making sure an application is off-line during deployment
- ASP.NET Web Deployment using Visual Studio: Deploying a Code Update (See the section Take the application offline during deployment)
- Taking an Application Offline before Publishing (IIS.net site. Explains a feature built into Web Deploy 3.0 that automates handling of an app_offline.htm file. This feature does not work with custom app_offline.htm files.)
Deploying a database or changes to a database as part of web application deployment
- Configuring Database Deployment in Visual Studio (MSDN. Overview of options for deploying a database with a web project.)
- ASP.NET Web Deployment using Visual Studio (12-part tutorial series, shows database deployment by using dbDacFx provider and Entity Framework Code First Migrations.)
- How to: Deploy a Web Project Using One-Click Publish in Visual Studio (MSDN)
- Deploying an ASP.NET Web Application with SQL Server Compact using Visual Studio (12-part tutorial series, shows how to deploy SQL Server Compact databases and how to migrate from SQL Server Compact to a full edition of SQL Server.)
- See also Deploying a web application by creating and installing a web deployment package and Deploying a web application in an enterprise environment, using a continuous integration (CI) process earlier in this page.
Deploying a database separately from web application deployment
- SQL Server Data Tools (MSDN)
- Including Data in a SQL Server Database Project (SQL Server Data Tools team blog. How to deploy both schema and data when deploying a database.)
- How to Deploy a Database to Windows Azure (WindowsAzure.com site)
- Migrating Databases to Windows Azure SQL Database (formerly SQL Azure) (MSDN)
- Migrating a Database to SQL Azure using SSDT (SQL Server Data Tools team blog)
- Migrating Data-Centric Applications to Windows Azure (MSDN)
- Migrating SQL Server Databases to Windows Azure SQL Database (MSDN)
Deploying a web application that uses ASP.NET application services such as membership and profiling
- ASP.NET Web Deployment using Visual Studio (12-part tutorial series, shows how to deploy an ASP.NET membership database.)
- Configuring a Website that Uses Application Services (For web site projects but is also relevant for web application projects.)
- Users and Roles On The Production Website (For web site projects but is also relevant for web application projects.)
Precompiling for deployment
Deploying an intranet web application
Automating common deployment tasks that are not automated out of the box
- ASP.NET Web Deployment using Visual Studio: Deploying Extra Files
- Setting Folder Permissions on Web Publish (Sayed Hashimi's blog)
- How to extend the targets file to include registry settings for a web project package (Web Development Tools blog)
- Extending XML (Web.config) transformation (Sayed Hashimi's blog. Shows how to create custom XDT transforms.)
- Web Deployment Tool (MSDeploy) Custom Provider Take 1 (Sayed Hashimi's blog. Shows how to create a Web Deploy custom provider.)
- How to package and deploy COM components (Web Development Tools blog)
- How to package .NET assemblies (Web Development Tools blog. How to deploy assemblies to the GAC.)
- Script Out Everything - Initialize Your Windows Azure VM for Your Web Server with IIS, Web Deploy and Other Stuff (Tugberk Ugurlu's blog)
Configuring web servers so that developers can deploy web applications to them using Web Deploy
Configuring servers for a hosting provider
- Microsoft ASP.NET 4 Hosting Deployment Guide (Microsoft Download Center)
- Generate a Profile XML File (IIS.net site)
Troubleshooting deployment problems
- ASP.NET Web Deployment using Visual Studio: Troubleshooting
- Troubleshooting Common Problems With Web Deploy
- Web Deploy Error Codes (IIS.net site)
- Web Deployment FAQ for Visual Studio and ASP.NET (MSDN)
- Core Differences Between IIS and the ASP.NET Development Server
- Common Configuration Differences Between Development and Production
- Hosting ASP.NET Applications in Medium Trust (4 Guys from Rolla site)
Getting help with a specific deployment question
Additional Resources
This section provides links to additional resources that are useful for learning more about how to use Visual Studio and IIS deployment tools.
The following blogs frequently contain information about Visual Studio web deployment:
The following resources provide documentation about Web Deploy, the IIS framework that Visual Studio uses to perform web application project deployment tasks. You can ask questions about Web Deploy in the Web Deployment Tool forum on the IIS.net web site.
- Introduction to Web Deploy
- Installing and Configuring Web Deploy
- PowerShell Scripts for Automating Web Deploy Setup
- Web Deployment Tool (Top-level table of contents node for Web Deploy documentation on the TechNet site. Includes useful reference information but most of the TechNet pages have not been updated for years.)
- Microsoft.Web.Deployment Namespace (API documentation, has not been updated since version 1.0.)
- The Microsoft Web Deployment Team blog
- Publish tab in IIS.net web site