Contents

Build and Deploy an ASP .Net Core Web Application as Docker Container using Microsoft Azure – Part 3

This is the final part of the series about building an ASP .Net Core Web Application and deploying it as a Docker container using Microsoft Azure. Here, we are going to set up a Microsoft Azure DevOps release pipeline to automate the deployment of our application as a container on Azure Web App Service.

If you have been following along, you should have:

  • a GitHub repository with an ASP .Net Core web application
  • a Dockerfile to build an image for your application
  • Azure DevOps Pipelines integration with GitHub to automatically trigger a build
  • a Continuous Integration (CI) pipeline in Azure DevOps to build Docker Image and push it to Docker Hub

Three parts in series:


Deploy manually on Azure Web App Service

Before we get into any automation, let’s first deploy our application manually and see if it’s working. In order to do that, go to the Microsoft Azure portal and provide the login details.

From the navigation panel, select App Services and then select Add. On the window that follows:

  • provide a name for your application
  • select subscription
  • you may create a new resource group or use an existing resource group
  • select the required OS
  • for Publish, select Docker Image

featured-image.png
Adding Azure App Service

The next step is to select Configure Container and provide details about the Docker image you want to use for your application. By default, Single Container is active. Select **Docker Hub **as the image registry, or whichever is applicable. Select, if your registry is private or public and then provide the name of your Docker image.

/setup-release-pipeline-with-azure-devops/config-container.png
Container configuration

Once you click Apply, you are redirected to the previous page. Click Create and the deployment will start after a few validations that will not take too long.

Once the deployment is complete, you get a notification. After that, if you refresh the App Services page, the newly created app will be on the list.

/setup-release-pipeline-with-azure-devops/deployment-success.png
Deployment notification

Congratulations!! You just deployed your application as a Docker container on Microsoft Azure App Services.


Testing the application

It’s time to check if your application is actually working or not. From the App Services page, select your app. Now, from the top right of the overview pane grab the URL for your application.

/setup-release-pipeline-with-azure-devops/app-url.png
Get the Azure App URL

Open the URL in your favorite browser and you must have your application working. Here is mine:

/setup-release-pipeline-with-azure-devops/working-app.png
Manually deployed application

If the application is not working, the first thing you want to check is the logs. For that, go to Settings > Container Settings and you see the Logs. Here is how it looks:

/setup-release-pipeline-with-azure-devops/app-logs.png
Deployment Logs for Container


Adding Service Connection

For the release pipeline to be able to deploy your application automatically on Azure App Services, it requires to have access to the Azure resources.

In order to grant the access, go to Project Properties > Service Connections and then select New service connection.

From the list, select Azure Resource Manager and fill the details on the modal window that follows. Select scope level as Subscription and then select your subscription. Later select the resource group in which you have created the App Service for your application.

/setup-release-pipeline-with-azure-devops/service-connection.png
Add Service Connection for Azure Resources


Azure DevOps Release Pipeline

Alright then! It’s time to automate our next release by creating a release pipeline in Azure. Go to Azure DevOps, select your organization and project.

Under Pipelines select Releases and then click on the New pipeline. Let’s start by giving your pipeline a nice name, using the text field at the top.

Adding a Build Artifact

Now, let’s add an artifact to the pipeline. Click on Add an artifact and select Docker Hub as the source type. From the dropdown select service connection for Docker Hub which we had set up in the previous article.

/setup-release-pipeline-with-azure-devops/add-artifact.png
Adding an artifact for Release Pipeline

Select the namespace and repository you want to have set up for your application. For the default version, you may either select Latest or Specify at the time of release creation. It depends on your requirements.

If you select Latest, you have to ensure that you always tag your Docker images as latest in the build pipeline. I prefer to use the other option.

Adding tasks to Pipeline

We now have to add a stage to the release pipeline. Click on Add a stage and select Azure Web App on Container Deploy and give it a name. And switch to the Tasks tab.

The first entry in the task list is the agent setup, for which we are going to select Hosted Ubuntu 1604 as the agent pool. You can leave the rest as is.

Now, select the second task and under Azure subscription, select the service connection we have set up in earlier steps. After that, it gives you the list of applications to select from. The most important is the Image name. Therefore, please ensure that it is exactly the same as what you have set up in the build pipeline.

/setup-release-pipeline-with-azure-devops/task-definition.png
Release Pipeline Task Definition

We are almost done here. However, there is one missing. We have not yet enabled the automatic trigger for the release pipeline to start. Let’s do that now.

Go back to the Pipeline tab. If you now click the lightning bolt symbol at the top right of the artifact, it allows you to enable Continuous deployment trigger. So, go ahead and do that.

/setup-release-pipeline-with-azure-devops/release-trigger.png
Continuous deployment trigger

You can also add certain filters to the trigger if you want. But for now, I will keep it easy and simple. Finally, save the release pipeline.


Testing the CI/CD Pipeline (end-to-end test)

Finally, it’s time to test everything we have done so far. In order to do so:

  • change something in your application
  • push the changes to the master branch
  • the build pipeline starts and pushes a new image to Docker Hub
  • push to Docker Hub triggers the release pipeline
  • the latest changes in your application are now visible

Take your time and change something that you can use to verify if everything is working. In fact, you can also refer the logs of your Azure App Service, to validate which tag of the Docker image is running at the moment.

/setup-release-pipeline-with-azure-devops/deployment.png
Logs of new deployment with Release Pipeline

For instance, in the above image, notice the logs highlighted with green squares. This shows that the Azure DevOps Pipelines that I have set up is working.

Many many congratulations!! We have achieved our goal.


Conclusion

To begin with, we developed an ASP .Net Core based web application and put our code in a GitHub repository. After that, we set up a build pipeline to automatically build a Docker image for our application and later push it to Docker Hub. Next, in this article, we have created a release pipeline to automatically deploy our application as a Docker container on the Azure Web App service.

I hope it’s working for you as well, however, if you are facing an issue at any part of this series, I will be really glad to help you out.