aws_helper 0.0.3 → 0.0.4

data/README.md

@@ -31,6 +31,10 @@ Prune so only keep 7 snapshots:
 
     aws_helper snap_prune /dev/sda1 --snapshots_to_keep=7
 
+Email me a list of the latest 20 snapshots:
+
+    aws_helper snap_email me@company.com ebs.backups@company.com mysmtpemailserver.com
+
 ## Complex Usage
 
 If your server does not have a role then you need to code the AWS keys which is not best practice:
@@ -42,12 +46,19 @@ Snapshot EBS attached to device /dev/sdf volume vol-123456 access AWS through an
     export HTTP_PROXY=http://myproxy:port
     aws_helper snap /dev/sdf vol-123456 --description zzzzzzzzz
 
-Prune so only keep 7 snapshots: 
+Prune so only keep 20 snapshots: 
+
+    export AWS_ACCESS_KEY_ID ='xxxxxxxxxxxx'
+    export AWS_SECRET_ACCESS_KEY ='yyyyyyyy'
+    export HTTP_PROXY=http://myproxy:port
+    aws_helper snap_prune /dev/sdf vol-123456 --snapshots_to_keep=20
+
+Email me a list of the latest 30 snapshots with a subject title on email:
 
     export AWS_ACCESS_KEY_ID ='xxxxxxxxxxxx'
     export AWS_SECRET_ACCESS_KEY ='yyyyyyyy'
     export HTTP_PROXY=http://myproxy:port
-    aws_helper snap_prune /dev/sdf vol-123456 --snapshots_to_keep=7
+    aws_helper snap_email me@company.com ebs.backups@company.com mysmtpemailserver.com 'My EBS Backups' --rows=30
  
 Other functions to follow     
 

data/lib/awshelper/cli.rb

@@ -2,6 +2,7 @@ require 'thor'
 require 'awshelper'
 require 'awshelper/ec2'
 require 'syslog'
+require 'net/smtp'
 
 module Awshelper
   class CLI < Thor
@@ -80,7 +81,7 @@ option :description
 long_desc <<-LONGDESC
   'snap DEVICE [VOLUME_ID] --description xxxxxx' 
   \x5 Take a snapshot of a EBS Disk by specifying device and/or volume_id.
-  \x5 All commands rely on environment variables 
+  \x5 All commands rely on environment variables or the server having an IAM role 
     \x5   export AWS_ACCESS_KEY_ID ='xxxxxxxxxx'
     \x5   export AWS_SECRET_ACCESS_KEY ='yyyyyy'
   \x5 For example 
@@ -102,7 +103,7 @@ option :snapshots_to_keep, :type => :numeric, :required => true
 long_desc <<-LONGDESC
   'snap_prune DEVICE [VOLUME_ID] --snapshots_to_keep=<numeric>' 
   \x5 Prune the number of snapshots of a EBS Disk by specifying device and/or volume_id and the no to keep.
-   \x5 All commands rely on environment variables 
+   \x5 All commands rely on environment variables or the server having an IAM role 
     \x5    export AWS_ACCESS_KEY_ID ='xxxxxxxxxxxx'
     \x5    export AWS_SECRET_ACCESS_KEY ='yyyyyyyy'
   \x5 For example 
@@ -129,6 +130,42 @@ def snap_prune(device, volume_id=nil)
   end
 end
 
+desc "snap_email TO FROM EMAIL_SERVER", "Email Snapshot List."
+option :rows, :type => :numeric, :required => false
+
+long_desc <<-LONGDESC
+  'snap_email TO FROM EMAIL_SERVER ['EBS Backups'] --rows=<numeric>'' 
+  \x5 Emails the last 20 snapshots from specific email address via the email_server.
+   \x5 All commands rely on environment variables or the server having an IAM role
+    \x5    export AWS_ACCESS_KEY_ID ='xxxxxxxxxxxx'
+    \x5    export AWS_SECRET_ACCESS_KEY ='yyyyyyyy'
+  \x5 For example 
+    \x5    aws_helper snap_email me@mycompany.com ebs.backups@mycompany.com emailserver.com 'My EBS Backups' --rows=20
+  \x5 will email the list of the latest 20 snapshots to email address me@mycompany.com via email server emailserver.com  
+LONGDESC
+
+def snap_email(to, from, email_server, subject='EBS Backups')
+  rows = 20
+  rows = options[:rows] if options[:rows]
+  message = ""
+  log("Report on snapshots")
+  # ({ Name="start-time", Values="today in YYYY-MM-DD"})
+  i = rows
+  ec2.describe_snapshots.sort { |a,b| b[:aws_started_at] <=> a[:aws_started_at] }.each do |snapshot|
+    if i >0
+      message = message+"#{snapshot[:aws_id]} #{snapshot[:aws_volume_id]} #{snapshot[:aws_started_at]} #{snapshot[:aws_description]} #{snapshot[:aws_status]}\n"
+      i = i-1
+    end
+  end
+  opts = {}
+  opts[:server] = email_server
+  opts[:from] = from
+  opts[:from_alias] = 'EBS Backups'
+  opts[:subject] = subject
+  opts[:body] = message
+  send_email(to,opts)
+end
+
 private
 
 def log(message,type="info")
@@ -294,6 +331,26 @@ def detach_volume(volume_id, timeout)
   end
 end
 
+def send_email(to,opts={})
+  opts[:server]      ||= 'localhost'
+  opts[:from]        ||= 'email@example.com'
+  opts[:from_alias]  ||= 'Example Emailer'
+  opts[:subject]     ||= "You need to see this"
+  opts[:body]        ||= "Important stuff!"
+
+  msg = <<END_OF_MESSAGE
+From: #{opts[:from_alias]} <#{opts[:from]}>
+To: <#{to}>
+Subject: #{opts[:subject]}
+
+#{opts[:body]}
+END_OF_MESSAGE
+   puts "Sending to #{to} from #{opts[:from]} email server #{opts[:server]}" 
+  Net::SMTP.start(opts[:server]) do |smtp|
+    smtp.send_message msg, opts[:from], to
+  end
+end
+
 
 end
 

data/lib/awshelper/version.rb

@@ -1,3 +1,3 @@
 module Awshelper
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws_helper
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-25 00:00:00.000000000 Z
+date: 2015-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: right_aws