forked from TrueCloudLab/distribution
9ebf151ac2
Add an interface alongside TagStore that provides API to retreive digests of all manifests that a tag historically pointed to. It also includes currently linked tag. Signed-off-by: Manish Tomar <manish.tomar@docker.com>
36 lines
1.3 KiB
Go
36 lines
1.3 KiB
Go
package distribution
|
|
|
|
import (
|
|
"context"
|
|
|
|
digest "github.com/opencontainers/go-digest"
|
|
)
|
|
|
|
// TagService provides access to information about tagged objects.
|
|
type TagService interface {
|
|
// Get retrieves the descriptor identified by the tag. Some
|
|
// implementations may differentiate between "trusted" tags and
|
|
// "untrusted" tags. If a tag is "untrusted", the mapping will be returned
|
|
// as an ErrTagUntrusted error, with the target descriptor.
|
|
Get(ctx context.Context, tag string) (Descriptor, error)
|
|
|
|
// Tag associates the tag with the provided descriptor, updating the
|
|
// current association, if needed.
|
|
Tag(ctx context.Context, tag string, desc Descriptor) error
|
|
|
|
// Untag removes the given tag association
|
|
Untag(ctx context.Context, tag string) error
|
|
|
|
// All returns the set of tags managed by this tag service
|
|
All(ctx context.Context) ([]string, error)
|
|
|
|
// Lookup returns the set of tags referencing the given digest.
|
|
Lookup(ctx context.Context, digest Descriptor) ([]string, error)
|
|
}
|
|
|
|
// TagIndexes proves method to retreive all the digests that a tag historically pointed to
|
|
type TagIndexes interface {
|
|
// Indexes returns set of digests that this tag historically pointed to. This also includes
|
|
// currently linked digest. There is no ordering guaranteed
|
|
Indexes(ctx context.Context, tag string) ([]digest.Digest, error)
|
|
}
|