istepanov / docker-backup-to-s3

Docker container that periodically backups files to Amazon S3 using s3cmd and cron

istepanov/backup-to-s3

Docker container that periodically backups files to Amazon S3 using s3cmd sync and cron.

Usage

docker run -d [OPTIONS] istepanov/backup-to-s3

Parameters:

• -e ACCESS_KEY=<AWS_KEY>: Your AWS key.
• -e SECRET_KEY=<AWS_SECRET>: Your AWS secret.
• -e S3_PATH=s3://<BUCKET_NAME>/<PATH>/: S3 Bucket name and path. Should end with trailing slash.
• -v /path/to/backup:/data:ro: mount target local folder to container's data folder. Content of this folder will be synced with S3 bucket.

Optional parameters:

• -e PARAMS="--dry-run": parameters to pass to the sync command (full list here).
• -e DATA_PATH=/data/: container's data folder. Default is /data/. Should end with trailing slash.
• -e 'CRON_SCHEDULE=0 1 * * *': specifies when cron job starts (details). Default is 0 1 * * * (runs every day at 1:00 am).
• no-cron: run container once and exit (no cron scheduling).

Examples:

Run upload to S3 everyday at 12:00pm:

docker run -d \
    -e ACCESS_KEY=myawskey \
    -e SECRET_KEY=myawssecret \
    -e S3_PATH=s3://my-bucket/backup/ \
    -e 'CRON_SCHEDULE=0 12 * * *' \
    -v /home/user/data:/data:ro \
    istepanov/backup-to-s3

Run once then delete the container:

docker run --rm \
    -e ACCESS_KEY=myawskey \
    -e SECRET_KEY=myawssecret \
    -e S3_PATH=s3://my-bucket/backup/ \
    -v /home/user/data:/data:ro \
    istepanov/backup-to-s3 no-cron

Run once to get from S3 then delete the container:

docker run --rm \
    -e ACCESS_KEY=myawskey \
    -e SECRET_KEY=myawssecret \
    -e S3_PATH=s3://my-bucket/backup/ \
    -v /home/user/data:/data:rw \
    istepanov/backup-to-s3 get

Run once to delete from s3 then delete the container:

docker run --rm \
    -e ACCESS_KEY=myawskey \
    -e SECRET_KEY=myawssecret \
    -e S3_PATH=s3://my-bucket/backup/ \
    istepanov/backup-to-s3 delete

Security considerations: on restore, this opens up permissions on the restored files widely.

docker-backup-to-s3's Issues

Multi folders?

Hi, do you know how to mount more than one folders?

Without optional -e parameter, default /data/ is not carrying over to sync script

Outdated s3cmd

Hi istepanov,

I ran into issues with filenames with special characters in and realised that apt-get is using version 1.1 of s3cmd, the current stable version is 1.5.2.

I have forked your project here that uses the github zip file instead of apt-get to install s3cmd.
https://github.com/robbydooo/docker-backup-to-s3

Not sure if you would like these changes or not but if you do I can submit a pull request and then remove my forked copy.

Let me know.

Thanks,
Rob

Could this work with Raspberry Pi?

Hello!

I was wondering if this docker could be updated or atleast set to work with raspberry pi.

I have already tried a few arm32v7 base images but haven't gotten it to work. It's always broken in the build of the image.

Thanks!