registry

Documentation

Index

• func Log(format string, args ...interface{})
• func Quiet(format string, args ...interface{})
• 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 LogfCallback
• type Registry
  • func New(auth types.AuthConfig, debug bool) (*Registry, error)
  • func NewInsecure(auth types.AuthConfig, debug bool) (*Registry, error)
  • func (r *Registry) Catalog(u string) ([]string, error)
  • func (r *Registry) Delete(repository, ref string) error
  • func (r *Registry) Digest(repository, ref string) (string, error)
  • func (r *Registry) DownloadLayer(repository string, digest digest.Digest) (io.ReadCloser, error)
  • func (r *Registry) HasLayer(repository string, digest digest.Digest) (bool, error)
  • func (r *Registry) Manifest(repository, ref string) (distribution.Manifest, error)
  • func (r *Registry) ManifestList(repository, ref string) (manifestlist.ManifestList, error)
  • func (r *Registry) ManifestV1(repository, ref string) (schema1.SignedManifest, error)
  • func (r *Registry) ManifestV2(repository, ref string) (schema2.Manifest, error)
  • func (r *Registry) Ping() error
  • func (r *Registry) Search(user string) ([]SearchResult, error)
  • func (r *Registry) Tags(repository string) ([]string, error)
  • func (r *Registry) Token(url string) (string, error)
  • func (r *Registry) UploadLayer(repository string, digest reference.Reference, content io.Reader) error
• type SearchResult
• type TokenTransport
  • func (t *TokenTransport) RoundTrip(req *http.Request) (*http.Response, error)

Functions

func Log

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

Log passes log messages to the logging package.

func Quiet

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

Quiet discards logs silently.

Types

type BasicTransport

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

BasicTransport defines the data structure for authentication via basic auth.

func (*BasicTransport) RoundTrip

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

RoundTrip defines the round tripper for basic auth transport.

type ErrorTransport

type ErrorTransport struct {
	Transport http.RoundTripper
}

ErrorTransport defines the data structure for returning errors from the round tripper.

func (*ErrorTransport) RoundTrip

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

RoundTrip defines the round tripper for the error transport.

type LogfCallback

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

LogfCallback is the callback for formatting logs.

type Registry

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

Registry defines the client for retrieving information from the registry API.

func New

func New(auth types.AuthConfig, debug bool) (*Registry, error)

New creates a new Registry struct with the given URL and credentials.

func NewInsecure

func NewInsecure(auth types.AuthConfig, debug bool) (*Registry, error)

NewInsecure creates a new Registry struct with the given URL and credentials, using a http.Transport that will not verify an SSL certificate.

func (*Registry) Catalog

func (r *Registry) Catalog(u string) ([]string, error)

Catalog returns the repositories in a registry.

func (*Registry) Delete

func (r *Registry) Delete(repository, ref string) error

Delete removes a repository reference from the registry. https://docs.docker.com/registry/spec/api/#deleting-an-image

func (*Registry) Digest

func (r *Registry) Digest(repository, ref string) (string, error)

Digest returns the digest for a repository and reference.

func (*Registry) DownloadLayer

func (r *Registry) DownloadLayer(repository string, digest digest.Digest) (io.ReadCloser, error)

DownloadLayer downloads a specific layer by digest for a repository.

func (*Registry) HasLayer

func (r *Registry) HasLayer(repository string, digest digest.Digest) (bool, error)

HasLayer returns if the registry contains the specific digest for a repository.

func (*Registry) Manifest

func (r *Registry) Manifest(repository, ref string) (distribution.Manifest, error)

Manifest returns the manifest for a specific repository:tag.

func (*Registry) ManifestList

func (r *Registry) ManifestList(repository, ref string) (manifestlist.ManifestList, error)

ManifestList gets the registry v2 manifest list.

func (*Registry) ManifestV1

func (r *Registry) ManifestV1(repository, ref string) (schema1.SignedManifest, error)

ManifestV1 gets the registry v1 manifest.

func (*Registry) ManifestV2

func (r *Registry) ManifestV2(repository, ref string) (schema2.Manifest, error)

ManifestV2 gets the registry v2 manifest.

func (*Registry) Ping

func (r *Registry) Ping() error

Ping tries to contact a registry URL to make sure it is up and accessible.

func (*Registry) Search

func (r *Registry) Search(user string) ([]SearchResult, error)

Search returns the repositories in a registry.

func (*Registry) Tags

func (r *Registry) Tags(repository string) ([]string, error)

Tags returns the tags for a specific repository.

func (*Registry) Token

func (r *Registry) Token(url string) (string, error)

Token returns the required token for the specific resource url.

func (*Registry) UploadLayer

func (r *Registry) UploadLayer(repository string, digest reference.Reference, content io.Reader) error

UploadLayer uploads a specific layer by digest for a repository.

type SearchResult

type SearchResult struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	StarCount   int    `json:"star_count"`
	IsTrusted   bool   `json:"is_trusted"`
	IsAutomated bool   `json:"is_automated"`
	IsOfficial  bool   `json:"is_official"`
}

type TokenTransport

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

TokenTransport defines the data structure for authentication via tokens.

func (*TokenTransport) RoundTrip

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

RoundTrip defines the round tripper for token transport.