| title | Create your first ASP.NET web app in Azure in five minutes | Microsoft Docs |
|---|---|
| description | Learn how easy it is to run web apps in App Service by deploying a simple ASP.NET application. |
| services | app-service\web |
| documentationcenter | |
| author | cephalin |
| manager | wpickett |
| editor | |
| ms.assetid | b1e6bd58-48d1-4007-9d6c-53fd6db061e3 |
| ms.service | app-service-web |
| ms.workload | web |
| ms.tgt_pltfrm | na |
| ms.devlang | na |
| ms.topic | hero-article |
| ms.date | 05/05/2017 |
| ms.author | cephalin |
| ms.custom | mvc |
[!INCLUDE app-service-web-selector-get-started]
This Quickstart helps you deploy your first ASP.NET web app to Azure App Service in just a few minutes. When you're finished, you'll have a simple web app up and running in the cloud.
This tutorial demonstrates how to use Visual Studio 2017 to build and deploy an ASP.NET web app to Azure. If you don’t already have Visual Studio 2017 installed, you can download and use the free Visual Studio 2017 Community Edition. Make sure that you enable Azure development during the Visual Studio setup.
[!INCLUDE quickstarts-free-trial-note]
In Visual Studio, create a project with Ctrl+Shift+N.
In the New Project dialog, click Visual C# > Web > ASP.NET Web Application (.NET Framework).
Name the application myFirstAzureWebApp, and then click OK.
You can deploy any type of ASP.NET web app to Azure. For this tutorial, select the MVC template, and make sure authentication is set to No Authentication.
Click OK.
In the Solution Explorer, right-click your myFirstAzureWebApp project and select Publish.
Make sure that Microsoft Azure App Service is selected and click Publish.
This opens the Create App Service dialog, which helps you create all the Azure resources you need to run your ASP.NET web app in Azure.
In the Create App Service dialog, click Add an account, and then sign in to your Azure subscription. If you're already signed into a Microsoft account, make sure that account holds your Azure subscription. If the signed-in Microsoft account doesn't have your Azure subscription, click it to add the correct account.
Once signed in, you're ready to create all the resources you need for your Azure web app in this dialog.
First, you need a resource group.
Note
A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed.
Next to Resource Group, click New.
Name your resource group myResourceGroup and click OK.
[!INCLUDE app-service-plan]
Next to App Service Plan, click New.
In the Configure App Service Plan dialog, configure the new App Service plan with the following settings:
- App Service Plan: Type myAppServicePlan.
- Location: Choose West Europe, or a region near you.
- Size: Choose Free, or another pricing tier.
Click OK.
The only thing left to do now is to name your web app. In Web App Name, type a unique app name. This name will be used as part of the default DNS name for your app (<app_name>.azurewebsites.net), so it needs to be unique across all apps in Azure. You can later map a custom domain name to your app before you expose it to your users.
You can also accept the automatically generated name, which is already unique.
Click Create to start creating the Azure resources.
Once the wizard finishes creating the Azure resources, it automatically publishes your ASP.NET web app to Azure for the first time, and then launches the published Azure web app in your default browser.
The URL uses the web app name that you specified earlier, with the format http://<app_name>.azurewebsites.net.
Congratulations, your first ASP.NET web app is running live in Azure App Service.
It's very easy to update and redeploy to Azure. Let's make an update to the homepage.
From the Solution Explorer, open Views\Home\Index.cshtml.
Find the <div class="jumbotron"> HTML tag near the top, and replace the entire tag with the following code:
<div class="jumbotron">
<h1>ASP.NET in Azure!</h1>
<p class="lead">This is a simple app that we’ve built that demonstrates how to deploy a .NET app to Azure App Service.</p>
</div>To redeploy to Azure, right-click your myFirstAzureWebApp project in Solution Explorer and select Publish.
In the publish page, click Publish.
When Visual Studio is finished, it launches the updated Azure web app in your browser.
Go to the Azure portal to take a look at the web app you just created.
To do this, sign in to https://portal.azure.com.
From the left menu, click App Services, then click the name of your Azure web app.
You have landed in your web app's blade (a portal page that opens horizontally).
By default, your web app's blade shows the Overview page. This page gives you a view of how your app is doing. Here, you can also perform basic management tasks like browse, stop, start, restart, and delete.
The tabs on the left side of the blade show the different configuration pages you can open. The following list gives you just a few of the possibilities:
- Map a custom DNS name
- Bind a custom SSL certificate
- Configure continuous deployment
- Scale up and out
- Add user authentication
To delete your first Azure web app, you can click Delete in the Overview page. However, there's a better way to delete everything that you created in this quick start. From your web app's Overview page, click the resource group to open its blade.
In the resource group blade, you can see both the App Service plan and the App Service app that Visual Studio created for you.
At the top of the blade, click Delete.
In the confirmation blade, confirm by typing the resource group name myResourceGroup into the text box and click Delete.
[!div class="nextstepaction"] Learn how to build an ASP.NET app in Azure with SQL Database
[!div class="nextstepaction"] Explore sample Web Apps PowerShell scripts