Documentation
¶
Index ¶
- Constants
- Variables
- func WrapTransport(transport http.RoundTripper, url, username, password string) http.RoundTripper
- type AuthorizationChallenge
- type BasicTransport
- type ErrorTransport
- type HttpStatusError
- type ManifestInfo
- type Registry
- func (registry *Registry) DownloadLayer(ctx context.Context, repository string, digest digest.Digest) (io.ReadCloser, int64, error)
- func (registry *Registry) HasLayer(repository string, digest digest.Digest) (bool, error)
- func (registry *Registry) LayerMetadata(repository string, digest digest.Digest) (distribution.Descriptor, error)
- func (r *Registry) Manifest(ctx context.Context, repository, reference string) (*ManifestInfo, error)
- func (r *Registry) ManifestRequest(ctx context.Context, repository, reference string, schema int) (string, []byte, error)
- func (r *Registry) ManifestV2(ctx context.Context, repository, reference string) (*manifestV2.DeserializedManifest, string, error)
- func (r *Registry) Ping() (uint, error)
- func (registry *Registry) Repositories() ([]string, error)
- func (registry *Registry) Search(term string, limit int) ([]string, error)
- func (registry *Registry) Tags(repository string) ([]string, error)
- func (registry *Registry) UploadLayer(repository string, digest digest.Digest, content io.Reader) error
- type TokenTransport
Constants ¶
View Source
const ( ErrorNone uint = iota ErrorCertificate ErrorAuthentication ErrorUrl ErrorUnknown )
Variables ¶
View Source
var (
ErrNoMorePages = errors.New("No more pages")
)
Functions ¶
func WrapTransport ¶
func WrapTransport(transport http.RoundTripper, 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 ¶
AuthorizationChallenge carries information from a WWW-Authenticate response header.
type BasicTransport ¶
type BasicTransport struct {
Transport http.RoundTripper
URL string
Username string
Password string
}
type ErrorTransport ¶
type ErrorTransport struct {
Transport http.RoundTripper
}
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 ManifestInfo ¶
type ManifestInfo struct {
SignedManifest *manifestV1.SignedManifest
Digest string
RunAsRoot bool
Author string
Envs []string
Cmds []string
Labels map[string]string
}
type Registry ¶
type Registry struct {
URL string
Client *httptrace.TraceClient
}
func NewInsecure ¶
func NewInsecure(registryUrl, username, password, proxy string, trace httptrace.HTTPTrace) (*Registry, uint, error)
* Create a new Registry, as with New, using an http.Transport that disables * SSL certificate verification.
func NewSecure ¶
func NewSecure(registryUrl, username, password, proxy string, trace httptrace.HTTPTrace) (*Registry, uint, 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 (*Registry) DownloadLayer ¶
func (*Registry) LayerMetadata ¶
func (registry *Registry) LayerMetadata(repository string, digest digest.Digest) (distribution.Descriptor, error)
func (*Registry) ManifestRequest ¶
func (*Registry) ManifestV2 ¶
func (r *Registry) ManifestV2(ctx context.Context, repository, reference string) (*manifestV2.DeserializedManifest, string, error)
func (*Registry) Repositories ¶
type TokenTransport ¶
type TokenTransport struct {
Transport http.RoundTripper
Username string
Password string
}
Source Files
Click to show internal directories.
Click to hide internal directories.