/dotnet-container-app

This repository contains an example application developed in dotnet using containers

Primary LanguageC#MIT LicenseMIT

Dotnet Container App

This .NET 6 example application to demonstrate the process of creating a container application and deploying it to Azure Kubernetes Services (AKS)

Application

This is the application architecture diagram

Architecture Diagram

The project is divided as follows:

  • src/aspnetcoreiac: Bicep files for create Azure environment
  • src/aspnetcorewebapi: Rest APIs to communicate with database
  • src/aspnetcorewebapp: Web Application interact with rest API
  • src/aspnetcorewebapi.test: Unit Testing project

Getting Started

Prerequisites

Quickstart

Follow the steps below to run the application locally

# Clone the repository
git clone https://github.com/Azure-Samples/dotnet-container-app.git

# switch to repository directory
cd dotnet-container-app

# Open Visual Studio Code
code .

You will need to configure the Connection String in file /src/aspnetcorewebapi/appsettings.json

Connection String

Connection String example: *Data Source=(LocalDb)\\MSSQLLocalDB;Initial Catalog=TodoItem_DB;Integrated Security=SSPI;*

To run the application in debug mode, select the Debug menu and select the aspnetcorewebapi & aspnetcorewebapp option as shown in the image below

Running

Another option to run application based on docker containers. This application user 3 containers as show bellow:

  • aspnetcoredb: SQL Server
  • aspnetcorewebapi: Rest APIs to communicate with SQL Server database (backend)
  • aspnetcorewebapp: ASP NET MVC application to communicate with API (frontend)

In the root directory of the application we have the DockerCompose.yml file with all the necessary configurations to running the application using containers. To start run the command below.

docker-compose -f 'DockerCompose.yml' up --build -d

Docker Compose

Publish to Azure

In this section I will show you the steps to publish the application in Azure. To create the environment in Azure we are using the concept of Infrastructure as Code (IAC) where we have a bicep file that we declare all the resources we need to create in Azure. You can see this main.bicep file.

This bicep file will create the following resources in Azure.

  • Azure Container Registry (ACR) ACR allows you to build, store, and manage container images and artifacts in a private registry for all types of container deployments

  • Azure Kubernetes Services (AKS) AKS simplifies deploying a managed Kubernetes cluster in Azure by offloading the operational overhead to Azure

  • SQL Server Database is a relational database-as-a-service (DBaaS) hosted in Azure that falls into the industry category of Platform-as-a-Service (PaaS).

  • Azure Monitor helps you maximize the availability and performance of your applications and services. It delivers a comprehensive solution for collecting, analyzing, and acting on telemetry from your cloud and on-premises environments.

First step is create a Service Principal identity to GitHub connect to Azure Subscription

# Login Azure
az login

# Get subscription ID
$subscriptionID = $(az account show --query id -o tsv)

# Create Service Principal
az ad sp create-for-rbac --name <Service Principal Name> --role contributor --scopes /subscriptions/$subscriptionID --sdk-auth

The command should output a JSON object similar to this:

{
  "clientId": "<GUID>",
  "clientSecret": "<PASSWORD>",
  "subscriptionId": "<GUID>",
  "tenantId": "<GUID>",
  "activeDirectoryEndpointUrl": "<URL>",
  "resourceManagerEndpointUrl": "<URL>",
  "activeDirectoryGraphResourceId": "<URL>",
  "sqlManagementEndpointUrl": "<URL>",
  "galleryEndpointUrl": "<URL>",
  "managementEndpointUrl": "<URL>"
}

Store the output JSON as the value of a GitHub Actions secret named 'AZURE_CREDENTIALS'

  • Under your repository name, click Settings.
  • In the Security section of the sidebar, click Secrets and select Actions.
  • At the top of the page, click New repository secret
  • Provide the secret name as AZURE_CREDENTIALS
  • Add the output JSON as secret value
  • Click Add secret button.

Add Secret

Create other two secrets

  1. Store SQL username 'AZURE_SQL_USERNAME'
  2. Store SQL password 'AZURE_SQL_PASSWORD'

Now we are ready to start the workflow aspnetcore-deployment.yml. This workflow has the following these steps

  • IAC
    • Run the Bicep file to create environment
  • Build
    • Check out source code
    • Docker Login to ACR
    • Docker Build and Push to ACR
    • Replace the image URL variables
    • Create kubernetes YML artifact
  • Release
    • Download the kubernetes YML artifact
    • Configure the AKS context
    • Create Secret
    • Deploy the application to AKS

Navigate to the file aspnetcore-deployment.yml and replace the variable values.

  • AZ_RG_NAME
  • AZ_RG_LOCATION
  • AZ_ACR_NAME
  • AZ_AKS_NAME
  • AZ_SQLSERVER_NAME

This example using manual trigger, to start the workflow following these steps:

  • Under your repository name, click Actions tab.
  • In the left sidebar, click the workflow aspnetcore-deployment.
  • Above the list of workflow runs, select Run workflow.
  • Use the Branch dropdown to select the workflow's main branch, Click Run workflow.

Bicep Workflow

Workflow result

Azure Resources

After deployment, below resources will be created in your Azure subscription

Azure Resources

After the workflow ends, our application will be available for use.

  • Log in Azure Portal
  • Select the resouce group rg-dotnet-containerapp
  • Select the AKS cluster Kubernetes Service Name
  • In the Kubernetes resources section of the sidebar, click Services and ingresses
  • Check the external IP for the aspnetcorewebapp-svc service

Kubernetes Services

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

Found an Issue?

If you find a bug in the source code or a mistake in the documentation, you can help us by submitting an issue to the GitHub Repository. Even better, you can submit a Pull Request with a fix.

Want a Feature?

You can request a new feature by submitting an issue to the GitHub Repository. If you would like to implement a new feature, please submit an issue with a proposal for your work first, to be sure that we can use it.

For more details Contributing to Dotnet Container App.