2 releases

0.1.1 Oct 23, 2020
0.1.0 Oct 23, 2020

#1015 in Unix APIs

MIT license

58KB
1K SLoC

dockyard

license dockerhub crates.io docs

Dockyard: Back up and restore Docker Resources

Dockyard can back up Docker volumes and containers (automatically backing up mounted volumes).

Install

git clone git@github.com:aig787/dockyard.git
cargo install

Usage

# Back up volume to directory
dockyard backup volume <volume> <backup-directory>

# Back up volume to volume
dockyard backup volume <volume> <backup-volume> --output-type volume

# Back up container and all volumes
dockyard backup container <container> <backup-directory>

# Back up container and specific volumes
dockyard backup container <container> <backup-directory> --volumes <volume1> <volume2>

# Restore volume
dockyard restore volume <relative_archive_path> <backup-directory> <volume>

# Restore container
dockyard restore container <relative-backup-file> <backup-directory> <container>

Example Back Up and Restore

 dockyard backup container nginx /tmp
2020-10-22 16:09:02,555 INFO  [dockyard::backup] Backing up directory /host_mnt/Users/aig787/test to dockyard/binds/:volume1 on /tmp
2020-10-22 16:09:05,600 INFO  [dockyard::backup] Successfully backed up to dockyard/binds/:volume1/2020-10-22T23:09:02.555772+00:00.tgz
2020-10-22 16:09:05,600 INFO  [dockyard::backup] Backing up volume hello to dockyard/volumes/hello
2020-10-22 16:09:10,960 INFO  [dockyard::backup] Successfully backed up to dockyard/volumes/hello/2020-10-22T23:09:05.600782+00:00.tgz
2020-10-22 16:09:10,960 INFO  [dockyard::backup] Writing container backup file dockyard/containers/nginx/2020-10-22T23:09:10.960344+00:00.json
2020-10-22 16:09:16,425 INFO  [dockyard] Successfully backed up container nginx to dockyard/containers/nginx/2020-10-22T23:09:10.960344+00:00.json


 dockyard restore container dockyard/containers/nginx/2020-10-22T23:09:10.960344+00:00.json /tmp nginx-restore
2020-10-22 16:10:37,371 INFO  [dockyard::restore] Restoring container nginx-restore from dockyard/containers/nginx/2020-10-22T23:09:10.960344+00:00.json
2020-10-22 16:10:40,356 INFO  [dockyard::restore] Restoring directory /host_mnt/Users/aig787/test from dockyard/binds/:volume1/2020-10-22T23:09:02.555772+00:00.tgz
2020-10-22 16:10:46,127 INFO  [dockyard::restore] Successfully restored mount /host_mnt/Users/aig787/test
2020-10-22 16:10:46,127 INFO  [dockyard::restore] Restoring volume hello from dockyard/volumes/hello/2020-10-22T23:09:05.600782+00:00.tgz
2020-10-22 16:10:51,412 INFO  [dockyard::restore] Successfully restored mount hello
2020-10-22 16:10:51,485 INFO  [dockyard::restore] Successfully restored container nginx-restore

Running Tests

cargo test

License: MIT

Dependencies

~30–44MB
~791K SLoC