Skip to content

Commit

Permalink
Update README regarding retirement status
Browse files Browse the repository at this point in the history
/closes #9
  • Loading branch information
sopel committed Feb 10, 2014
1 parent 2d10585 commit e8acaa3
Showing 1 changed file with 36 additions and 7 deletions.
43 changes: 36 additions & 7 deletions README.rdoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,18 @@
= Description
Creates a snapshot of each EBS volume attached to the list of instances provided in aws_snapshotter_settings (or all instances if an empty array is provided)
= aws_snapshotter

Creates a snapshot of each EBS volume attached to the list of instances provided in aws_snapshotter_settings (or all instances if an empty array is provided).

== Status

{Unsupported}[http://labs.cityindex.com/wp-content/uploads/2012/01/lbl-unsupported.png]

This project has been retired and is no longer being supported by City Index Ltd.

* if you should choose to fork it outside of City Index, please let us know so we can link to your project

== Description

Creates a snapshot of each EBS volume attached to the list of instances provided in aws_snapshotter_settings (or all instances if an empty array is provided).

Each instance is stopped, to ensure that the snapshot will contain consistent data.

Expand All @@ -11,7 +24,7 @@ An aws_snapshotter_settings.rb.example file is provided, to configure the aws_sn

Then change the values to include your AWS credentials, and the list of instances you want to create snapshots for. Easy!

== Install Directions
=== Install Directions
The AWS Snapshotter currently depends upon a build of the right_http_connection and right_aws gems which is not available in gem source. You must install them manually, specifying a source, like so.

$ wget http://rgeyer.s3.amazonaws.com/gems/right_http_connection-1.3.0.gem
Expand All @@ -29,12 +42,12 @@ To apply this policy follow the "Get Tools" directions {here}[http://docs.amazon

The first and second line of the response of iam-usercreate are the AWS Access Key ID and AWS Secret Access Key which are needed in your settings file.

== Running aws_snapshotter
=== Running aws_snapshotter
Once you've created the IAM user and configured your aws_snapshotter_settings file, you can run the AWS Snapshotter with this simple command.

$ ruby create_snaps.rb

== Assumptions & Prerequisites
=== Assumptions & Prerequisites
The AWS Snapshotter is designed to take periodic snapshots of running EC2 instances. The following assumptions are made about the instances defined in the _Settings::instances_ directive of the settings file (or all instances for your account, if _Settings::instances_ is left empty).

* The instances are EBS backed, and can be stopped/started
Expand All @@ -44,8 +57,24 @@ In order to ensure data integrity of the snapshots which are created, the runnin

If an instance is stopped when the AWS Snapshotter is executed, no snapshot will be made for the EBS volumes attached to it, even if the instance is listed in the _Settings::instances_ directive.

= TODO
== TODO
* More error handling
* It's okay if stopping and snapshotting instances fail, it's not okay if the instances are never restarted.
* Enhancements
* Maybe it's okay to take snapshots for instances that are listed and are already in the stopped state?
* Maybe it's okay to take snapshots for instances that are listed and are already in the stopped state?

== License

Copyright 2011 City Index Ltd.

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}[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.

0 comments on commit e8acaa3

Please sign in to comment.