registry

README

Taken and adapted from https://github.com/heroku/docker-registry-client

Documentation

Index

• Variables
• func Log(format string, args ...interface{})
• func Quiet(format string, args ...interface{})
• func WrapTransport(transport http.RoundTripper, scope, url, username, password string) http.RoundTripper
• type AuthorizationChallenge
• type BasicTransport
  • func (t *BasicTransport) RoundTrip(req *http.Request) (*http.Response, error)
• type ErrorTransport
  • func (t *ErrorTransport) RoundTrip(request *http.Request) (*http.Response, error)
• type HttpStatusError
  • func (err *HttpStatusError) Error() string
• type LogfCallback
• type Registry
  • func New(registryUrl, scope, username, password string) (*Registry, error)
  • func NewInsecure(registryUrl, scope, username, password string) (*Registry, error)
  • func NewSecure(registryUrl, scope, username, password, cert, key string) (*Registry, error)
  • func (registry *Registry) BlobMetadata(repository string, digest digest.Digest) (distribution.Descriptor, error)
  • func (registry *Registry) DeleteManifest(repository string, digest digest.Digest) error
  • func (registry *Registry) DownloadBlob(repository string, digest digest.Digest) (io.ReadCloser, error)
  • func (registry *Registry) HasBlob(repository string, digest digest.Digest) (bool, error)
  • func (registry *Registry) Manifest(repository, reference string) (*schema1.SignedManifest, error)
  • func (registry *Registry) ManifestDigest(repository, reference string) (digest.Digest, error)
  • func (registry *Registry) ManifestV2(repository, reference string) (*schema2.DeserializedManifest, error)
  • func (r *Registry) Ping() error
  • func (registry *Registry) PutManifest(repository, reference string, manifest distribution.Manifest) error
  • func (registry *Registry) Repositories() ([]string, error)
  • func (registry *Registry) Tags(repository string) (tags []string, err error)
  • func (registry *Registry) UploadBlob(repository string, digest digest.Digest, content io.Reader) error
• type TokenTransport
  • func (t *TokenTransport) RoundTrip(req *http.Request) (*http.Response, error)

Variables

var (
	ErrNoMorePages = errors.New("No more pages")
)

Functions

func Log

func Log(format string, args ...interface{})

* Pass log messages along to Go's "log" module.

func Quiet

func Quiet(format string, args ...interface{})

* Discard log messages silently.

func WrapTransport

func WrapTransport(transport http.RoundTripper, scope, url, username, password string) http.RoundTripper

* Given an existing http.RoundTripper such as http.DefaultTransport, build the * transport stack necessary to authenticate to the Docker registry API. This * adds in support for OAuth bearer tokens and HTTP Basic auth, and sets up * error handling this library relies on.

Types

type AuthorizationChallenge

type AuthorizationChallenge struct {
	Scheme     string
	Parameters map[string]string
}

AuthorizationChallenge carries information from a WWW-Authenticate response header.

type BasicTransport

type BasicTransport struct {
	Transport http.RoundTripper
	URL       string
	Username  string
	Password  string
}

func (*BasicTransport) RoundTrip

func (t *BasicTransport) RoundTrip(req *http.Request) (*http.Response, error)

type ErrorTransport

type ErrorTransport struct {
	Transport http.RoundTripper
}

func (*ErrorTransport) RoundTrip

func (t *ErrorTransport) RoundTrip(request *http.Request) (*http.Response, error)

type HttpStatusError

type HttpStatusError struct {
	Response *http.Response
	Body     []byte // Copied from `Response.Body` to avoid problems with unclosed bodies later. Nobody calls `err.Response.Body.Close()`, ever.
}

func (*HttpStatusError) Error

func (err *HttpStatusError) Error() string

type LogfCallback

type LogfCallback func(format string, args ...interface{})

type Registry

type Registry struct {
	URL    string
	Client *http.Client
	Logf   LogfCallback
}

func New

func New(registryUrl, scope, username, password string) (*Registry, error)

* Create a new Registry with the given URL and credentials, then Ping()s it * before returning it to verify that the registry is available. * * You can, alternately, construct a Registry manually by populating the fields. * This passes http.DefaultTransport to WrapTransport when creating the * http.Client.

func NewInsecure

func NewInsecure(registryUrl, scope, username, password string) (*Registry, error)

* Create a new Registry, as with New, using an http.Transport that disables * SSL certificate verification.

func NewSecure

func NewSecure(registryUrl, scope, username, password, cert, key string) (*Registry, error)

func (*Registry) BlobMetadata

func (registry *Registry) BlobMetadata(repository string, digest digest.Digest) (distribution.Descriptor, error)

func (*Registry) DeleteManifest

func (registry *Registry) DeleteManifest(repository string, digest digest.Digest) error

func (*Registry) DownloadBlob

func (registry *Registry) DownloadBlob(repository string, digest digest.Digest) (io.ReadCloser, error)

func (*Registry) HasBlob

func (registry *Registry) HasBlob(repository string, digest digest.Digest) (bool, error)

func (*Registry) Manifest

func (registry *Registry) Manifest(repository, reference string) (*schema1.SignedManifest, error)

func (*Registry) ManifestDigest

func (registry *Registry) ManifestDigest(repository, reference string) (digest.Digest, error)

func (*Registry) ManifestV2

func (registry *Registry) ManifestV2(repository, reference string) (*schema2.DeserializedManifest, error)

func (*Registry) Ping

func (r *Registry) Ping() error

func (*Registry) PutManifest

func (registry *Registry) PutManifest(repository, reference string, manifest distribution.Manifest) error

func (*Registry) Repositories

func (registry *Registry) Repositories() ([]string, error)

func (*Registry) Tags

func (registry *Registry) Tags(repository string) (tags []string, err error)

func (*Registry) UploadBlob

func (registry *Registry) UploadBlob(repository string, digest digest.Digest, content io.Reader) error

type TokenTransport

type TokenTransport struct {
	Transport http.RoundTripper
	Username  string
	Password  string
	Scope     string
}

func (*TokenTransport) RoundTrip

func (t *TokenTransport) RoundTrip(req *http.Request) (*http.Response, error)