ACRBuildAndPushGuide.md

Azure Container Registry (ACR) – Build & Push Guide

This guide provides step-by-step instructions to build and push Docker images for all four services (Content Processor, Content Processor API, Content Process Workflow, and Content Processor Web) 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

Each service has its own Dockerfile in its project root directory.

Content Processor (Background Worker):

az acr login --name <containerregname>
docker build --no-cache -f src/ContentProcessor/Dockerfile -t <acrloginserver>/contentprocessor:<tagname> src/ContentProcessor
docker push <acrloginserver>/contentprocessor:<tagname>

Content Processor API (REST API):

az acr login --name <containerregname>
docker build --no-cache -f src/ContentProcessorAPI/Dockerfile -t <acrloginserver>/contentprocessorapi:<tagname> src/ContentProcessorAPI
docker push <acrloginserver>/contentprocessorapi:<tagname>

Content Process Workflow (Claim Processor):

az acr login --name <containerregname>
docker build --no-cache -f src/ContentProcessorWorkflow/Dockerfile -t <acrloginserver>/contentprocessworkflow:<tagname> src/ContentProcessorWorkflow
docker push <acrloginserver>/contentprocessworkflow:<tagname>

Content Processor Web (Frontend):

az acr login --name <containerregname>
docker build --no-cache -f src/ContentProcessorWeb/Dockerfile -t <acrloginserver>/contentprocessorweb:<tagname> src/ContentProcessorWeb
docker push <acrloginserver>/contentprocessorweb:<tagname>

Updating Container Apps Manually

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 → the corresponding image name (e.g., contentprocessor, contentprocessorapi, contentprocessworkflow, contentprocessorweb).

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

• Click Save → this will create a new revision automatically with the updated image.

✅ 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.