summaryrefslogtreecommitdiffstats
path: root/pkg/registry/registry.go
diff options
context:
space:
mode:
Diffstat (limited to 'pkg/registry/registry.go')
-rw-r--r--pkg/registry/registry.go117
1 files changed, 117 insertions, 0 deletions
diff --git a/pkg/registry/registry.go b/pkg/registry/registry.go
new file mode 100644
index 0000000..303e6e7
--- /dev/null
+++ b/pkg/registry/registry.go
@@ -0,0 +1,117 @@
+// Copyright 2018 Google LLC All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Package registry implements a docker V2 registry and the OCI distribution specification.
+//
+// It is designed to be used anywhere a low dependency container registry is needed, with an
+// initial focus on tests.
+//
+// Its goal is to be standards compliant and its strictness will increase over time.
+//
+// This is currently a low flightmiles system. It's likely quite safe to use in tests; If you're using it
+// in production, please let us know how and send us CL's for integration tests.
+package registry
+
+import (
+ "log"
+ "net/http"
+ "os"
+)
+
+type registry struct {
+ log *log.Logger
+ blobs blobs
+ manifests manifests
+ referrersEnabled bool
+}
+
+// https://docs.docker.com/registry/spec/api/#api-version-check
+// https://github.com/opencontainers/distribution-spec/blob/master/spec.md#api-version-check
+func (r *registry) v2(resp http.ResponseWriter, req *http.Request) *regError {
+ if isBlob(req) {
+ return r.blobs.handle(resp, req)
+ }
+ if isManifest(req) {
+ return r.manifests.handle(resp, req)
+ }
+ if isTags(req) {
+ return r.manifests.handleTags(resp, req)
+ }
+ if isCatalog(req) {
+ return r.manifests.handleCatalog(resp, req)
+ }
+ if r.referrersEnabled && isReferrers(req) {
+ return r.manifests.handleReferrers(resp, req)
+ }
+ resp.Header().Set("Docker-Distribution-API-Version", "registry/2.0")
+ if req.URL.Path != "/v2/" && req.URL.Path != "/v2" {
+ return &regError{
+ Status: http.StatusNotFound,
+ Code: "METHOD_UNKNOWN",
+ Message: "We don't understand your method + url",
+ }
+ }
+ resp.WriteHeader(200)
+ return nil
+}
+
+func (r *registry) root(resp http.ResponseWriter, req *http.Request) {
+ if rerr := r.v2(resp, req); rerr != nil {
+ r.log.Printf("%s %s %d %s %s", req.Method, req.URL, rerr.Status, rerr.Code, rerr.Message)
+ rerr.Write(resp)
+ return
+ }
+ r.log.Printf("%s %s", req.Method, req.URL)
+}
+
+// New returns a handler which implements the docker registry protocol.
+// It should be registered at the site root.
+func New(opts ...Option) http.Handler {
+ r := &registry{
+ log: log.New(os.Stderr, "", log.LstdFlags),
+ blobs: blobs{
+ blobHandler: &memHandler{m: map[string][]byte{}},
+ uploads: map[string][]byte{},
+ log: log.New(os.Stderr, "", log.LstdFlags),
+ },
+ manifests: manifests{
+ manifests: map[string]map[string]manifest{},
+ log: log.New(os.Stderr, "", log.LstdFlags),
+ },
+ }
+ for _, o := range opts {
+ o(r)
+ }
+ return http.HandlerFunc(r.root)
+}
+
+// Option describes the available options
+// for creating the registry.
+type Option func(r *registry)
+
+// Logger overrides the logger used to record requests to the registry.
+func Logger(l *log.Logger) Option {
+ return func(r *registry) {
+ r.log = l
+ r.manifests.log = l
+ r.blobs.log = l
+ }
+}
+
+// WithReferrersSupport enables the referrers API endpoint (OCI 1.1+)
+func WithReferrersSupport(enabled bool) Option {
+ return func(r *registry) {
+ r.referrersEnabled = enabled
+ }
+}