volume

package
Version: v0.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2015 License: BSD-2-Clause, MIT Imports: 8 Imported by: 0

Documentation

Index

Constants

View Source
const DefaultDriverName string = "local"

DefaultDriverName is the driver name used for the driver implemented in the local package.

Variables

This section is empty.

Functions

func IsVolumeNameValid added in v0.2.1

func IsVolumeNameValid(name string) (bool, error)

IsVolumeNameValid checks a volume name in a platform specific manner.

func ParseVolumeSource added in v0.2.1

func ParseVolumeSource(spec string) (string, string)

ParseVolumeSource parses the origin sources that's mounted into the container. It returns a name and a source. It looks to see if the spec passed in is an absolute file. If it is, it assumes the spec is a source. If not, it assumes the spec is a name.

func ParseVolumesFrom added in v0.2.1

func ParseVolumesFrom(spec string) (string, string, error)

ParseVolumesFrom ensure that the supplied volumes-from is valid.

func ReadWrite

func ReadWrite(mode string) bool

ReadWrite tells you if a mode string is a valid read-write mode or not.

func SplitN added in v0.2.1

func SplitN(raw string, n int) []string

SplitN splits raw into a maximum of n parts, separated by a separator colon. A separator colon is the last `:` character in the regex `[/:\\]?[a-zA-Z]:` (note `\\` is `\` escaped). This allows to correctly split strings such as `C:\foo:D:\:rw`.

func ValidMountMode added in v0.2.1

func ValidMountMode(mode string) bool

ValidMountMode will make sure the mount mode is valid. returns if it's a valid mount mode or not.

Types

type Driver

type Driver interface {
	// Name returns the name of the volume driver.
	Name() string
	// Create makes a new volume with the given id.
	Create(name string, opts map[string]string) (Volume, error)
	// Remove deletes the volume.
	Remove(Volume) error
}

Driver is for creating and removing volumes.

type MountPoint added in v0.2.1

type MountPoint struct {
	Source      string // Container host directory
	Destination string // Inside the container
	RW          bool   // True if writable
	Name        string // Name set by user
	Driver      string // Volume driver to use
	Volume      Volume `json:"-"`

	// Note Mode is not used on Windows
	Mode string `json:"Relabel"` // Originally field was `Relabel`"
}

MountPoint is the intersection point between a volume and a container. It specifies which volume is to be used and where inside a container it should be mounted.

func ParseMountSpec added in v0.2.1

func ParseMountSpec(spec, volumeDriver string) (*MountPoint, error)

ParseMountSpec validates the configuration of mount information is valid.

func (*MountPoint) BackwardsCompatible added in v0.2.1

func (m *MountPoint) BackwardsCompatible() bool

BackwardsCompatible decides whether this mount point can be used in old versions of Docker or not. Only bind mounts and local volumes can be used in old versions of Docker.

func (*MountPoint) HasResource added in v0.2.1

func (m *MountPoint) HasResource(absolutePath string) bool

HasResource checks whether the given absolute path for a container is in this mount point. If the relative path starts with `../` then the resource is outside of this mount point, but we can't simply check for this prefix because it misses `..` which is also outside of the mount, so check both.

func (*MountPoint) Path added in v0.2.1

func (m *MountPoint) Path() string

Path returns the path of a volume in a mount point.

func (*MountPoint) Setup added in v0.2.1

func (m *MountPoint) Setup() (string, error)

Setup sets up a mount point by either mounting the volume if it is configured, or creating the source directory if supplied.

type Volume

type Volume interface {
	// Name returns the name of the volume
	Name() string
	// DriverName returns the name of the driver which owns this volume.
	DriverName() string
	// Path returns the absolute path to the volume.
	Path() string
	// Mount mounts the volume and returns the absolute path to
	// where it can be consumed.
	Mount() (string, error)
	// Unmount unmounts the volume when it is no longer in use.
	Unmount() error
}

Volume is a place to store data. It is backed by a specific driver, and can be mounted.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL