pip install requests

python docker_pull.py [image_name] [options]

# Download latest nginx
python docker_pull.py nginx:latest

# Download specific platform image
python docker_pull.py --platform linux/arm64 ubuntu:20.04

# Custom concurrency
python docker_pull.py --max-concurrent-downloads 5 alpine:latest

# Disable caching
python docker_pull.py nginx:latest --no-cache

# Custom cache directory
python docker_pull.py nginx:latest --cache-dir /path/to/cache

# Import layers from existing Docker tar file to cache
python docker_pull.py --import-tar existing_image.tar

# Use standalone import tool
python import_tar.py existing_image.tar --cache-dir /path/to/cache

# Docker Hub login
python docker_pull.py library/ubuntu:latest \
  --username myuser --password mypass

# Private Harbor registry
python docker_pull.py harbor.company.com/dev/app:v1.2.0 \
  --username devuser --password devpass

# Use environment variables (more secure)
export USER=myuser
export PASS=mypass
python docker_pull.py private-image:latest \
  --username $USER --password $PASS

python docker_pull.py [-h] [--platform PLATFORM]
                      [--max-concurrent-downloads MAX_CONCURRENT_DOWNLOADS]
                      [--username USERNAME] [--password PASSWORD]
                      [--cache-dir CACHE_DIR] [--no-cache]
                      [--import-tar IMPORT_TAR]
                      image

Arguments:
- image: Docker image name [registry/][repository/]image[:tag|@digest]
- --platform: Target platform (linux/amd64, linux/arm64, linux/arm/v7, etc.)
- --max-concurrent-downloads: Maximum concurrent download layers (default: 3)
- --username: Username (for private image source authentication)
- --password: Password (for private image source authentication)
- --cache-dir: Layer cache directory (default: ./docker_images_cache)
- --no-cache: Disable layer caching feature
- --import-tar: Import layers from existing Docker tar file to cache

# Prepare images for ARM devices on x86 server
python docker_pull.py --platform linux/arm64 nginx:latest
# Generates nginx_arm64.tar, can be transferred to ARM device for import

# GitHub Actions example
- name: Pull Docker image
  run: |
    python docker_pull.py ${{ secrets.REGISTRY }}/${{ secrets.IMAGE }}:${{ env.TAG }} \
      --username ${{ secrets.USERNAME }} \
      --password ${{ secrets.PASSWORD }}

# Batch download different platform images
python docker_pull.py myregistry.com/app:v1.0 --platform linux/amd64 --username user --password pass
python docker_pull.py myregistry.com/app:v1.0 --platform linux/arm64 --username user --password pass

# First download base image
python docker_pull.py ubuntu:20.04
# 💾 Cache Statistics: Cache hits: 0/5 layers (0.0%)

# Download related image, automatically reuse base layers
python docker_pull.py ubuntu:20.04-slim
# 💾 Cache Statistics: Cache hits: 3/4 layers (75.0%), Data saved: 45.2 MB

# Repeat download, 100% cache hit
python docker_pull.py ubuntu:20.04
# 💾 Cache Statistics: Cache hits: 5/5 layers (100.0%), Data saved: 72.8 MB

# Import layers from existing Docker tar file to cache
python docker_pull.py --import-tar nginx_latest.tar
# 🔄 Starting import of Docker tar file to cache: nginx_latest.tar
# ✅ Successfully imported: 6 layers, 💾 Import data: 131.0 MB

# Or use standalone import tool
python import_tar.py existing_image.tar
# Support batch import of multiple tar files to preheat cache

# Recommended: Use environment variables
export DOCKER_USERNAME=myuser
export DOCKER_PASSWORD=mypass
python docker_pull.py image --username $DOCKER_USERNAME --password $DOCKER_PASSWORD

# Not recommended: Direct password in command line
python docker_pull.py image --username user --password pass  # Insecure

# Error: 401 Unauthorized
# Solution: Check if username and password are correct
python docker_pull.py private-image --username user --password pass

# Error: 403 Forbidden
# Solution: Check user permissions

# Error: Platform mismatch
# Solution: View available platform list
python docker_pull.py image --platform invalid
# Script will display all available platforms

# Set proxy
export HTTP_PROXY=http://proxy:8080
export HTTPS_PROXY=http://proxy:8080
python docker_pull.py image

# View help
python docker_pull.py --help

# Download image (auto cache)
python docker_pull.py nginx:latest --platform linux/amd64
# 💾 Cache Statistics: Cache hits: 0/6 layers (0.0%)

# Repeat download (cache hit)
python docker_pull.py nginx:latest --platform linux/amd64
# 💾 Cache Statistics: Cache hits: 6/6 layers (100.0%), Data saved: 131.0 MB

# Import existing tar file to cache
python docker_pull.py --import-tar existing_image.tar
# 🔄 Starting import of Docker tar file to cache...

# View cache directory
ls -la docker_images_cache/layers/