registry

README

adapted from https://github.com/google/go-containerregistry/tree/master/pkg/registry

Documentation

Overview

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.

Index

• func New(config *Config, opts ...Option) http.Handler
• type CIDResolver
  • func NewDNSLinkResolver(client *ipfs.Client, domain string) (CIDResolver, error)
  • func NewFileResolver(uri string) (CIDResolver, error)
  • func NewIPFSResolver(client *ipfs.Client, root string) (CIDResolver, error)
  • func NewResolver(client *ipfs.Client, list []string) CIDResolver
• type Config
• type Option
  • func Logger(l *log.Logger) Option

Functions

func New

func New(config *Config, opts ...Option) http.Handler

New returns a handler which implements the docker registry protocol. It should be registered at the site root.

Types

type CIDResolver

type CIDResolver interface {
	Resolve(repo string, reference string) []string
}

CIDResolver is the interface that maps container image repo[:reference] to content ID.

func NewDNSLinkResolver

func NewDNSLinkResolver(client *ipfs.Client, domain string) (CIDResolver, error)

func NewFileResolver

func NewFileResolver(uri string) (CIDResolver, error)

func NewIPFSResolver

func NewIPFSResolver(client *ipfs.Client, root string) (CIDResolver, error)

func NewResolver

func NewResolver(client *ipfs.Client, list []string) CIDResolver

type Config

type Config struct {
	IPFSHost     string
	IPFSGateway  string
	CIDResolvers []string
	CIDStorePath string
}

Config is the config for the registry

type Option

type Option func(r *registry)

Option describes the available options for creating the registry.

func Logger

func Logger(l *log.Logger) Option

Logger overrides the logger used to record requests to the registry.