Azure Container Registry Deploy – Docker Build & Push Task

Easily build and push Docker images to Azure Container Registry (ACR) directly from your Azure DevOps pipelines, using secure and robust Azure Resource Manager (ARM) service connections.

This extension is your DevOps companion for deploying containerized applications to ACR in a smooth, automated, and ARM-authenticated way. Say goodbye to service principal secrets and hello to centralized, policy-driven access.

🚀 Features

• 🔧 Build Docker images from a specified Dockerfile and working directory.
• 📤 Push multiple tags of the same image to ACR.
• 🔐 Authenticate using ARM service connections, eliminating the need for username/password or admin access.
• 📝 Multi-line tag support – push as many tags as your heart desires.
• 🔁 Reusable in both CI and CD pipelines.
• ✅ Works with both Microsoft-hosted and self-hosted agents.

🔒 Why ARM Connections?

Unlike classic authentication methods, Azure Resource Manager service connections allow for:

• Centralized credential management
• Role-Based Access Control (RBAC)
• Fine-grained access and auditability
• Seamless integration with pipeline security policies

🛠️ How to Use

1. Install this extension from the Azure DevOps Marketplace.
2. Create or select an existing Azure Resource Manager service connection with AcrPush role.
3. Add the Azure Container Registry Deploy task to your pipeline.
4. Configure the following inputs:
   • ✅ Azure Resource Manager Connection
   • 🏷️ Registry Name (ACR name, not full login server)
   • 📂 Dockerfile path
   • 📁 Working directory (optional)
   • 🧾 Docker tags (multi-line supported)

🧪 Example YAML Pipeline

steps:
- task: AzureContainerRegistryDeploy@1
  inputs:
    connectedServiceName: 'My Azure Connection'
    azureContainerRegistryName: 'myregistry'
    dockerfilePath: 'src/Dockerfile'
    workingDirectory: 'src'
    dockerTags: |
      latest
      $(Build.BuildId)