dockerhub-to-aliyun-acr-sync

Synchronizes Docker Hub image tags to Aliyun ACR Personal with optional platform selection.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/hugogu/skills --skill dockerhub-to-aliyun-acr-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dockerhub-to-aliyun-acr-sync
Source: https://github.com/hugogu/skills/tree/main/skills/dockerhub-to-aliyun-acr-sync
Command: npx skills add https://github.com/hugogu/skills --skill dockerhub-to-aliyun-acr-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync a Docker Hub image tag into Aliyun ACR Personal with the same repository basename and tag. Supports platform selection (linux/amd64, linux/arm64, etc.) and a two-phase network-switch workflow for environments behind the GFW where Docker Hub and Aliyun ACR are on separate networks.

Core Features & Use Cases

  • Sync a single Docker image tag from Docker Hub to Aliyun ACR Personal while preserving the original tag and repo basename.
  • Supports optional platform specification (linux/amd64, linux/arm64, etc.).
  • Two-phase workflow: pull from Docker Hub, then push to Aliyun ACR after user confirmation.
  • Environment variable handling for credentials (ALIYUN_ACR_REGISTRY, ALIYUN_ACR_USERNAME, ALIYUN_ACR_PASSWORD).
  • Use case: Mirror a critical image across networks that require VPN/allowed egress to both Docker Hub and Aliyun ACR.

Quick Start

Provide the source image with tag and optional platform, then follow Phase 1 to pull from Docker Hub and Phase 2 to push to Aliyun ACR after confirmation.

Frequently Asked Questions about dockerhub-to-aliyun-acr-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a Docker Hub image to Aliyun ACR?

Syncing a Docker Hub image to Aliyun ACR involves a two-phase workflow: pulling the image from Docker Hub first, then tagging and pushing it to Aliyun ACR Personal after user confirmation, preserving the original repository basename and tag.

Can I sync specific platforms like linux/arm64 when mirroring Docker images to Aliyun ACR?

Yes, platform selection is supported when mirroring Docker images to Aliyun ACR. You can specify platforms such as linux/amd64 or linux/arm64 during the pull phase to ensure the correct architecture is synced.

What environment variables do I need to push images to Aliyun ACR Personal?

Pushing images to Aliyun ACR Personal requires setting three environment variables: ALIYUN_ACR_REGISTRY for the registry URL, ALIYUN_ACR_USERNAME for the account name, and ALIYUN_ACR_PASSWORD for authentication credentials.

Why does the Docker Hub to Aliyun ACR sync require a two-phase pull and push workflow?

The two-phase pull-then-push workflow is designed for networks where Docker Hub and Aliyun ACR require separate access, such as environments behind the GFW. It allows you to pull from Docker Hub on one network, then switch and push to Aliyun ACR after confirmation.

What happens if I try to sync a Docker image without specifying a tag?

Syncing a Docker image without a tag will fail validation. The Skill requires the input image to contain an explicit tag before initiating the pull and push workflow to ensure the correct image version is mirrored.