docker-registry-importer

docker-registry-importer is a tool to import images from a tar (not a file saved with docker save!) file.

Export

Usage of docker-registry-importer:
  -export
        export
  -cache-dir string
        cache directory for export
  -config string
        config
  -file string
        tar file to import
  -include-repo-name
        includeRepoName

Example

$ docker-registry-importer --export \
  --file images.tar \
  --cache-dir ./cache \
  docker.io/library/alpine:3.18 \
  docker.io/library/busybox:1.36.0

Import

Usage of docker-registry-importer:
  -file string
        tar file to import
  -url string
        registry address (e.g. http://docker-registry.io/v2/)
  -username string
        registry username
  -password string
        registry password
  -proxy string
        socks5 proxy (e.g. 1.2.3.4:1234)

Example

$ docker-registry-importer --import \
  --url http://docker-registry.io \
  --file images.tar \
  --username username \
  --password password

Config File Structure

{
  "repositories": {
    "custom-registry-1.io": {
      "endpoint": "http://custom-registry-1.io",
      "username": "username",
      "password": "password"
    },
    "docker.io": {
      "endpoint": "https://registry-1.docker.io"
    }
  }
}

tar archive structure

library/something/manifests/v1.2.3
repo/name/manifests/TAG_NAME
...
library/something/manifests/sha256:e372ed08ad996742c98b2bf83df787ac26cb1062063986db65c2fe5b34a35fe2
library/something/manifests/sha256:DIGEST
...
blob/sha256:284842a36c0d8eea230cfd5e7a4a6b450fcd63d1c4737f236a91e1671455050a
blob/sha256:3cca8e8510b3d56a64390c3328b31be3a09171557044c1e6431e7bf6ba90f255
blob/sha256:DIGEST
...

License

Apache-2.0