WebDeploy 3.5 RTW

Posted: Jul 09, 2013  6 comments  

Average Rating

Tags
IIS News
IIS News Item
Walkthroughs
Web Deployment
WebDeploy

Share this Post

WebDeploy v3.5 is now available for download, and there are a few features to consider in this minor release.

Load Balancer Support with Session Affinity

This feature allows WebDeploy to be used with load balancers like ARR supporting layer 7 (OSI application layer) session affinity. If the load balancer sends a session cookie to WebDeploy, WebDeploy will return this cookie to the load balancer to have it route subsequent requests to the proper publishing endpoint.

Here is an example for configuring the ARR load balancer to generate and send the session cookie to WebDeploy (no specific configuration is required for WebDeploy). Navigate to the server farm to configure using IIS Manager:

IIS Manager - server farm

Enable client affinity under the server farm’s Server Affinity option:

IIS Manager - server farm Server Affinity

Encrypting web.config Settings Post-Publish

A new EncryptWebConfig rule handler was created to encrypt connection strings within a web.config file before updating it on the destination. This rule handler applies to the following providers: appHostConfig provider, contentPath provider and <>iisApp provider. The EncryptWebConfig rule handler is disabled by default and can be enabled by clients. When this rule handler is enabled, WebDeploy uses the standard .NET framework RsaProtectedConfigurationProvider which relies on the default key container NetFrameworkConfigurationKey (other KeyContainers can also be used because WebDeploy supports provider name override).

Here is example usage with the default RsaProtectedConfigurationProvider:

msdeploy.exe –verb:sync –source:iisapp=”sourceTestSite” –dest:iisapp=”destinationTestSite” –EnableRule:EncryptWebConfig

App Offline Template

WebDeploy v3.5 adds an enhancement to the existing AppOffline rule which allows you to take an ASP.NET application offline before publishing. In this release, WebDeploy supports specifying the relative path to an app offline template file located on the destination system. This rule handler applies to the following providers: appHostConfig provider, contentPath provider and iisApp provider.

The app offline template file can capture any static HTML content to be displayed for users while the app is offline. Here is example usage:

msdeploy.exe -verb:sync -source:iisApp=sourceApp -dest:iisApp=destApp,appOfflineTemplate="offlineTemplate.htm" -enablerule:AppOffline

ETW Instrumentation

WebDeploy v3.5 enables ETW logging for improved diagnosability with minimal impact for system resource consumption. The Error and ConnectionInfo channels are enabled by default, and additional Debug, Verbose, Info, and Warning channels can be enabled by Event Viewer configuration.

Here is an example for accessing and enabling Web Deploy ETW channels via Event Viewer under Applications and Services Logs\Microsoft\Windows\WebDeploy

IIS Manager - server farm Server Affinity

Comments

Are there any fixes of previous issues in this release? Arent you slowing down a bit? Id webdeploy going to be exterminated by someone at MS?

Aug 13 2013 by Mirronelli

Are there any fixes of previous issues in this release? Arent you slowing down a bit? Is webdeploy going to be exterminated by someone at MS?

Aug 13 2013 by Mirronelli

Is there any decent reason that we can't have the IIS UI features to manage this in Windows 8?  I'm working on a deployment tool based on MsDeploy.  It is developed on my machine and ultimately runs on Windows Server 2008 R2/2012 machines.  It's infuriating that I can't manage delegation rules, users, service settings, etc. via the UI on my development environment.  I have resorted to manually editing administration.config and using Powershell scripts that *I think* are doing the same thing I typically do through the UI on the server SKU's, but I'm never really sure.

If this is a legal/licensing decision, it's a stupid one.  If there's some technical limitation to IIS in the non-server SKU's, it should be treated as a bug.

Aug 19 2013 by sholodak

It's great encryption is included in msdeploy! However I get an error: ERROR_FAILED_TO_ENCRYPT_WEB_CONFIG, which I find no support or documentation for. Detailed problem here: stackoverflow.com/.../msdeploy-automatic-encryption-of-connection-strings-key-not-found-in-dictionary

Oct 28 2013 by cederlof

Is it possible to customize offlineTemplate.htm using Visual Studio One Click Publish?

Thanks,

Nov 08 2013 by angelieri

Any chance that WebDeploy will be able to deploy to Azure from behind a corporate web proxy any time this century.

Aug 04 2014 by slaneyrw

Submit a Comment

  • Plain text is accepted.
  • URLs starting with http:// are converted to links.