aebe850f73
This contains a proposal for a catalog API, provided access to the internal contents of a registry instance. The API endpoint is prefixed with an underscore, which is illegal in images names, to prevent collisions with repositories names. To avoid issues with large result sets, a paginated version of the API is proposed. We make an addition to the tags API to support pagination to ensure the specification is conistent. Signed-off-by: Stephen J Day <stephen.day@docker.com>
48 lines
1.2 KiB
Go
48 lines
1.2 KiB
Go
package v2
|
|
|
|
import "github.com/gorilla/mux"
|
|
|
|
// The following are definitions of the name under which all V2 routes are
|
|
// registered. These symbols can be used to look up a route based on the name.
|
|
const (
|
|
RouteNameBase = "base"
|
|
RouteNameManifest = "manifest"
|
|
RouteNameTags = "tags"
|
|
RouteNameBlob = "blob"
|
|
RouteNameBlobUpload = "blob-upload"
|
|
RouteNameBlobUploadChunk = "blob-upload-chunk"
|
|
RouteNameCatalog = "catalog"
|
|
)
|
|
|
|
var allEndpoints = []string{
|
|
RouteNameManifest,
|
|
RouteNameTags,
|
|
RouteNameBlob,
|
|
RouteNameBlobUpload,
|
|
RouteNameBlobUploadChunk,
|
|
}
|
|
|
|
// Router builds a gorilla router with named routes for the various API
|
|
// methods. This can be used directly by both server implementations and
|
|
// clients.
|
|
func Router() *mux.Router {
|
|
return RouterWithPrefix("")
|
|
}
|
|
|
|
// RouterWithPrefix builds a gorilla router with a configured prefix
|
|
// on all routes.
|
|
func RouterWithPrefix(prefix string) *mux.Router {
|
|
rootRouter := mux.NewRouter()
|
|
router := rootRouter
|
|
if prefix != "" {
|
|
router = router.PathPrefix(prefix).Subrouter()
|
|
}
|
|
|
|
router.StrictSlash(true)
|
|
|
|
for _, descriptor := range routeDescriptors {
|
|
router.Path(descriptor.Path).Name(descriptor.Name)
|
|
}
|
|
|
|
return rootRouter
|
|
}
|