docker: github.com/docker/docker/volume Index | Files | Directories

package volume

import "github.com/docker/docker/volume"

Index

Package Files

volume.go

Constants

const (
    LocalScope  = "local"
    GlobalScope = "global"
)

Scopes define if a volume has is cluster-wide (global) or local only. Scopes are returned by the volume driver when it is queried for capabilities and then set on a volume

const DefaultDriverName = "local"

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

type Capability Uses

type Capability struct {
    // Scope is the scope of the driver, `global` or `local`
    // A `global` scope indicates that the driver manages volumes across the cluster
    // A `local` scope indicates that the driver only manages volumes resources local to the host
    // Scope is declared by the driver
    Scope string
}

Capability defines a set of capabilities that a driver is able to handle.

type DetailedVolume Uses

type DetailedVolume interface {
    Labels() map[string]string
    Options() map[string]string
    Scope() string
    Volume
}

DetailedVolume wraps a Volume with user-defined labels, options, and cluster scope (e.g., `local` or `global`)

type Driver Uses

type Driver interface {
    // Name returns the name of the volume driver.
    Name() string
    // Create makes a new volume with the given name.
    Create(name string, opts map[string]string) (Volume, error)
    // Remove deletes the volume.
    Remove(vol Volume) (err error)
    // List lists all the volumes the driver has
    List() ([]Volume, error)
    // Get retrieves the volume with the requested name
    Get(name string) (Volume, error)
    // Scope returns the scope of the driver (e.g. `global` or `local`).
    // Scope determines how the driver is handled at a cluster level
    Scope() string
}

Driver is for creating and removing volumes.

type Volume Uses

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(id string) (string, error)
    // Unmount unmounts the volume when it is no longer in use.
    Unmount(id string) error
    // CreatedAt returns Volume Creation time
    CreatedAt() (time.Time, error)
    // Status returns low-level status information about a volume
    Status() map[string]interface{}
}

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

Directories

PathSynopsis
drivers
localPackage local provides the default implementation for volumes.
mounts
service
service/opts
testutils

Package volume imports 1 packages (graph) and is imported by 3558 packages. Updated 2021-01-21. Refresh now. Tools for package owners.