Harnessing the Power of the Ruby SDK on AWS

显示全部楼层 · 2014-2-19 11:55:14

Since launching in early 2006, Amazon Web Services (AWS) has been the dominant entity in Cloud Computing.
Their offering includes such services as EC2 for elastic computing, S3 for simple object storage, RDS for relational databases, and many more. Software companies are utilizing the cloud model to not only scale applications as demand increases, but also control expenses related to software deployment.
Over the past year, I have found myself using AWS more and more across a variety of development projects. Amazon provides a graphical user interface called the AWS Management Console that provides full control over all its services. The AWS Management Console is suitable for many of the tasks involving setup and maintenance of your cloud infrastructure.
However, as I started to use more complex features in AWS, I quickly found myself requiring a more powerful and programmatic interface that I could script as part of my development workflow. There are numerous SDKs available for accessing AWS.
The command-line interface offers fully-scriptable functionality, but processing the text of the responses incurred a lot of overhead. The Java SDK similarly has access to all the AWS features and the object-oriented library makes processing responses much easier.
But, the verbosity of the code - having to instantiate and construct a separate request object for every invocation - caused the scripts to grow large, even for simple use cases. Finally, I came across the Ruby SDK for AWS and haven’t looked back since.

千问 · 2014-2-19 11:55:14

Overview
AWS enforces a strict security model - an Access Key ID provides maps to your account number and a Secret Access Key used to sign all requests to the API.
Therefore, the first steps to using the SDK are to configure the access keys. The Ruby SDK simplifies the process by accepting a YAML file in the following format:1.access_key_id:
2.secret_access_key: 复制代码To complete the configuration, simply call config:AWS.config(YAML.load(File.read(path_to_config_file)))复制代码One potential “gotcha” of this setup is that the configuration is required before each and every invocation of AWS features. So even if you drop into irb to test some functionality, remember to call AWS.config.
The SDK includes many services - IAM (identity and access control management), ELB (load balancing support), SES (email services), VPC (virtual private cloud), among others - exposed through classes in the AWS module. Instantiating an object to make requests is as easy as this:ec2 = AWS::EC2.new复制代码The interface for the EC2 objects is one of the most intuitive and pleasant-to-use that I have experienced. It works just as you might expect, if you want to see all the instances running, simply execute:ec2.instances复制代码

千问 · 2014-2-19 11:55:14

一个能从别人的观念来看事情，能了解别人心灵活动的人永远不必为自己的前途担心。
顶,是一种追求

千问 · 2014-2-19 11:55:14

A subtle caveat to the Ruby SDK is the lazy loading mechanism. When you request a collection, such as instances, all instances are not actually enumerated at method invocation.
It is not until you iterate over the collection that an actual request is made to retrieve the instance’s information. This can save on unnecessary network traffic by limiting the number of round-trip HTTP requests required.
However it can also cause unexpected delays in the execution of your script, so beware.
Returning to the EC2 example, we can reference specified instances in EC2 by using the Amazon-provided instance ID:ec2.instances['i-23ab45cd']复制代码Each instance, in turn, as its own set of methods we can call to retrieve information such as security group, Amazon Machine Image (AMI) ID, elastic IP address, launch time, and much more.
The process for creating things in AWS (like instances) follows a factory pattern where the object’s collection acts as the factory. To launch a new instance in EC2, we simply need to invoke the create method:ec2.instances.create([instance_options])复制代码

千问 · 2014-2-19 11:55:14

Examples
I’ve assembled several examples of the scripts I’ve written to manage AWS and compiled them on my Github page.
Here’s a sample script for launching an EC2 instance in a virtual private cloud. Here, aws_config.rb performs the configuration for us.01.#!/usr/bin/env ruby
02.
03.require '../config/aws_config'
04.require 'aws-sdk'
05.
06.(private_ip, security_group_id, image_id, subnet_id) = ARGV
07.
08.# Check for necessary parameters
09.unless private_ip && security_group_id && image_id && subnet_id
10.puts "Usage #{$0} private_ip security_group_id image_id subnet_id"
11.exit 1
12.end
13.
14.# Instantiate EC2 object
15.ec2 = AWS::EC2.new
16.
17.new_inst = ec2.instances.create(
18.:image_id => image_id,
19.:subnet => ec2.subnets[subnet_id],
20.:instance_type => 'm1.large',
21.:key_name => your_key_name,
22.:private_ip => private_ip,
23.:security_group_ids => { security_group_id })
24.
25.puts "Waiting for new instance with id #{new_inst.id} to become available..."
26.
27.sleep 1 while new_inst.status == :pending
28.new_inst.add_tag('Name', :value => private_ip)
29.
30.puts '...ready'复制代码

千问 · 2014-2-19 11:55:14

One deployment strategy I’ve found helpful is to group EC2 instances into roles.
Roles are logical groupings based on a node’s functionality, like a web proxy, application server, database, monitoring system, or something else.
Adding roles to instances is as easy as adding a tag to the EC2 instance with the key ‘Role’. Here’s another script that shows information about all running instances in a VPC, grouped by roles.01.#!/usr/bin/env ruby
02.
03.require File.expand_path(File.dirname(__FILE__) + '/../config/aws_config')
04.
05.vpc = AWS::EC2.new.vpcs.first
06.
07.vpc.instances.group_by { |inst| inst.tags['Role'] }.each do |role, instances|
08.if role == nil || role.length == 0 then next end
09.puts "#{role}:"
10.instances.each do |inst|
11.sec_groups = inst.security_groups.collect {|sg| sg.name }.join(', ')
12.puts "Name: #{inst.tags['Name']}"
13.puts "ID: #{inst.id}"
14.puts "AMI: #{inst.image_id}"
15.puts "Private IP: #{inst.private_ip_address}"
16.puts "Elastic IP: #{inst.public_ip_address}" if inst.public_ip_address
17.puts "Security groups: #{sec_groups}"
18.puts
19.end
20.puts
21.end复制代码