sab

Crates.iosab
lib.rssab
version0.1.1
sourcesrc
created_at2023-01-22 05:31:57.525811
updated_at2023-01-23 03:28:10.117682
descriptionA simple S3 backup tool
homepagehttps://github.com/syhpoon/sab
repositoryhttps://github.com/syhpoon/sab
max_upload_size
id764773
size82,143
core (github:gecode:core)

documentation

README

sab

sab is a simple backup tool that uses AWS S3:

  • simple interface to upload/download backup archives
  • multiple profiles
  • encryption and compression
  • STANDARD and DEEP_ARCHIVE (Glacier) storage classes
  • ability to resume upload from the last uploaded chunk in case of a transient failure

Installation

cargo install sab

Usage

Create a profile

$ sab init
S3 Access Key: MY-ACCESS-KEY
S3 Secret Key: MY-SECRET-KEY
S3 Region [us-east-1]:
Bucket Name: my-backups
Bucket Prefix for Backups []: laptop/
Enable Encryption? [true]:

Upload a file

$ sab upload backup.tar.bz2 -s 50MB
[2023-01-22T05:09:24Z INFO  sab::cli::cmd_upload] starting upload laptop/backup.tar.bz2
[2023-01-22T05:09:24Z INFO  sab::cli::cmd_upload] creating new configuration
[2023-01-22T05:09:51Z INFO  sab::cli::cmd_upload] uploaded chunk=1	orig-size=50000000	processed-size=50000040	progress=30.16%
[2023-01-22T05:10:17Z INFO  sab::cli::cmd_upload] uploaded chunk=2	orig-size=50000000	processed-size=50000040	progress=60.31%
[2023-01-22T05:10:45Z INFO  sab::cli::cmd_upload] uploaded chunk=3	orig-size=50000000	processed-size=50000040	progress=90.47%
[2023-01-22T05:10:53Z INFO  sab::cli::cmd_upload] uploaded chunk=4	orig-size=15805568	processed-size=15805608	progress=100.00%
[2023-01-22T05:10:53Z INFO  sab::cli::cmd_upload] upload completed

List backups

$  sab list
* laptop/backup.tar.bz2

Download backup

$ sab download backup.tar.bz2
[2023-01-22T05:13:20Z INFO  sab::cli::cmd_download] starting download
[2023-01-22T05:13:32Z INFO  sab::cli::cmd_download] downloaded chunk=1	size=50000000	progress=30.16%
[2023-01-22T05:13:45Z INFO  sab::cli::cmd_download] downloaded chunk=2	size=50000000	progress=60.31%
[2023-01-22T05:13:58Z INFO  sab::cli::cmd_download] downloaded chunk=3	size=50000000	progress=90.47%
[2023-01-22T05:14:02Z INFO  sab::cli::cmd_download] downloaded chunk=4	size=15805568	progress=100.00%
[2023-01-22T05:14:02Z INFO  sab::cli::cmd_download] backup successfully downloaded

Note, that if DEEP_ARCHIVE storage class was used when uploading a backup, the file needs to be restored in AWS before it can be downloaded.

Commit count: 3

cargo fmt