go-oci-blob¶
go-oci-blob is a Go library that uploads and downloads OCI blobs. It covers the blob subset of the OCI distribution spec and nothing else: push, pull, existence checks, and cross-repository mounts, with retries and digest verification built in.
The runtime dependencies are the Go standard library plus
github.com/opencontainers/go-digest. Authentication is the caller's job:
inject an authenticated http.RoundTripper.
Documentation¶
Start here
- Push and pull your first blob — a hands-on introduction against a local registry.
Solve a problem
- How to authenticate to a registry
- How to enable chunked upload and parallel pull
- Refresh the registry compatibility matrix — maintainer procedure behind the compatibility reference.
Look up facts
- API reference on pkg.go.dev — the complete API contract lives in the package documentation.
- Embedding API — one-attempt retries, error inspection, wire progress, redirect policy, and caller-owned boundaries.
- Registry compatibility — verified behavior across nine registries.
Understand the design
- Design — scope, architecture, wire behavior, and the reasoning behind the API.