Registry handshake

curl -i http://localhost:5000/v2/

Expected:

HTTP/1.1 200 OK
Docker-Distribution-API-Version: registry/2.0

---

Start an upload

curl -i \
    -X POST \
    http://localhost:5000/v2/test/blobs/uploads/

Expected:

HTTP/1.1 202 Accepted

Location: /v2/test/blobs/uploads/<uuid>
Docker-Upload-UUID: <uuid>
Range: 0-0
Docker-Distribution-API-Version: registry/2.0

Store the upload UUID

UUID=$(curl -is \
    -X POST \
    http://localhost:5000/v2/test/blobs/uploads/ \
| awk '/Docker-Upload-UUID:/ {print $2}' | tr -d '\r')

echo "$UUID"

Verify the upload directory exists

If you're using the default local storage:

find ./registry/uploads

Or if you're using Databricks Volumes:

find /Volumes/main/images/registry/uploads

You should see something like:

uploads/
└── 0a2d1ef2-bba5-4728-b52b-5c82b9a71f96
    └── data

Stress test upload creation

Create ten upload sessions:

for i in {1..10}; do
    curl -s \
        -X POST \
        http://localhost:5000/v2/test/blobs/uploads/ \
        > /dev/null
done

Then count them:

find ./registry/uploads -maxdepth 1 -type d | wc -l

(or replace ./registry with your configured root.)

Verbose request

Useful while developing:

curl -v \
    -X POST \
    http://localhost:5000/v2/test/blobs/uploads/

This prints the full request and response headers.

Volume Layout

/Volumes/workspace/default/docker_images/
├── uploads/
│   └── <uuid>/
│       └── session.json
├── blobs/
│   └── sha256/
│       ├── ab/
│       └── cd/
├── repositories/
│   └── test/
│       ├── manifests/
│       └── tags/
└── _registry/
    ├── config.json
    └── version