Lab version:15.4.1

Last updated:10/26/2017

Overview

Azure Web Apps provides a highly scalable, self-patching web hosting service. This lab walks guides you through the process of deploying a data-driven ASP.NET web app in Azure and connecting it to Azure SQL Database.

Prerequisites

In order to complete this lab you will need the Visual Studio 2017 virtual machine provided by Microsoft. Click the button below to launch the virtual machine on the Microsoft Hands-on-Labs portal.

Launch the virtual machine

Alternatively, you can download the virtual machine from here

You also need an Azure account (Get a $25 monthly Azure credit by joining Visual Studio Dev Essentials).

Exercise 1: Building ASP.NET apps in Azure with SQL Database

Task 1: Building and running the sample app locally

  1. Log in as Sachin Raj (VSALM\Sachin). All user passwords are P2ssw0rd.

  2. Launch Visual Studio from the taskbar.

  3. Open DotNetAppSqlDb.sln from the Start Page. Note that this project can also be opened from C:\Samples.

  4. Once the project has finished loading, press F5 to build and run it. The sample is a simple TODO application that stores TODO items in a SQL database specified via the connection string in Web.config.

  5. Use the application to add, edit, and delete a TODO item. It should be a straightforward experience. Close the browser when satisfied.

Task 2: Setting up an initial deployment to Azure

  1. In Solution Explorer, right-click the DotNetAppSqlDb project node and select Publish.

  2. Select the Microsoft Azure App Service template and click Publish.

  3. Select Add an account | Add an account and log in using the Microsoft account associated with your Azure subscription.

  4. Set App Name to a globally unique name. One way to do this is to append your name after the name of the project.

  5. Click New to create a new Resource Group. A resource group is a collection of all resources associated with a deployed solution.

  6. Set the New resource group name to “MyResourceGroup”and click OK.

  7. Click New to create a new App Service Plan. An app service plan defines the location, features, and other properties of your deployment.

  8. Set the App Service Plan name to “MyAppServicePlan”. Select a Location and Size and click OK.

  9. Since this application relies on a SQL database, you will need to configure one for deployment. Click Explore additional Azure services.

  10. Click the Add button for SQL Database.

  11. You have the option of using an existing database (if you have one). Alternatively, click New to create one for this lab.

  12. Configure the server with a unique name and administrator credentials. Click OK.

  13. After configuring the server, you will also need to define a database to create on that server. Click OK to accept the defaults.

  14. Now that all of the required resources have been configured, click Create to perform he initial deployment.

  15. The first deployment may take a few minutes since there is a lot to provision. Future deployments for code changes are much faster. You can follow the progress at the bottom.

  16. After deployment has succeeded, a browser window will open to the public URL within Visual Studio. Test out the site by adding a new TODO item.

  17. The new data is stored in SQL on Azure.

Task 3: Accessing the Azure SQL database locally

  1. Select View | SQL Server Object Explorer.

  2. Click the Add SQL Server button.

  3. Expand the Azure node and select the database you just created as part of the deployment. Enter the admin password and click Connect.

  4. By default, a SQL server in Azure may only be accessed by services deployed within Azure. However, you can specify a firewall rule to allow access from your public endpoint. Select Add my client IP (or subnet range, if applicable) and click OK. This will allow you to connect to the database from your current connection.

  5. Once Visual Studio finishes creating the firewall setting for your SQL Database instance, your connection will show up in SQL Server Object Explorer. Here you can perform common database operations, such as running queries, creating views & stored procedures, and more.

  6. Expand the tree down to the Todoes table. Right-click it and select View Data.

  7. You can now work with the data stored in your SQL instance in Azure directly from Visual Studio.

