Azure Container Registry (ACR) Integration with Docker

Bridging the Gap: Integrating Azure Container Registry (ACR) with Docker using Code Examples

In the realm of containerized applications, Docker reigns supreme for building images, while Azure Container Registry (ACR) serves as a secure haven for storing and managing those images within the Azure cloud. This guide acts as your bridge, guiding you through the integration process between Docker and ACR with illustrative code examples.


  • Azure Subscription: An active Azure subscription is essential to create an ACR instance.
  • Docker Installed: Ensure you have Docker installed and configured on your development machine.
  • Azure CLI (Recommended): The Azure CLI offers a convenient way to interact with Azure services from your terminal. You can also use the Azure portal for ACR management.

Creating an Azure Container Registry:

  1. Azure Portal: Log in to the Azure portal ( and navigate to the “Create a resource” section.
  2. Search for ACR: Search for “Azure Container Registry” and select it to initiate the creation process.
  3. Configure ACR Details: Provide a name, resource group, location, and pricing tier for your ACR instance.

Code Snippet (Creating an ACR using Azure CLI):

# Login to Azure (replace with your credentials)
az login

# Set subscription (if you have multiple)
az account set --subscription <your-subscription-id>

# Create a resource group (optional, customize the name)
az group create --name myResourceGroup --location westus

# Create an ACR instance (replace with your desired name)
az acr create --name myacr --resource-group myResourceGroup --sku Basic

This code snippet demonstrates creating an ACR instance named myacr in the myResourceGroup resource group using the Azure CLI. Update placeholders with your information and choose the appropriate SKU based on your needs.

Logging in to ACR from Docker:

Before pushing or pulling images, you’ll need to log in to your ACR from the Docker CLI.

Code Snippet (Logging in to ACR using Docker CLI):

# Replace <acr-name> and <your-password> with your actual values
docker login <acr-name> -u <your-username> -p <your-password>

Note: It’s highly recommended to use an access token instead of your password for enhanced security. Refer to Microsoft documentation for creating access tokens for ACR authentication with Docker.

Pushing a Docker Image to ACR:

  1. Tag the Image for ACR: Use the docker tag command to tag your local Docker image with your ACR login server and desired image name.

Code Snippet (Tagging an Image for ACR):

# Replace <acr-name> with your ACR name and <image-name> with your image name
docker tag my-local-image:latest <acr-name><image-name>:latest
  1. Push the Image: Use docker push to push the tagged image to your ACR registry.

Code Snippet (Pushing an Image to ACR):

docker push <acr-name><image-name>:latest

Pulling an Image from ACR to Docker:

  1. Pull the Image: Use docker pull to pull the image from your ACR to your local Docker daemon.

Code Snippet (Pulling an Image from ACR):

# Replace <acr-name> and <image-name> with your actual values
docker pull <acr-name><image-name>:latest

Benefits of ACR Integration:

  • Secure Storage: ACR provides a secure and managed environment for storing your private Docker images within Azure.
  • Geo-Replication: ACR offers geo-replication capabilities, ensuring image availability across different regions for disaster recovery and global deployments.
  • Access Control: Implement granular access control within ACR to manage who can push, pull, or delete images from your registry.
  • Integration with Azure Services: ACR integrates seamlessly with other Azure services like Azure Kubernetes Service (AKS) for streamlined container deployments.

Code Snippet (Deploying an ACR Image to AKS – Not a complete example):

Note: Deploying an image from ACR to AKS involves a multi-step process beyond the scope of this guide. Refer to Microsoft documentation for detailed instructions on deploying containerized applications to AKS using ACR.

By following these steps and leveraging the provided code examples, you’ll establish a seamless workflow for integrating Docker with Azure Container Registry. Remember, ACR offers a robust solution for managing your Docker images