Automatic backup management of AWS EC2 EBS volumes
Project description
Automated EBS Snapshots helps you ensure that you have up to date snapshots of your EBS volumes.
All you need to do to get started is documented below.
Installation
pip install automated-ebs-snapshots
Authentication configuration
Automated EBS snapshots can be configured either via command line options or using a configuration file.
Command line options
You can use the following command line options to authenticate to AWS.
AWS configuration options: --access-key-id ACCESS_KEY_ID AWS access key --secret-access-key SECRET_ACCESS_KEY AWS secret access key --region REGION AWS region
Configuration file
Create a configuration file anywhere on you file system.
[general] access-key-id: xxxx secret-access-key: xxxxxxxx region: eu-west-1
Then use the --config command line option to point at your configuration file.
Watching and unwatching volumes
Start watching a volume
In order to enable automatic snapshots, you need to start watching the volume. The following command will add vol-13245678 to the watchlist with snapshots created daily.
automated-ebs-snapshots --config ~/auto-ebs-snapshots.conf --watch vol-12345678 --interval daily
Add volumes to watch list
To add lots of volumes in one time, we can create a configuration file to define volumes(support volume id or Name tag), interval and retention.
vol-d9d6d6af,weekly,2 volume1,weekly,4 volume2,daily,0
Then run the following command
automated-ebs-snapshots --config ~/auto-ebs-snapshots.conf --watch-file volumes.conf
List watched volumes
List the currently watched volumes and their backup interval
automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --list
Stop watching a volume
To stop creating automated backups for a volume, run this:
automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --unwatch vol-12345678
Remove volumes from watch list
To remove all volumes in the configuration file, just run:
automated-ebs-snapshots --config ~/auto-ebs-snapshots.conf --unwatch-file volumes.conf
List snapshots for a volume
List all snapshots for the given volume id or volume name
automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --snapshots vol-d9d6d6af
Creating snapshots
Now, to start taking snapshots you will need to have Automated EBS Snapshots running. You can either run automated-ebs-snapshots manually (i.e. scheduled in crontab or such) or have it running in daemon mode.
Manual execution
Running automated-ebs-snapshots manually:
automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --run
It will check if there are any volumes with no or too old snapshots. New snapshots will be created if needed.
Daemon mode
Start the daemon by running
automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --daemon start
Stop the daemon with
automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --daemon stop
You can also restart it using
automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --daemon restart
Release notes
0.4.0
Added support for reading volumes from file (#13). Thanks @yumminhuang for the pull request
Now supports managing volumes by tag Name in addition to volume-id (#13). Thanks @yumminhuang for the pull request
0.3.2
Bumped requirement to boto >= 2.29.0 (#7)
0.3.1
Fixed IAM Instance Profile authentication for boto >= 2.29.0 (#6)
0.3.0
License
APACHE LICENSE 2.0 Copyright 2014 Skymill Solutions
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
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for automated-ebs-snapshots-0.4.1a1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d7cd73b814466c2be3a162df8f9a9b24c338c5b697eef77c2cb02a1c3f7b1a6a |
|
MD5 | 862e4115b6ba369ee15a08c9cc1bb3e2 |
|
BLAKE2b-256 | f13ea36bf3afbf6743fd9e74f9e9a39f26f388ecf7808b469614f5f861ea9fc5 |