37b83412b1
It is difficult to gather information about docker volumes command
without a parent man page.
This man page attempts to explain docker volumes and then references
the command man pages.
Signed-off-by: Dan Walsh <dwalsh@redhat.com>
Upstream-commit: b5c9713ee0
Component: cli
1.8 KiB
% DOCKER(1) Docker User Manuals % Docker Community % Feb 2016
NAME
docker-volume - Create a new volume
SYNOPSIS
docker volume [OPTIONS] COMMAND [--help]
DESCRIPTION
docker volume command manages content volumes for docker containers.
Data volumes
A data volume is a specially-designated directory within one or more containers.
Data volumes provide several useful features for persistent or shared data:
Volumes are initialized when a container is created. If the container's base image contains data at the specified mount point, that existing data is copied into the new volume upon volume initialization. (Note that this does not apply when mounting a host directory.)
Data volumes can be shared and reused among containers.
Changes to a data volume are made directly.
Changes to a data volume will not be included when you update an image.
Data volumes persist even if the container itself is deleted.
Data volumes are designed to persist data, independent of the container's life cycle. Docker therefore never automatically deletes volumes when you remove a container, nor will it "garbage collect" volumes that are no longer referenced by a container.
OPTIONS
--help Print usage statement
COMMANDS
create Create a volume See docker-volume-create(1) for full documentation on the create command.
inspect Return low-level information on a volume See docker-volume-inspect(1) for full documentation on the inspect command.
ls List volumes See docker-volume-ls(1) for full documentation on the ls command.
rm Remove a volume See docker-volume-rm(1) for full documentation on the rm command.
HISTORY
Feb 2016, created by Dan Walsh dwalsh@redhat.com