Home / Docker Deployment to Linux Azure App Service using Azure DevOps

Overview

This lab outlines the process to build custom Docker images of an ASP.NET Core application, push those images to a private repository in Azure Container Registry (ACR). These images will be used to deploy the application to the Docker containers in the Azure App Service (Linux) using Azure DevOps.

The Web App for Containers, allows creation of custom Docker container images, easily deploy and then run them on Azure. Combination of Azure DevOps and Azure integration with Docker will enable the following:

  1. Build custom Docker images using Azure DevOps Hosted Linux agent

  2. Push and store the Docker images in a private repository

  3. Deploy and run the images inside the Docker Containers

Before you begin

  1. Refer the Getting Started page to know the prerequisites for this lab.

  2. Click the Azure DevOps Demo Generator link and follow the instructions in Getting Started page to provision the project to your Azure DevOps.

Setting up the Environment

  1. Click on the Deploy to Azure button to initiate the configuration.

    Deploy to Azure

  2. In Custom deployment window, select the Subscription type, leave the default selection for the resource group, and select the Location. Provide the ACR Name, Site Name, DB Server Name, accept the Terms and Conditions and click on the Purchase button to provision the following resources:

    • Azure Container Registry

    • Azure Web App

    • Azure SQL Server Database

    Create Azure Components

  3. It takes approximately 3 to 4 minutes to provision the environment. Click on Go to resource group to view the resource group.

    Environment Provision

  4. The following components are provisioned post deployment.

    Azure Components Description
    Azure Container RegistryAzure Container Registry Used to store images privately
    Storage Account Storage Account Container Registry resides in this storage account
    App Service App Service Docker images are deployed to containers in this App Service
    App Service Plan App Service Plan Resource where App Service resides
    SQL Server SQL Server SQL Server to host database
    SQL database SQL database SQL database to host MyHealthClinic data

    Post Azure Deployment

  5. Click on the mhcdb SQL database and make a note of the server details under the header Server name.

    DB Server URL

  6. Navigate back to the resource group. Click on the container registry and make a note of the server details under the header Login server. These details will be required in the Exercise 2.

    ACR

Exercise 1: Configure Continuous Integration (CI) and Continuous Delivery (CD)

Now that the required resources are provisioned, the Build and the Release definition need to be manually configured with the new information. The dacpac will also be deployed to the mhcdb database so that the schema and data is configured for the backend.

  1. Navigate to the Builds option under the Pipelines tab. Select the build definition MHCDocker.build, and select the Edit option.

    Build

  2. In the Run services, Build services and Push services task, authorize (only for the first task) the Azure subscription and update Azure Container Registry with the endpoint component from the dropdown and click on Save.

    Tasks

    Tasks

    Tasks

    Tasks Usage
    Run services Run services prepares suitable environment by restoring the required packages
    Build services Build services builds myhealth.web image
    Push services Push services pushes myhealth.web image tagged with $(Build.BuildId) to container registry
    Publish Build Artifacts Publish Build Artifacts used to share dacpac for database deployment through Azure DevOps artifacts
  3. Navigate to the Releases section under the Pipelines tab. Select the release definition MHCDocker.release, click Edit Pipeline option and then click on the Tasks section.

    Release

    Release Tasks

  4. The usage details of the agents are provided below:

    Agents Usage Details
    DB deployment The Hosted VS2017 agent is used to deploy the database
    Web App deployment The Hosted Ubuntu 1604 agent is used to deploy the application to the Linux Web App
  5. Under the Execute Azure SQL:DacpacTask section, select the Azure Subscription from the dropdown.

    Execute Azure SQL:DacpacTask: This task will deploy the dacpac to the mhcdb database so that the schema and data is configured for the backend.

    Update DB Task

  6. Under Azure App Service Deploy task, update the Azure subscription and Azure Service name with the endpoint components from the dropdown.

    Azure App Service Deploy will pull the appropriate docker image corresponding to the BuildID from repository specified, and then deploys the image to the Linux App Service.

    Update repository

  7. Click on the Variables section, update the ACR details and the SQLserver details with the details noted earlier while configuration of the environment and click on the Save button.

    Update variables

    The Database Name is set to mhcdb, the Server Admin Login is set to sqladmin and the Password is set currently to P2ssw0rd1234.

Exercise 3: Initiate the CI Build and Deployment through code commit

In this exercise, the source code will be modified to trigger the CI-CD.

  1. Click on Files section under the Repos tab, and navigate to the Docker/src/MyHealth.Web/Views/Home folder and open the Index.cshtml file for editing.

    Edit code

  2. Modify the text JOIN US to CONTACT US on the line number 28 and then click on the Commit button.This action would initiate an automatic build for the source code.

    Line Edit

  3. Click on Builds tab, and subsequently select the build definition MHCDoker.build and again click on ellipsis to view the build in progress.

    Build

    Build

  4. The Build will generate and push the docker image of the web application to the Azure Container Registry. Once the build is completed, the build summary will be displayed.

    Build Summary

  5. Navigate to the Azure Portal and click on the App Service that was created at the beginning of this lab. Select the Container Settings option and provide the information as suggested and then click the Save button.

    Field Value to be provided
    Image Source Select the value Azure Container Registry
    Registry Select the registry value from the dropdown
    image Select the value myhealth.web
    Tag Select the value latest. This is required to map Azure Container Registry with the Web App.

    Update registry

  6. Navigate to the Azure Container Portal and then select the Repositories option to view the generated docker images.

    Repository

  7. Navigate to the Releases section under Pipelines tab, and double-click on the latest release displayed on the page. Click on Logs to view the details of the release in progress.

    Release Progress

    Release Progress

  8. The release will deploy the docker image to the App Service based on the BuildID tagged with the docker image. Once the release is completed, the release Logs will be displayed.

    Summary

  9. Navigate back to the Azure Portal and click on the Overview section of the App Service. Click on the link displayed under the URL field to browse the application and view the changes.

    Web app URL

    Final Result

  10. Use the credentials Username: user and Password: P2ssw0rd@1 to login to the HealthClinic web application.

Summary

With Azure DevOps and Azure, we have configured a dockerized application by leveraging docker capabilities enabled on Azure DevOps Ubuntu Hosted Agent.