README.md

Azure Container Registry Mirror Tool

This project will help you to mirror Azure Container Registry across subscriptions.

It's possible to filter by docker tags.

• acr-mirror
  • Installation
  • Using
    • Update all repositories
  • Example config.yaml

Installation

Azure Container Registry Mirror Tool is available on Linux, ARM, macOS and Windows platforms.

• Binaries for Linux, ARM, Windows and Mac are available as tarballs in the release page

Using

Make sure that you are logged into to Azure (az login)

acr-mirror will automatically mirror Azure Container Registry across subscriptions, so you do not need to login and do any UI operations in the Azure Portal.

Update all repositories

• run acr-mirror and wait (for a while)

Example config.yaml

---
source_subscription_id: "65113025-94f4-47c9-907a-81f3659078e6" # Azure source subscription id
target_subscription_id: "2c2288a3-11a6-4ce6-ae3a-28a336a1e86b" # Azure target subscription id

registries:
- name: "acr1oam"
  resourceGroupName: "TestACR1"
  repositories: 
  - "nginx"
  maxMirrorImages: 100 # Limit number of images to be mirrored, default is 100
  tags: # specific tag match
  - "*"
  target: 
  - name: "acr2oam"
    resourceGroupName: "TestACR2"
    prefix: "pregolden" # prefix for target repository
    rePrefix: "golden" # rename prefix for target repository

Environment Variables

Environment Variable	Default	Description
CONFIG_FILE_NAME	config.yaml	config file to use
RESOURCE_URL	https://management.azure.com	Azure resource url