update of ec2-automate-backup.sh with support for PurgeAfter tag - purge support coming soon.
This commit is contained in:
parent
e69fda405d
commit
c1025a4188
|
@ -0,0 +1,28 @@
|
||||||
|
ec2ab_exec=/Temp/ec2-automate-backup.sh
|
||||||
|
#create two volumes
|
||||||
|
volume_1=`ec2-create-volume --size 2 GB --availability-zone us-east-1a`
|
||||||
|
volume_2=`ec2-create-volume --size 2 GB --availability-zone us-east-1a`
|
||||||
|
#get volume id of both volumes
|
||||||
|
volume_1_id=`echo "$volume_1" | cut -f 2`
|
||||||
|
volume_2_id=`echo "$volume_2" | cut -f 2`
|
||||||
|
#tag volume_1 with Backup=true
|
||||||
|
ec2-create-tags $volume_1_id --tag Backup=true
|
||||||
|
#test backing up only volume with tag Backup=true
|
||||||
|
$ec2ab_exec -s tag -t Backup=true
|
||||||
|
#expected result - snapshot only taken of volume_1
|
||||||
|
#
|
||||||
|
#test backing up only EBS volume with IDs "x" and "y"
|
||||||
|
$ec2ab_exec -v "$volume_1_id $volume_2_id"
|
||||||
|
#expected result - snapshot only taken of volume_1 and volume_2
|
||||||
|
#
|
||||||
|
#test backing up only EBS volume with IDs "x" and "y" and tagging them with "name"
|
||||||
|
$ec2ab_exec -v "$volume_1_id $volume_2_id" -n
|
||||||
|
#expected result - snapshot only taken of volume_1 and volume_2 each with tag "name" set to ec2ab_$volume_id_$date_current
|
||||||
|
#
|
||||||
|
#test backing up only EBS volume with IDs "x" and "y" and tagging them with a tag "PurgeAfter=14"
|
||||||
|
$ec2ab_exec -v "$volume_1_id $volume_2_id" -k 14
|
||||||
|
#expected result - snapshot only taken of volume_1 and volume_2 each with tags "PurgeAfter=$date_current+14" and "PurgeAllow=true"
|
||||||
|
#
|
||||||
|
#test backing up only EBS volume with IDs "x" and "y" and tagging them with a tag "PurgeAfter=1"
|
||||||
|
$ec2ab_exec -v "$volume_1_id $volume_2_id" -k 14 -n
|
||||||
|
#expected result - snapshot only taken of volume_1 and volume_2 each with tag "name" set to ec2ab_$volume_id_$date_current
|
|
@ -1,8 +1,10 @@
|
||||||
# Introduction:
|
# Introduction:
|
||||||
ec2-automate-backup was created to provide easy backup/snapshot functionality for EC2 EBS volumes. Common uses would include the following:
|
ec2-automate-backup was created to provide easy backup/snapshot functionality for EC2 EBS volumes. Common uses would include the following:
|
||||||
* run ec2-automate-backup with a list of volumes for which a snapshot is desired
|
* run ec2-automate-backup with a list of volumes for which a snapshot is desired (example: ec2-automate-backup.sh -v "vol-6d6a0527 vol-636a0112")
|
||||||
|
* run ec2-automate-backup with a list of volumes for which a snapshot is desired and allow the created snapshots to be deleted after 14 days (example: ec2-automate-backup.sh -v "vol-6d6a0527 vol-636a0112" -k 31)
|
||||||
* run ec2-automate-backup using cron to produce a daily backup (example: "0 0 * * 0 ec2-user /home/ec2-user/ec2-automate-backup.sh -v "vol-6d6a0527 vol-636a0112" > /home/ec2-user/ec2-automate-backup_`date +"%Y%m%d"`.log")
|
* run ec2-automate-backup using cron to produce a daily backup (example: "0 0 * * 0 ec2-user /home/ec2-user/ec2-automate-backup.sh -v "vol-6d6a0527 vol-636a0112" > /home/ec2-user/ec2-automate-backup_`date +"%Y%m%d"`.log")
|
||||||
* run ec2-automate-backup to snapshot all EBS volumes that contain the tag "Backup=true" (example: "0 0 * * 0 ec2-user /home/ec2-user/ec2-automate-backup.sh -s tag -t "Backup=true" > /home/ec2-user/ec2-automate-backup_`date +"%Y%m%d"`.log")
|
* run ec2-automate-backup to snapshot all EBS volumes that contain the tag "Backup=true" (example: "0 0 * * 0 ec2-user /home/ec2-user/ec2-automate-backup.sh -s tag -t "Backup=true" > /home/ec2-user/ec2-automate-backup_`date +"%Y%m%d"`.log")
|
||||||
|
|
||||||
# Directions For Use:
|
# Directions For Use:
|
||||||
#
|
#
|
||||||
## Example of Use:
|
## Example of Use:
|
||||||
|
@ -21,6 +23,7 @@ ec2-automate-backup requires one of the following two parameters be provided:
|
||||||
-r <region> - the region that contains the EBS volumes for which you wish to have a snapshot created.
|
-r <region> - the region that contains the EBS volumes for which you wish to have a snapshot created.
|
||||||
-s <selection_method> - the selection method by which EBS volumes will be selected. Currently supported selection methods are "volumeid" and "tag." The selection method "volumeid" identifies EBS volumes for which a snapshot should be taken by volume id whereas the selection method "tag" identifies EBS volumes for which a snapshot should be taken by a key=value format tag.
|
-s <selection_method> - the selection method by which EBS volumes will be selected. Currently supported selection methods are "volumeid" and "tag." The selection method "volumeid" identifies EBS volumes for which a snapshot should be taken by volume id whereas the selection method "tag" identifies EBS volumes for which a snapshot should be taken by a key=value format tag.
|
||||||
-n - tag snapshots "Name" tag as well as description
|
-n - tag snapshots "Name" tag as well as description
|
||||||
|
-k <purge_after_days> - the period after which a snapshot can be purged. For example, running "ec2-automate-backup.sh -v "vol-6d6a0527 vol-636a0112" -k 31" would allow snapshots to be removed after 31 days
|
||||||
#
|
#
|
||||||
# Potential Uses and Methods of Use:
|
# Potential Uses and Methods of Use:
|
||||||
#
|
#
|
||||||
|
@ -33,6 +36,6 @@ ec2-automate-backup requires one of the following two parameters be provided:
|
||||||
# Additional Information:
|
# Additional Information:
|
||||||
#
|
#
|
||||||
Author: Colin Johnson / colin@cloudavail.com
|
Author: Colin Johnson / colin@cloudavail.com
|
||||||
Date: 2012-09-07
|
Date: 2012-09-21
|
||||||
Version 0.1
|
Version 0.1
|
||||||
License Type: GNU GENERAL PUBLIC LICENSE, Version 3
|
License Type: GNU GENERAL PUBLIC LICENSE, Version 3
|
||||||
|
|
|
@ -1,13 +1,13 @@
|
||||||
#!/bin/bash -
|
#!/bin/bash -
|
||||||
# Author: Colin Johnson / colin@cloudavail.com
|
# Author: Colin Johnson / colin@cloudavail.com
|
||||||
# Date: 2012-09-14
|
# Date: 2012-09-21
|
||||||
# Version 0.1
|
# Version 0.1
|
||||||
# License Type: GNU GENERAL PUBLIC LICENSE, Version 3
|
# License Type: GNU GENERAL PUBLIC LICENSE, Version 3
|
||||||
#
|
#
|
||||||
#confirms that executables required for succesful script execution are available
|
#confirms that executables required for succesful script execution are available
|
||||||
prerequisite_check()
|
prerequisite_check()
|
||||||
{
|
{
|
||||||
for prerequisite in basename ec2-create-snapshot
|
for prerequisite in basename ec2-create-snapshot ec2-create-tags
|
||||||
do
|
do
|
||||||
#use of "hash" chosen as it is a shell builtin and will add programs to hash table, possibly speeding execution. Use of type also considered - open to suggestions.
|
#use of "hash" chosen as it is a shell builtin and will add programs to hash table, possibly speeding execution. Use of type also considered - open to suggestions.
|
||||||
hash $prerequisite &> /dev/null
|
hash $prerequisite &> /dev/null
|
||||||
|
@ -18,7 +18,7 @@ prerequisite_check()
|
||||||
}
|
}
|
||||||
|
|
||||||
#get_EBS_List gets a list of available EBS instances depending upon the selection_method of EBS selection that is provided by user input
|
#get_EBS_List gets a list of available EBS instances depending upon the selection_method of EBS selection that is provided by user input
|
||||||
get_EBS_list()
|
get_EBS_List()
|
||||||
{
|
{
|
||||||
case $selection_method in
|
case $selection_method in
|
||||||
volumeid)
|
volumeid)
|
||||||
|
@ -29,7 +29,7 @@ get_EBS_list()
|
||||||
;;
|
;;
|
||||||
tag)
|
tag)
|
||||||
if [[ -z $tag ]]
|
if [[ -z $tag ]]
|
||||||
then echo "The selected selection_method \"tag\" (-s tag) requires a valid tag (-t key=value) for operation. Correct usage is as follows: \"-s tag -t backup=true\" or \"-s tag -t Name=my_ebs_volume.\"" 1>&2 ; exit 64
|
then echo "The selected selection_method \"tag\" (-s tag) requires a valid tag (-t key=value) for operation. Correct usage is as follows: \"-s tag -t backup=true\" or \"-s tag -t Name=my_tag.\"" 1>&2 ; exit 64
|
||||||
fi
|
fi
|
||||||
ebs_selection_string="--filter tag:$tag"
|
ebs_selection_string="--filter tag:$tag"
|
||||||
;;
|
;;
|
||||||
|
@ -46,6 +46,27 @@ get_EBS_list()
|
||||||
#code to right will output list of EBS volumes to be backed up: echo -e "Now outputting ebs_backup_list:\n$ebs_backup_list"
|
#code to right will output list of EBS volumes to be backed up: echo -e "Now outputting ebs_backup_list:\n$ebs_backup_list"
|
||||||
}
|
}
|
||||||
|
|
||||||
|
create_EBS_Snapshot_Tags()
|
||||||
|
{
|
||||||
|
#snapshot tags holds all tags that need to be applied to a given snapshot - by aggregating tags we ensure that ec2-create-tags is called only onece
|
||||||
|
snapshot_tags=""
|
||||||
|
#if $name_tag_create is true then append ec2ab_${ebs_selected}_$date_current to the variable $snapshot_tags
|
||||||
|
if $name_tag_create
|
||||||
|
then
|
||||||
|
ec2_snapshot_resource_id=`echo "$ec2_create_snapshot_result" | cut -f 2`
|
||||||
|
snapshot_tags="$snapshot_tags --tag Name=ec2ab_${ebs_selected}_$date_current"
|
||||||
|
fi
|
||||||
|
#if $purge_after_days is true, then append $purge_after_date to the variable $snapshot_tags
|
||||||
|
if [[ -n $purge_after_days ]]
|
||||||
|
then
|
||||||
|
snapshot_tags="$snapshot_tags --tag PurgeAfter=$purge_after_date --tag PurgeAllow=true"
|
||||||
|
fi
|
||||||
|
#if $snapshot_tags is not zero length then set the tag on the snapshot using ec2-create-tags
|
||||||
|
if [[ -n $snapshot_tags ]]
|
||||||
|
then ec2-create-tags $ec2_snapshot_resource_id --region $region $snapshot_tags
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
#calls prerequisitecheck function to ensure that all executables required for script execution are available
|
#calls prerequisitecheck function to ensure that all executables required for script execution are available
|
||||||
prerequisite_check
|
prerequisite_check
|
||||||
|
|
||||||
|
@ -54,26 +75,36 @@ app_name=`basename $0`
|
||||||
#sets defaults
|
#sets defaults
|
||||||
selection_method="volumeid"
|
selection_method="volumeid"
|
||||||
region="us-east-1"
|
region="us-east-1"
|
||||||
#sets date variable
|
|
||||||
date_current=`date -u +%Y-%m-%d`
|
|
||||||
#sets the "Name" tag set for a snapshot to false - using "Name" requires that ec2-create-tags be called in addition to ec2-create-snapshot
|
#sets the "Name" tag set for a snapshot to false - using "Name" requires that ec2-create-tags be called in addition to ec2-create-snapshot
|
||||||
name_tag_set=false
|
name_tag_create=false
|
||||||
|
#sets the Purge Snapshot feature to false - this feature will eventually allow the removal of snapshots that have a "PurgeAfter" tag that is earlier than current date
|
||||||
|
purge_snapshots=false
|
||||||
|
|
||||||
#handles options processing
|
#handles options processing
|
||||||
while getopts :s:r:v:t:n opt
|
while getopts :s:r:v:t:k:pn opt
|
||||||
do
|
do
|
||||||
case $opt in
|
case $opt in
|
||||||
s) selection_method="$OPTARG";;
|
s) selection_method="$OPTARG";;
|
||||||
r) region="$OPTARG";;
|
r) region="$OPTARG";;
|
||||||
v) volumeid="$OPTARG";;
|
v) volumeid="$OPTARG";;
|
||||||
t) tag="$OPTARG";;
|
t) tag="$OPTARG";;
|
||||||
n) name_tag_set=true;;
|
k) purge_after_days="$OPTARG";;
|
||||||
|
n) name_tag_create=true;;
|
||||||
|
p) purge_snapshots=true;;
|
||||||
*) echo "Error with Options Input. Cause of failure is most likely that an unsupported parameter was passed or a parameter was passed without a corresponding option." 1>&2 ; exit 64;;
|
*) echo "Error with Options Input. Cause of failure is most likely that an unsupported parameter was passed or a parameter was passed without a corresponding option." 1>&2 ; exit 64;;
|
||||||
esac
|
esac
|
||||||
done
|
done
|
||||||
|
|
||||||
|
#sets date variable
|
||||||
|
date_current=`date -u +%Y-%m-%d`
|
||||||
|
#sets the PurgeAfter tag to the number of days that a snapshot should be retained
|
||||||
|
if [[ -n $purge_after_days ]]
|
||||||
|
then purge_after_date=`date -v+${purge_after_days}d -u +%Y-%m-%d`
|
||||||
|
echo "Snapshots taken by $app_name will be eligible for purging after the following date: $purge_after_date."
|
||||||
|
fi
|
||||||
|
|
||||||
#get_EBS_List gets a list of EBS instances for which a snapshot is desired. The list of EBS instances depends upon the selection_method that is provided by user input
|
#get_EBS_List gets a list of EBS instances for which a snapshot is desired. The list of EBS instances depends upon the selection_method that is provided by user input
|
||||||
get_EBS_list
|
get_EBS_List
|
||||||
|
|
||||||
#the loop below is called once for each volume in $ebs_backup_list - the currently selected EBS volume is passed in as "ebs_selected"
|
#the loop below is called once for each volume in $ebs_backup_list - the currently selected EBS volume is passed in as "ebs_selected"
|
||||||
for ebs_selected in $ebs_backup_list
|
for ebs_selected in $ebs_backup_list
|
||||||
|
@ -82,9 +113,8 @@ do
|
||||||
ec2_create_snapshot_result=`ec2-create-snapshot --region $region -d $ec2_snapshot_description $ebs_selected 2>&1`
|
ec2_create_snapshot_result=`ec2-create-snapshot --region $region -d $ec2_snapshot_description $ebs_selected 2>&1`
|
||||||
if [[ $? != 0 ]]
|
if [[ $? != 0 ]]
|
||||||
then echo -e "An error occured when running ec2-create-snapshot. The error returned is below:\n$ec2_create_snapshot_result" 1>&2 ; exit 70
|
then echo -e "An error occured when running ec2-create-snapshot. The error returned is below:\n$ec2_create_snapshot_result" 1>&2 ; exit 70
|
||||||
elif $name_tag_set
|
else
|
||||||
then
|
|
||||||
ec2_snapshot_resource_id=`echo "$ec2_create_snapshot_result" | cut -f 2`
|
ec2_snapshot_resource_id=`echo "$ec2_create_snapshot_result" | cut -f 2`
|
||||||
ec2-create-tags $ec2_snapshot_resource_id --region $region --tag Name=$ec2_snapshot_description
|
fi
|
||||||
fi
|
create_EBS_Snapshot_Tags
|
||||||
done
|
done
|
Loading…
Reference in New Issue
Block a user