cache

type Cache ¶

type Cache struct {
	Reader     Reader
	Decorators []Decorator
}

Cache is a local cache of image metadata.

func (c *Cache) GetImage(id image.Ref) (image.Info, error)

func (c *Cache) GetImageRepositoryMetadata(id image.Name) (image.RepositoryMetadata, error)

type Client ¶

type Client interface {
	Reader
	Writer
}

func InstrumentClient(c Client) Client

type Decorator ¶

type Decorator interface {
	// contains filtered or unexported methods
}

Decorator is for decorating an ImageRepository before it is returned.

type ImageRepository ¶

type ImageRepository struct {
	image.RepositoryMetadata
	LastError  string
	LastUpdate time.Time
}

ImageRepository holds the last good information on an image repository.

Whenever we successfully fetch a set (partial or full) of image metadata, `LastUpdate`, `Tags` and `Images` shall each be assigned a value, and `LastError` will be cleared.

If we cannot for any reason obtain the set of image metadata, `LastError` shall be assigned a value, and the other fields left alone.

It's possible to have all fields populated: this means at some point it was successfully fetched, but since then, there's been an error. It's then up to the caller to decide what to do with the value (show the images, but also indicate there's a problem, for example).

type Keyer ¶

type Keyer interface {
	Key() string
}

An interface to provide the key under which to store the data Use the full path to image for the memcache key because there might be duplicates from other registries

func NewManifestKey(image image.CanonicalRef) Keyer

func NewRepositoryKey(repo image.CanonicalName) Keyer

type Reader ¶

type Reader interface {
	// GetKey gets the value at a key, along with its refresh deadline
	GetKey(k Keyer) ([]byte, time.Time, error)
}

type StringSet ¶

type StringSet map[string]struct{}

StringSet is a set of strings.

func NewStringSet(ss []string) StringSet

func (s StringSet) Subset(t StringSet) bool

type TimestampLabelWhitelist ¶

type TimestampLabelWhitelist []string

TimestampLabelWhitelist contains a string slice of glob patterns. Any canonical image reference that matches one of the glob patterns will prefer creation timestamps from labels over the one it received from the registry.

type Warmer ¶

type Warmer struct {
	Trace    bool
	Priority chan image.Name
	Notify   func()
	// contains filtered or unexported fields
}

Warmer refreshes the information kept in the cache from remote registries.

func NewWarmer(cf registry.ClientFactory, cacheClient Client, burst int) (*Warmer, error)

func (w *Warmer) Loop(logger log.Logger, stop <-chan struct{}, wg *sync.WaitGroup, imagesToFetchFunc func() registry.ImageCreds)

type Writer ¶

type Writer interface {
	// SetKey sets the value at a key, along with its refresh deadline
	SetKey(k Keyer, deadline time.Time, v []byte) error
}