Step by Step Guide to Create First Windows Azure Application

Target audience: Beginners in Windows Azure or Level 100

One can argue that why this step by step guide after so many years of Windows Azure? and why I wrote this article after my more than 80 articles on Azure?

image

Answer is, when I started writing this article, my objective was very much clear in my mind. I wanted to help people starting with Windows Azure from installation of SDK to Deployment to Microsoft Data Center. In this article I am targeting people who want to start learning and developing for Windows Azure.

Article is divided into five parts

  1. Installation of Windows Azure SDK
  2. Developing First Windows Azure Web Application
  3. Deploying application locally in Development Storage Fabric
  4. Registration for free Windows Azure Trial
  5. Deployment of the Application in Microsoft Data Center

I will start fresh with installation of Windows Azure SDK and I will conclude this post with deployment of simple application in Windows Azure Hosted Service. I am not going to create a complex application since purpose of this post is to walkthrough with all the steps from installation, development, debugging to deployment. In further post we will get into more complex applications. Proceed through rest of the post to create your first application for Windows Azure.

Installation of Windows Azure SDK

Step 1

Go to official site of Windows Azure at link http://www.windowsazure.com/en-us/

Step 2

In bottom of page, you will get Develop option. Click on Show Me More.

clip_image001

Step 3

Now you need to choose the language you want to work with. You can develop application in any of the language given in option and deploy it on the Microsoft managed datacenters. Below are the available languages.

clip_image002

To start developing using .NET, click on .NET.

Step 4

You will be navigated to Home Page of .NET Developer Center. You will get all the resources related to .NET development on Windows Azure here. Now click on Install to install Windows Azure SDK. I am assuming here that you are already having VS2010 on your machine.

clip_image003

Windows Azure SDK and tools are available to install via Web Installer. Click on the Install in the dialog window.

clip_image005

Next dialog windows will prompt you to agreement. Select I Accept option to proceed.

clip_image007

You will be getting dialog window indicating Windows Azure SDK being installed.

clip_image009

After successful installation you will get confirmation dialog windows as below.

clip_image011

Now click on Finish and Exit.

Congratulation by now you has installed Windows Azure SDK on your machine.

 

Developing First Application

Open Visual Studio 2010 as administrator and create a new project. Open File -> New->Project. From Cloud tab select Windows Azure Project.

image

Next you need to click on your preferred language. You can use any of the three languages to develop application to be deployed on Windows Azure. I am choosing language Visual C#. After clicking on the language you will get options to select as either Web Role or Worker Role.

clip_image001[6]

Before we proceed further, let us stop by and try to understand what are the Web Role are Worker Role?

Web Role takes HTTP input and Process it. It gives output as HTTP Response. It takes input from user via a user interface.

clip_image002[6]

Web Role can be summarized as below,

clip_image004

You create any application as Web Role instance. For example,

  • If you want to create a Web Application using ASP.Net then you will be choosing an ASP.Net Web Role in the project template
  • If you want to create a WCF Service and deploy it on Azure then you will be choosing WCF Service Web Role.
  • If you want to create ASP.Net MVC application then you will be choosing ASP.Net MVC Web Role.

Worker Role runs in the background. It is used to perform some background task. It does not take input from user. It takes input from Azure Storage or web Role.

Worker Role can be summarized as below,

image

Let us get back to creating first web application to be deployed on Windows Azure. Go ahead and select ASP.NET Web Role and click on arrow button. If you want you can change name of the Web Role. Since this is your first application so for the simplicity leave default name. After selecting Web Role click on Ok.

image

On exploring solution explorer you will find that there are two projects. One project is Widows Azure Project and other is ASP.Net Web Role.

image

Let us explore Windows Azure Project. Project got two Service Configuration files. Extension of Service Configuration file is cscfg

image

One Service configuration file is for local deployment and one contains configuration details to deploy to Microsoft Data Center. On opening service configuration file, you will get below XML.

image

Below information’s are provided in service configuration file.

  • Operating system version
  • Operating system family
  • Connection string settings
  • Instance counts

By default instance count is set to 1. It means there will be one instance of Web Role will be running for the deployment. Let us go ahead and increase instance count to 2. Change value to 2 in Instance count entry as below and save the file.

image

Next important file is Service Definition file. Extension of Service Definition file is csdef

image

On Opening service definition file you will get below XML

image

Service definition file contains information about binding and different sites. It contains information about EndPoints and default port number. In normal scenario, you may not need to edit this file.

Next important file is WebRole1. If you remember we did not change name of the Web Role while creating it in previous step.

image

When you click on WebRole1, you will get below UI.

image

In this UI you can,

  • Manage Settings
  • Configure Web Role
  • Configure local storage
  • Manage settings
  • Configure End Points
  • Manage virtual networks

In later post we will go into details of each of the section of this UI. As of now we can proceed with default values.

Now we have a bit understating on different files in Windows Azure project in the solution. Other project is normal ASP.NET Web Application project with one extra file called WebRole.cs. This file is used to host web application in Windows Azure.

image

Let us open default.aspx and modify it as below, I have deleted all the default codes from MainContent and put one H1 tag as below.

image

By this, we have created a simple ASP.Net Web Role Application to be deployed on Windows Azure.

 

Deploying Application Locally

You deploy application in two steps. First you deploy it locally to do testing that if everything is working as expected. You can debug application deployed on local development fabric. A Windows Azure emulator run locally is also known as Windows Azure Development Fabric.

To run Windows Azure Web Role application locally makes sure that Windows azure project is set as startup project and press F5. To make Windows azure project as startup project right click on that and select set up as startup project

