reorganize README

pull/17/head
Jarek Lipski 2019-04-13 16:38:21 +02:00
rodzic 566915065f
commit f5e0a593e3
1 zmienionych plików z 26 dodań i 22 usunięć

Wyświetl plik

@ -6,22 +6,10 @@ An utility to backup and restore [docker volumes](https://docs.docker.com/engine
## Backup ## Backup
Syntax: ### To standard output
docker run -v [volume-name]:/volume -v [output-dir]:/backup --rm loomchild/volume-backup backup [archive-name]
For example:
docker run -v some_volume:/volume -v /tmp:/backup --rm loomchild/volume-backup backup some_archive
will archive volume named `some_volume` to `/tmp/some_archive.tar.bz2` archive file.
### Backup to standard output
This avoids mounting a second backup volume and allows to redirect it to a file, network, etc. This avoids mounting a second backup volume and allows to redirect it to a file, network, etc.
**WARNING**: This method should not be used with a Docker for Windows installation; no usable backup will be generated.
Syntax: Syntax:
docker run -v [volume-name]:/volume --rm loomchild/volume-backup backup - > [archive-name] docker run -v [volume-name]:/volume --rm loomchild/volume-backup backup - > [archive-name]
@ -32,27 +20,29 @@ For example:
will archive volume named `some_volume` to `some_archive.tar.bz2` archive file. will archive volume named `some_volume` to `some_archive.tar.bz2` archive file.
## Restore **WARNING**: This method should not be used with a Docker for Windows installation; no usable backup will be generated.
**Note**: This operation will delete all contents of the volume ### To a file
Syntax: Syntax:
docker run -v [volume-name]:/volume -v [output-dir]:/backup --rm loomchild/volume-backup restore [archive-name] docker run -v [volume-name]:/volume -v [output-dir]:/backup --rm loomchild/volume-backup backup [archive-name]
For example: For example:
docker run -v some_volume:/volume -v /tmp:/backup --rm loomchild/volume-backup restore some_archive docker run -v some_volume:/volume -v /tmp:/backup --rm loomchild/volume-backup backup some_archive
will clean and restore volume named `some_volume` from `/tmp/some_archive.tar.bz2` archive file. will archive volume named `some_volume` to `/tmp/some_archive.tar.bz2` archive file.
## Restore
**WARNING**: This operation will delete all contents of the volume
### Restore from standard input ### Restore from standard input
This avoids mounting a second backup volume. This avoids mounting a second backup volume.
**Note**: Don't forget the `-i` switch for interactive operation. *NOTE*: Don't forget the `-i` switch for interactive operation.
**WARNING**: This method should not be used with a Docker for Windows installation; no usable backup will be generated.
Syntax: Syntax:
@ -64,7 +54,21 @@ For example:
will clean and restore volume named `some_volume` from `some_archive.tar.bz2` archive file. will clean and restore volume named `some_volume` from `some_archive.tar.bz2` archive file.
### Miscellaneous **WARNING**: This method should not be used with a Docker for Windows installation; no usable backup will be generated.
### From a file
Syntax:
docker run -v [volume-name]:/volume -v [output-dir]:/backup --rm loomchild/volume-backup restore [archive-name]
For example:
docker run -v some_volume:/volume -v /tmp:/backup --rm loomchild/volume-backup restore some_archive
will clean and restore volume named `some_volume` from `/tmp/some_archive.tar.bz2` archive file.
## Miscellaneous
1. Upgrade / update volume-backup 1. Upgrade / update volume-backup
``` ```