Task 4: Updating the app with Code First Migrations

  1. This application uses the Entity Framework Code First model to infer the database schema from the application’s model classes. In this case, the Todo class contains the schema information used for the one data table in the database. As a result, typical changes to the schema can be made by simply updating the class itself and using Code First Migrations to migrate the database forward. From Solution Explorer, open Models/Todo.cs.

  2. While Code First Migrations supports sophisticated migration scenarios, this lab will use a simple one: adding a field. Add the field below to the Todo class.

     public bool Done { get; set; }
    
  3. Select Tools | NuGet Package Manager | Package Manager Console.

  4. Execute the command below to enable Code First Migrations for the project. This will also create an initial schema class based on the current database.

     # PowerShell
     Enable-Migrations
    
  5. Execute the command below to add a new migration. This will create a second schema class that provides instructions for how to get from the previous (initial) state to the current one (that includes the Done property).

     # PowerShell
     Add-Migration AddProperty
    
  6. Execute the command below to apply the new migration to the local database.

     # PowerShell
     Update-Database
    
  7. Press F5 to build and run the application. Try adding, editing, and deleting an item. Note that the functionality should not have changed because the new property hasn’t been integrated into the user experience yet. Close the browser when satisfied.

  8. From Solution Explorer, open Controllers/TodosController.cs.

  9. Replace the existing Create method definition (the one with the HttpPost attribute) with the line below. Note that it just adds the Done property to the parameter binding.

     public ActionResult Create(
                           [Bind(Include = "Description,CreatedDate,Done")] Todo todo)
    
  10. Now it’s time to edit some views so that the new property will be accessible to the user. For simplicity, only the Create and Index (list) views will be updated here. Open Views/Todos/Create.cshtml.

  11. Insert the snippet below before the form-group div containing the submit button.

     <div class="form-group">
         @Html.LabelFor(model => model.Done,
                            htmlAttributes: new { @class = "control-label col-md-2" })
         <div class="col-md-10">
             <div class="checkbox">
                 @Html.EditorFor(model => model.Done)
                 @Html.ValidationMessageFor(model => model.Done, "",
                                                       new { @class = "text-danger" })
             </div>
         </div>
     </div>
    
  12. The final code should look like this.

  13. Open Views/Todos/Index.cshtml.

  14. Insert the snippet below as the third table header column on the page.

     <th>
         @Html.DisplayNameFor(model => model.Done)
     </th>
    
  15. The code should look like this.

  16. Insert the code below as the third column template in the same table as above.

     <td>
         @Html.DisplayFor(modelItem => item.Done)
     </td>
    
  17. The final code should look like this.

  18. Press F5 to build and run the application. You should now see a Done option on the pages for creating and listing TODO items. Close the browser window when satisfied.

Task 5: Enabling Code First Migrations in Azure

  1. Now that the changes have been developed and tested locally, it’s time to apply them to Azure. In Solution Explorer, right-click the DotNetAppSqlDb project node and select Publish.

  2. Click Settings.

  3. Click Next.

  4. Wait for the connection string to load and then check Execute Code First Migrations. Click Save.

  5. Click Publish to push out the new changes.

  6. The browser will load the site after deployment. You can explore the site to see that the new field is now available.

Task 6: Streaming application logs from Azure

  1. You can stream application tracing messages directly from your Azure web app to Visual Studio. This application uses this tracing to track and share diagnostic info. Open Controllers/TodosController.cs.

  2. Note that there is a Trace.WriteLine() call at the beginning of each request method.

  3. Select View | Server Explorer.

  4. Locate the application under its resource group. Right-click it and select View Streaming Logs.

  5. The streaming logs will now begin to appear in the Output window. However, you won’t see any trace messages because the default trace level is Error. As a result, only traces logged with Trace.TraceError() are shown.

  6. Right-click the application again and select View Settings.

  7. Set the Application Logging level to Verbose. This will include all traces. Other settings include anything as severe as the specified traces. For example, Warning will include TraceWarning() and TraceError(), but not TraceInformation() or WriteLine(). Click Save.

  8. Refresh the browser window by right-clicking the body and selecting Refresh.

  9. There will now be a trace message displayed in the Output window.

Task 7: Managing your Azure web app

  1. You can easily access the full management portal experience from Visual Studio. Right-click the Azure application node and select Open in Management Portal.

  2. If you want to delete this web app, you can click Delete and follow the confirmation instructions. However, that would only delete the web app component of your deployment. If you would like to delete everything created as part of this lab at once, you can do so by clicking MyResourceGroup and following the Delete resource group process to remove the SQL resources as well.