Project

drebs

0.02
No commit activity in last 3 years
No release in over 3 years
drebs: Disaster Recovery for Elastic Block Store. An AWS EBS backup script.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 1.5.1
>= 1.2.8
>= 5.2.0
>= 0.9.12.6
>= 3.1.0
>= 2.4.2
 Project Readme

DREBS (Disaster Recovery for Elastic Block Store)

About

  • DREBS is a tool for taking periodic snapshots of EBS volumes.
  • DREBS is designed to be run on the EC2 host which the EBS volumes to be snapshoted are attached.
  • DREBS supports configurable retention strategies.
  • DREBS supports configurable pre and post snapshot tasks such as dumping databases prior to snapshot for consistency.

Installation & Setup

  1. Clone the repo or install the gem
  2. Output the example configuration to a file: drebs check_config example_config > your_config.yml
  3. Create an AWS account with authorization limited to create, list, & delete snapshots (Example coming soon)
  4. Add AWS API keys for above account to your_config.yml
  5. configure your_config.yml per your backup requirements
  6. test your configuration: drebs check_config your_config.yml && drebs check_cloud your_config.yml
  7. Add Crontab entry: 0 * * * * drebs execute your_config.yml

Todo

Testing notes

  • shell command: If you do: drebs shell some_config you will end up at a shell with @drebs defined and you will be able to access @drebs.db, @drebs.config, & @drebs.cloud. If you set @drebs.cloud to be an instance of TestCloud from the test suite you should be able to execute various functions without actually hitting AWS and so work from your dev box.

  • Due to the nature of drebs being designed to be run from an ec2 you will need to be on your ec2 instance to test many of the AWS interactions.

  • You should be able to verify data on a snapshot by creating an ebs volume from the snapshot, attaching the volume to your instance and then mounting its file system on some mount point - aws docs on using volumes

Copyright 2014 dojo4

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.