Enabling Web Deploy for Windows Azure Web Roles with Visual Studio


Last week the Windows Azure SDK team released the Windows Azure SDK 1.4.1 refresh. This refresh adds support for Web Deploy to the Visual Studio tools for Windows Azure. This is huge. Web Deploy lets developers deploy iterative code changes to a web role in Windows Azure in seconds. If you’ve ever had to wait more than five minutes for a code change to be updated so you could test it, this is for you. You can see the feature in action in this Channel 9 video.

 

Web Deploy enables developers to quickly push incremental changes to a web role running in Windows Azure during development and testing. Changes are made directly on the target role without creating and deploying a new package (.cspack). This is a great way to tweak your code and configuration in the cloud before creating the final package that you deploy to your production environment.

 

 There are a number of constraints regarding the use of Web Deploy:

  • Your web role must only have a single running instance.
  •  The changes that you make with Web Deploy are temporary. When the role instance is restarted, your changes will be gone.
  • Can only be used for development and testing. Not intended for updating applications in production.

You can download the SDK refresh using the Web Platform Installer:

 

The Visual Studio Tools for Windows Azure have built in support for enabling Web Deploy. The tools also automatically create a publish profile so you can make incremental updates using the web application publish wizard.

When you install the Web Deploy plug-in a new option will appear in the Cloud Tools publish dialog with the title “Enable Web Deploy for all Web Roles (requires Remote Desktop)”:

 

In order to enable the feature you must first setup remote desktop. Follow the instructions here to set up remote desktop. Once remote desktop is enabled, you can set the check mark to enable Web Deploy.

 

 

 

Notice: Web Deploy is set up to use a self-signed certificate for SSL encryption by default. You can change the certificate in the IIS Manager on the web role.

 

 

Now publish your Windows Azure project as usual. That is all you have to do to enable Web Deploy from Visual Studio. Under the covers Visual Studio will include the Web Deploy plug-in and define an input endpoint in the ServiceDefinition. These changes are made as a part of the publish process and do not affect your design time files.

Once deployment is complete, right click on the Web Application Project and choose “Publish”:

The Cloud Tools automatically created a publish profile with the right settings for you:

Web Deploy uses the same credentials as Remote Desktop. Type your password and click “Publish”. Web Deploy will now update your Web Role instance in a fraction of the time it normally takes to re-deploy to Windows Azure.

Happy Web Deploying…

 

Changing Web Deploy port number

By default Web Deploy uses the Web Management port number 8172. In most cases this is fine. However, in some IT environments it is not possible to make SSL connections using this port. In such cases you will have to customize Web Deploy to use a different port. The Visual Studio Cloud Tools can be configured to setup the input endpoint for Web Deploy to a custom port number. Ask your IT department if they can recommend a port number. Otherwise you can configure Web Deploy to use port 443 which is the standard SSL port and therefore open in most environments. To manually configure the port number, you have to edit the cloud project file (.ccproj) by hand.

 

 

1) Unload the project:

 

 

2) Edit the project file:

 

 

3) Add this setting to the project properties (replace ‘WebRole1’ with the name of your web role): <WebDeployPorts>WebRole1:443</WebDeployPorts>

You can add multiple Web Roles by separating them with ‘|’ in the project setting: <WebDeployPorts>WebRole1:443|WebRole2:444</WebDeployPorts>

 

 

 

 

4) Reload the project and deploy the cloud project to Windows Azure

 

 

 

 

Troubleshooting Web Deploy for Windows Azure

Here are some of the most common problems with Web Deploy on Windows Azure:

Symptom: I get this error message when I try to update my Web Role instance using Web Deploy:

“Error : Web deployment task failed. (…) The response header ‘MSDeploy.Response’ was ” but ‘v1’ was expected.”

 

Problem 1: In some IT Environments it is not possible to make SSL connections on port 8172, which is the default port for Web Deploy and the Web Management Service.

Solution 1: Change the Web Deploy port number. (see above)

 

Problem 2: The Web Deploy service isn’t running correctly on the Web Role instance.

Solution 2: Log into the Web Role instance with Remote Desktop and make sure that the Web Management Service and Web Deploy Service are both running. Try to restart both services.

 

Symptom: I checked the Web Deploy checkbox when I published my Cloud Project but there is no publish profile in my Web Application project.

Problem: In some cases the publish profile gets deleted in Visual Studio 2010 RTM.

Solution: This problem is solved in Visual Studio 2010 SP1.


Comments (8)

  1. The link describing configuration for Remote Desktop is displaying Forbidden when I try to access it.

    Also, have tried this with a staging instance but VS doesn't create the deploy profile for the MVC project. I tried entering it manually but kept getting socket error (10051 I think). I tried your fixes below, didn't work. Does WebDeploy have to be set up with a production instance instead of staging?

  2. The link describing configuration for Remote Desktop is displaying Forbidden when I try to access it.

    Also, have tried this with a staging instance but VS doesn't create the deploy profile for the MVC project. I tried entering it manually but kept getting socket error (10051 I think). I tried your fixes below, didn't work. Does WebDeploy have to be set up with a production instance instead of staging?

  3. Link to Remote Desktop configuration is fixed.

  4. Web Deploy also works with staging. However, make sure that you have Visual Studio 2010 Sp1 installed.

  5. CRM tools says:

    Good to know about your blog such a nice information i really like it.

    Thanks for post…

    <a href="www.leadmaster.co.nz/">CRM tools</a>

  6. Ahsima says:

    Great to read blog on Enabling web deploy with VS. Thanks for the share.

    Ahsima

    htp://www.m6.net

  7. POhms says:

    What about non-web apps? Is the guidance that all apps should be crafted as web apps so they can deploy in a finite time. I have never seen a non-web app deploy in anything less than 10minutes, frequently 20minutes or more, scaling linearly with the number of VMs.

  8. Jason says:

    I am unable to update a webrole using this method because WAIISHost holds a lock on a number of files used by the webrole.

    Error 7 Web deployment task failed.((6/26/2012 12:28:45 PM) An error occurred when the request was processed on the remote computer.)

    (6/26/2012 12:28:45 PM) An error occurred when the request was processed on the remote computer. An error was encountered when processing operation 'Create File' on 'Castle.Windsor.dll'. The error code was 0x80070020. The process cannot access 'E:approotbinCastle.Windsor.dll' because it is being used by another process.

    Is there any way to avoid this error, and use webdeploy?