Merge pull request #10757 from thaJeztah/docs-enhance-volume-lifecycle-description

Docs: Improve description on volume removal
This commit is contained in:
James Turnbull 2015-02-14 11:08:28 -05:00
commit 9456a25414
1 changed files with 14 additions and 1 deletions

View File

@ -28,7 +28,12 @@ persistent or shared data:
- Data volumes can be shared and reused between containers
- Changes to a data volume are made directly
- Changes to a data volume will not be included when you update an image
- Volumes persist until no containers use them
- 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 will therefore *never* automatically delete volumes when you remove
a container, nor will it "garbage collect" volumes that are no longer referenced
by a container.
### Adding a data volume
@ -141,6 +146,14 @@ be deleted. To delete the volume from disk, you must explicitly call
`docker rm -v` against the last container with a reference to the volume. This
allows you to upgrade, or effectively migrate data volumes between containers.
> **Note:** Docker will not warn you when removing a container *without*
> providing the `-v` option to delete its volumes. If you remove containers
> without using the `-v` option, you may end up with "dangling" volumes;
> volumes that are no longer referenced by a container.
> Dangling volumes are difficult to get rid of and can take up a large amount
> of disk space. We're working on improving volume management and you can check
> progress on this in [pull request #8484](https://github.com/docker/docker/pull/8484)
## Backup, restore, or migrate data volumes
Another useful function we can perform with volumes is use them for