Containerize ASP.NET Core API with Docker for Azure Kubernetes


Containerizing an ASP.NET Core API with Docker and managing containers using Azure Kubernetes Service (AKS) involves several steps. Below, I'll provide a step-by-step guide to help you achieve this. Please note that this is a high-level guide, and you may need to adjust the specific details based on your project's requirements and the current state of Azure services.


  1. An Azure account: You'll need an Azure account to create an AKS cluster and other necessary resources.
  2. Docker: Install Docker on your local machine. You can download it from the Docker website.
  3. .NET Core SDK: Install the .NET Core SDK for building and running your ASP.NET Core API. You can download it from the .NET website.

Step 1. Create an ASP.NET Core API

Create a new ASP.NET Core Web API project using the following command.

dotnet new webapi -n MyApi

This command creates a new ASP.NET Core API project named "MyApi."

Step 2. Build and Test the API

Build and test your API locally to ensure it's working correctly. Use the following commands to build and run the API.

cd MyApi
dotnet build
dotnet run

Your API should be accessible at https://localhost:5001 by default. Test it using a tool like a curl or a web browser.

Step 3. Dockerize the ASP.NET Core API

Create a Dockerfile in the root of your API project to define how to build the Docker image. Below is a sample Dockerfile for an ASP.NET Core API.

# Use the official ASP.NET Core runtime image as a base
FROM AS base

# Use the official ASP.NET Core SDK image for building the app
FROM AS build
COPY ["MyApi.csproj", "MyApi/"]
RUN dotnet restore "MyApi/MyApi.csproj"
COPY . .
WORKDIR "/src/MyApi"
RUN dotnet build "MyApi.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "MyApi.csproj" -c Release -o /app/publish

FROM base AS final
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyApi.dll"]

Build the Docker image by running the following commands from the root of your API project.

docker build -t myapi:latest .

Step 4. Test the Dockerized API Locally

Run the Docker container locally to make sure it works.

docker run -d -p 8080:80 --name myapi-container myapi:latest

The API should now be accessible at http://localhost:8080.

Step 5. Push the Docker Image to Azure Container Registry (ACR)

You need a container registry to store your Docker image. Create an Azure Container Registry if you don't have one already.

az acr create --resource-group <resource-group-name> --name <acr-name> --sku Basic

Log in to your Azure Container Registry.

az acr login --name <acr-name>

Push the Docker image to your Azure Container Registry.

docker tag myapi:latest <acr-name>
docker push <acr-name>

Step 6. Create an Azure Kubernetes Service (AKS) Cluster

Create an AKS cluster in Azure. Replace <resource-group-name> and <aks-cluster-name> with your desired values.

az aks create --resource-group <resource-group-name> --name <aks-cluster-name> --node-count 1 --enable-addons monitoring --generate-ssh-keys

Step 7. Configure kubectl to Use AKS Cluster

Configure kubectl to use your AKS cluster:

az aks get-credentials --resource-group <resource-group-name> --name <aks-cluster-name>

Step 8. Deploy the ASP.NET Core API to AKS

Create a Kubernetes Deployment and Service to deploy your ASP.NET Core API.

apiVersion: apps/v1
kind: Deployment
  name: myapi-deployment
  replicas: 1
      app: myapi
        app: myapi
        - name: myapi-container
          image: <acr-name>
            - containerPort: 80

apiVersion: v1
kind: Service
  name: myapi-service
    app: myapi
    - protocol: TCP
      port: 80
      targetPort: 80
  type: LoadBalancer

Apply the configuration to your AKS cluster:

kubectl apply -f deployment.yaml

Step 9. Access the API

Get the external IP address of your AKS service:

kubectl get svc myapi-service

You should now be able to access your ASP.NET Core API using the external IP address provided by AKS.

That's it! You've containerized your ASP.NET Core API with Docker and deployed it to Azure Kubernetes Service (AKS). This is a simplified guide, and in a production scenario, you would need to consider security, scaling, and other factors.


Containerizing an ASP.NET Core API with Docker and managing containers using Azure Kubernetes Service (AKS) is a powerful approach for deploying and scaling your applications in a containerized, orchestrated environment. Here's a summary of the key steps:

  1. Create ASP.NET Core API: Develop your ASP.NET Core API locally and ensure it works correctly.
  2. Dockerize the API: Create a Dockerfile to define how to build a Docker image for your API. Build and test the Docker image locally.
  3. Push to Azure Container Registry (ACR): Set up an Azure Container Registry, push your Docker image to it, and make it available for AKS.
  4. Create AKS Cluster: Create an Azure Kubernetes Service (AKS) cluster to host your containers. Ensure it's properly configured.
  5. Configure kubectl: Use the Azure CLI to configure kubectl to interact with your AKS cluster.
  6. Deploy to AKS: Create Kubernetes Deployment and Service configurations to deploy your Dockerized API to the AKS cluster.
  7. Access Your API: Get the external IP address of your AKS service to access your API.

Remember that this is a simplified guide, and in a real-world scenario, you would need to consider additional factors such as:

  1. Security: Implement security measures like network policies, secrets management, and identity and access control.
  2. Scaling: Configure auto-scaling based on resource usage or other metrics to handle varying workloads.
  3. Logging and Monitoring: Set up logging and monitoring solutions to gain insights into your application's behavior and performance.
  4. Continuous Integration and Deployment (CI/CD): Implement a CI/CD pipeline to automate the deployment process.
  5. Backup and Disaster Recovery: Plan for data backup and recovery in case of failures.
  6. Cost Management: Monitor and optimize the cost of running your AKS cluster and other Azure resources.

Containerization and orchestration technologies like Docker and AKS provide flexibility and scalability for modern applications. As you work with these tools, you'll gain valuable experience in managing containerized applications and infrastructure in a cloud-native environment.

Similar Articles