ACRBuildAndPushGuide.md

Azure Container Registry (ACR) – Build & Push Guide

This guide provides step-by-step instructions to build and push Docker images for WebApp and Backend services into Azure Container Registry (ACR).

📋 Prerequisites

Before starting, ensure you have:

• An active Azure Subscription

• Azure CLI installed and logged in

• Docker Desktop installed and running

• Access to your Azure Container Registry (ACR)

• To create an Azure Container Registry (ACR), you can refer to the following guides:

  • Create Container Registry using Azure CLI

  • Create Container Registry using Azure Portal

  • Create Container Registry using PowerShell

  • Create Container Registry using ARM Template

  • Create Container Registry using Bicep

---

Login to ACR :

az acr login --name $ACR_NAME

🚀 Build and Push Images

Backend :

az acr login --name <containerregname>
cd src/api
docker build --no-cache -f ApiApp.Dockerfile -t <acrloginserver>/<repo>:<tagname> .
docker push <acrloginserver>/<repo>:<tagname>

If you want to update image tag and image manually you can follow below steps:

• Go to your api App Service in the Azure Portal.

• In the left menu, select Deployment → Deployment Center

• Under Registry settings, you can configure:

  • Image Source → (e.g., Azure Container Registry / Docker Hub / Other).

  • Image Name → e.g., myapp/backend.

  • Tag → e.g., v1.2.3.

WebApp :

az acr login --name <containerregname>
cd src/App
docker build --no-cache -f WebApp.Dockerfile -t <acrloginserver>/<repo>:<tagname> .
docker push <acrloginserver>/<repo>:<tagname>

If you want to update image tag and image manually you can follow below steps:

• Go to your App Service in the Azure Portal.

• In the left menu, select Deployment → Deployment Center

• Under Registry settings, you can configure:

  • Image Source → (e.g., Azure Container Registry / Docker Hub / Other).

  • Image Name → e.g., myapp/backend.

  • Tag → e.g., v1.2.3.

✅ Verification

Run the following command to verify that images were pushed successfully:

az acr repository list --name $ACR_NAME --output table

You should see repositories in the output.

📝 Notes

• Always use meaningful tags (v1.0.0, staging, prod) instead of just latest.

• If you are pushing from a CI/CD pipeline, make sure the pipeline agent has access to Docker and ACR.

• For private images, ensure your services (e.g., Azure Container Apps, AKS, App Service) are configured with appropriate ACR pull permissions.