filesystem

README

Docker-Registry Filesystem Storage Driver

An implementation of the storagedriver.StorageDriver interface which uses the local filesystem.

Parameters

rootdirectory: (optional) The root directory tree in which all registry files will be stored. Defaults to /tmp/registry/storage.

Documentation

Index

• type Driver
  • func FromParameters(parameters map[string]interface{}) *Driver
  • func New(rootDirectory string) *Driver
  • func (d *Driver) Delete(subPath string) error
  • func (d *Driver) GetContent(path string) ([]byte, error)
  • func (d *Driver) List(subPath string) ([]string, error)
  • func (d *Driver) Move(sourcePath string, destPath string) error
  • func (d *Driver) PutContent(subPath string, contents []byte) error
  • func (d *Driver) ReadStream(path string, offset int64) (io.ReadCloser, error)
  • func (d *Driver) Stat(subPath string) (storagedriver.FileInfo, error)
  • func (d *Driver) URLFor(path string, options map[string]interface{}) (string, error)
  • func (d *Driver) WriteStream(subPath string, offset int64, reader io.Reader) (nn int64, err error)

Types

type Driver

type Driver struct {
	// contains filtered or unexported fields
}

Driver is a storagedriver.StorageDriver implementation backed by a local filesystem. All provided paths will be subpaths of the RootDirectory

func FromParameters

func FromParameters(parameters map[string]interface{}) *Driver

FromParameters constructs a new Driver with a given parameters map Optional Parameters: - rootdirectory

func New

func New(rootDirectory string) *Driver

New constructs a new Driver with a given rootDirectory

func (*Driver) Delete

func (d *Driver) Delete(subPath string) error

Delete recursively deletes all objects stored at "path" and its subpaths.

func (*Driver) GetContent

func (d *Driver) GetContent(path string) ([]byte, error)

GetContent retrieves the content stored at "path" as a []byte.

func (*Driver) List

func (d *Driver) List(subPath string) ([]string, error)

List returns a list of the objects that are direct descendants of the given path.

func (*Driver) Move

func (d *Driver) Move(sourcePath string, destPath string) error

Move moves an object stored at sourcePath to destPath, removing the original object.

func (*Driver) PutContent

func (d *Driver) PutContent(subPath string, contents []byte) error

PutContent stores the []byte content at a location designated by "path".

func (*Driver) ReadStream

func (d *Driver) ReadStream(path string, offset int64) (io.ReadCloser, error)

ReadStream retrieves an io.ReadCloser for the content stored at "path" with a given byte offset.

func (*Driver) Stat

func (d *Driver) Stat(subPath string) (storagedriver.FileInfo, error)

Stat retrieves the FileInfo for the given path, including the current size in bytes and the creation time.

func (*Driver) URLFor

func (d *Driver) URLFor(path string, options map[string]interface{}) (string, error)

URLFor returns a URL which may be used to retrieve the content stored at the given path. May return an UnsupportedMethodErr in certain StorageDriver implementations.

func (*Driver) WriteStream

func (d *Driver) WriteStream(subPath string, offset int64, reader io.Reader) (nn int64, err error)

WriteStream stores the contents of the provided io.Reader at a location designated by the given path.