Skip to content
This repository has been archived by the owner on Mar 17, 2023. It is now read-only.

Latest commit

 

History

History
93 lines (69 loc) · 3.85 KB

README.md

File metadata and controls

93 lines (69 loc) · 3.85 KB

Tina

READ THIS: AWS has changed the pricing model for AWS Glacier since the conception of this tool. Tina can still be used to restore objects, but its price estimates will be incorrect and we recommend using other tools like the AWS CLI. You have been warned. This project will remain for historical reasons.

Tina is a tool for restoring objects from Amazon Glacier into Amazon S3, while maintaining control over costs.

Amazon Glacier allows for a certain amount of the total storage to be restored for free. The pricing model is however very complicated when this threshold is exceeded, and it is not trivial to calculate when it will be. Tina was written in order to solve this by estimating a price for a restore given the total storage, the duration of the restore, and what objects to restore.

Install

$ gem install tina

Usage

What you need:

  • The total-storage number, which is the amount of data stored in Glacier, in bytes. You can find a good enough estimate for this number by looking at the "Amazon Simple Storage Service EU-TimedStorage-GlacierByteHrs" line item on your bill for last month ("Amazon Simple Storage Service TimedStorage-GlacierByteHrs" for US regions).
  • A PREFIX_FILE with lines on the format s3://<BUCKET>/<PREFIX> with all the prefixes you want to restore

An example of how this tool can be used follows.

Caroline stores 227 TiB of data in Glacier, which is 249589139505152 bytes. She wants to restore all photos from June 2014 from the bucket my-photos and all her horror movies starting with the letter A and B from my-movies. She prepares a file called my-restore.txt with the following contents:

s3://my-photos/2014/06/
s3://my-movies/horror/A
s3://my-movies/horror/B

She can now run tina like this;

$ tina restore --total-storage=249589139505152 --duration=20h --keep-days=14 my-restore.txt

This will instruct tina to prepare a restore over 20 hours for all objects matching the prefixes in my-restore.txt and keep the objects on S3 for 14 days. Using the total storage amount, tina can estimate a price for the restore.

After printing information about the restore and an estimated price, tina will ask Caroline whether to proceed.

Please note that tina is a long running process, which means it is a good idea to run it under screen or tmux, and on a machine that is constantly connected, e.g. an EC2 instance.

Notes

  • The estimated cost does not include the cost for the restore requests or the temporary storage on S3.
  • The estimated cost is based on the assumption that no other restores are running in parallel, since that would incur a higher peak restore rate and consequently a higher cost.
  • The parameter for specifying the number of days to keep objects on S3 is passed directly to the restore request. This means that objects restored in one of the first chunks may expire sooner from S3 than objects restored in one of the last chunks.

Future improvements

  • Speed up initial object listing by parallelizing requests
  • Implement a mode where tina figures out the required restore time to restore given a specific budget (that might be $0)
  • Implement resume and failure handling. Currently, if tina fails (for example due to a restore request failing) the prefix file would have to be updated manually in order to resume at the same place later.
  • Use a first-fit algorithm to spread objects into chunks, instead of the current naïve ordered chunking

Disclaimer

The authors make no guarantees that the costs calculated using this script are correct and will not take any responsibility for any costs caused by running this script. Please beware that restoring objects is a potentially costly operation, that Amazon's pricing model may change at any time and that this script may contain nasty bugs.

Copyright

© 2014 Burt AB, see LICENSE.txt (BSD 3-Clause).