Azure Container Registry (ACR)

September 29, 2025 ยท View on GitHub

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:


Login to ACR :

az acr login --name $ACR_NAME

๐Ÿš€ Build and Push Images

Backend :

az acr login --name <containerregname>
docker build --no-cache -f docker/Backend.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 Container App in the Azure Portal.

  • In the left menu, select Containers.

  • Under your container, update:

    • Image source โ†’ Azure Container Registry / Docker Hub.

    • Image name โ†’ myapp/backend.

    • Tag โ†’ change to the new one you pushed (e.g., v2).

  • Click Save โ†’ this will create a new revision automatically with the updated image.

alt text

WebApp :

az acr login --name <containerregname>
docker build --no-cache -f docker/Frontend.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 Container 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.

alt text

โœ… 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.