forked from TrueCloudLab/distribution
5789ca7629
To bring the implementation inline with the specification, the names and structure of the API routes have been updated. The overloaded term "image" has been replaced with the term "manifest", which may also be known as "image manifest". The desire for the layer storage to be more of a general blob storage is reflected in moving from "layer" api prefixes to "blob". The "tarsum" path parameter has been replaced by a more general "digest" parameter and is no longer required to start uploads. Another set of changes will come along to support this change at the storage service layer.
60 lines
2.2 KiB
Go
60 lines
2.2 KiB
Go
package registry
|
|
|
|
import (
|
|
"github.com/docker/docker-registry/common"
|
|
"github.com/gorilla/mux"
|
|
)
|
|
|
|
const (
|
|
routeNameImageManifest = "image-manifest"
|
|
routeNameTags = "tags"
|
|
routeNameBlob = "blob"
|
|
routeNameBlobUpload = "blob-upload"
|
|
routeNameBlobUploadResume = "blob-upload-resume"
|
|
)
|
|
|
|
var allEndpoints = []string{
|
|
routeNameImageManifest,
|
|
routeNameTags,
|
|
routeNameBlob,
|
|
routeNameBlobUpload,
|
|
routeNameBlobUploadResume,
|
|
}
|
|
|
|
// v2APIRouter builds a gorilla router with named routes for the various API
|
|
// methods. We may export this for use by the client.
|
|
func v2APIRouter() *mux.Router {
|
|
router := mux.NewRouter().
|
|
StrictSlash(true)
|
|
|
|
// GET /v2/<name>/manifest/<tag> Image Manifest Fetch the image manifest identified by name and tag.
|
|
// PUT /v2/<name>/manifest/<tag> Image Manifest Upload the image manifest identified by name and tag.
|
|
// DELETE /v2/<name>/manifest/<tag> Image Manifest Delete the image identified by name and tag.
|
|
router.
|
|
Path("/v2/{name:" + common.RepositoryNameRegexp.String() + "}/manifest/{tag:" + common.TagNameRegexp.String() + "}").
|
|
Name(routeNameImageManifest)
|
|
|
|
// GET /v2/<name>/tags/list Tags Fetch the tags under the repository identified by name.
|
|
router.
|
|
Path("/v2/{name:" + common.RepositoryNameRegexp.String() + "}/tags/list").
|
|
Name(routeNameTags)
|
|
|
|
// GET /v2/<name>/blob/<digest> Layer Fetch the blob identified by digest.
|
|
router.
|
|
Path("/v2/{name:" + common.RepositoryNameRegexp.String() + "}/blob/{digest:[a-zA-Z0-9-_+.]+:[a-zA-Z0-9-_+.=]+}").
|
|
Name(routeNameBlob)
|
|
|
|
// POST /v2/<name>/blob/upload/ Layer Upload Initiate an upload of the layer identified by tarsum.
|
|
router.
|
|
Path("/v2/{name:" + common.RepositoryNameRegexp.String() + "}/blob/upload/").
|
|
Name(routeNameBlobUpload)
|
|
|
|
// GET /v2/<name>/blob/upload/<uuid> Layer Upload Get the status of the upload identified by tarsum and uuid.
|
|
// PUT /v2/<name>/blob/upload/<uuid> Layer Upload Upload all or a chunk of the upload identified by tarsum and uuid.
|
|
// DELETE /v2/<name>/blob/upload/<uuid> Layer Upload Cancel the upload identified by layer and uuid
|
|
router.
|
|
Path("/v2/{name:" + common.RepositoryNameRegexp.String() + "}/blob/upload/{uuid}").
|
|
Name(routeNameBlobUploadResume)
|
|
|
|
return router
|
|
}
|