image

After setting startup project press F5 to run application on local development fabric. After pressing F5 you can see that in bottom you are getting messages like initializing the Windows Azure storage emulator etc.

image

On successful deployment you should be getting Ready message at bottom

image

After successful deployment browser will get launched and you can see your Windows Azure Application running on local development fabric.

image

You can see application is running on port 81 and default start page is default.aspx. Let us explore local development fabric. To open local development fabric from the task bar right clicks on Windows Azure icon.

image

Right click on the Windows Azure icon and select Show Compute Emulator UI. You will get Windows Azure Compute Emulator UI. In emulator you can see health of the Web Role instances. There are two instances running since we configured two instance of Web Role in service configuration file.

image

On right clicking on the Web Role instance you can set logging level and can open local store.

image

In further post we will get into details of logging and health of Web Role instances. As of now we have seen the way to create Windows Azure Web Role Application and deploy it locally. Now let is deploy created application in Microsoft Data Center or on real cloud.

 

Deploying Application On Windows Azure Portal

To deploy application on Microsoft Data Center you need to have a Windows Azure Account. Windows Azure is a paid service however you can start with free trial. To register for free account follow the below steps.

Register for Free Account

Step 1

Go to official site of Windows Azure at link http://www.windowsazure.com/en-us/

Step 2

In right hand side click on free trail

clip_image001[8]

Step3

Next click on Try it free.

clip_image003

Step 4

You will be asked to login using Live ID. Provide your live id and login. If you don’t have live ID create one to work with Windows Azure Free Trail

clip_image005[6]

Next proceed through the screen to create free account.

clip_image007[6]

After successful registration you will be getting a success registration message. After registration go back to visual studio and right click on Windows Azure Project and select Package.

image

Next choose Service Configuration as Cloud and Build Configuration as Release and click Package.

clip_image001[10]

After successful package you can see Service Package File and Cloud Service Configuration file in the folder explorer. We need to upload these two files to deploy application on Microsoft Data Center.

clip_image003[6]

After successful registration for free account again browse to https://www.windowsazure.com/ and click on Management Portal from Account section in bottom.

clip_image004

You will be navigated to live login page. Provide same live id and password you used to create Free Trial. After successful authenticating you will be navigated to Management Portal.

To deploy on Microsoft Data Center, first you need to create Hosted Service. To create Hosted Service from left tab select Hosted Service, Storage, Account and CDN

clip_image005

In top you will get three options. Their purpose is very much clear with their name.

clip_image006

Click on New Hosted Service to create a Hosted service. Provide information as below to create hosted service.

clip_image007

Choose Subscription Name. It should be the same as your registered subscription of previous step.

  • Enter name of the service
  • Enter URL of the service. This URL need to be unique. On this URL you will be accessing the application. So this application will be used at URL debugmodemyfirstservice.cloudapp.net
  • Choose a region from the drop down. In further post we will get into details of affinity group.
  • In Deployment option choose, Deploy to production environment.
  • Give a deployment name.

Next to upload package select browse locally. On browsing navigate to folder YourFolderName\MyFirstWindowsAzureApplication\MyFirstWindowsAzureApplication\bin\Release\app.publish and choose files.

image

As of now for simplicity don’t add any Certificate and click on Ok to create a hosted service with package of application created in last step. You will get a warning message. Click Yes on warning and proceed.

image

Now you need to wait for 5 to 10 minutes to get your application ready to use. Once service is ready you can see ready status for the Web Role.

image

After stats are ready, you are successfully created and deployed first web application in Windows Azure. Browse to URL http://debugmodemyfirstservice.cloudapp.net/ to see your application running from Microsoft Data Center.

image

In this way you can start developing for Windows Azure. In further post we will go into many details. I hope this post is useful. Thanks for reading.

 

17 responses to “Step by Step Guide to Create First Windows Azure Application”

  1. Excellent – this is one of those legendary blog post!

  2. Thanks sir for motivation

  3. didn’t go step by step, but one thing is sure.. it must have taken lot of effort to get this up.. with all the details and graphics

  4. This is a really good step by step guide, Thanks!

  5. Glad it is useful …

    Thanks
    DJ

  6. Glad Atul sir you liked it

    Thanks
    DJ

  7. […] Step by Step Guide to Create First Windows Azure Application […]

  8. Sir, i have tried cloud application for the first time.it was very useful.thank u.

  9. Sajid Shaikh

    Really very nice aritcle. I am expecting the same ariticle for creating the WCF REST services on AZURE.Please give me the link if u already have such article.

  10. Thank you,Give me step by step guide for windows mobile service and also give me how to develop mobile aps in ,net using asp.net

  11. can i store data locally in my database? and what is the purpose of deploying on microsoft ?how to apply virtulization in my personal computer?

  12. Greetings, I think your site might be having web browser compatibility problems.
    When I look at your website in Safari, it looks fine
    however, if opening in I.E., it’s got some overlapping issues. I simply wanted to provide you with a quick heads up! Aside from that, excellent blog!

  13. Dhananjay Kumar

    thanks will take care of that

  14. This is genuinely fantastic… I must confess,
    If your web site was deemed a person; I would personally say allow us do that
    all over again! Thanks a lot plus continue this fine work!

  15. Thank You Sir, Its Very Useful & Easy to Understand For My Projects

  16. Thank You Sir.I kindly request to develop latest software same this

  17. Thank You Sir.It is very useful and easy to understand for my project

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

Create a website or blog at WordPress.com