README.txt

Path: README.txt
Last Update: Mon Apr 30 18:08:29 -0400 2007

Capazon

Capistrano tasks to manage Amazon EC2 Images. Requires Capistrano 2.x

This project is in no way endorsed, sponsored by, or associated with Amazon or amazon.com.

Installation

  • gem install capazon
  • Edit your your config/deploy.rb:
      require 'capazon'
    
      #AWS login info
      set :aws_access_key_id, 'XXX'
      set :aws_secret_access_key, 'X'
    
      # Name of the keypair used to spawn and connect to the Amazon EC2 Instance
      # Defaults to one created by the setup_keypair task
      set :aws_keypair_name, "#{application}-capazon"
    
      # Path to the private key for the Amazon EC2 Instance mentioned above
      # Detaults to one created by setup_keypair task
      set :aws_private_key_path, "#{Dir.pwd}/#{aws_keypair_name}-key"
    
      #defaults to an ubuntu image
      #set :aws_ami_id, "ami-e4b6538d"
    
      #defaults to, um, default
      #set :aws_security_group, "default"
    

Tasks

Notes:
  • All tasks require aws_access_key_id and aws_secret_access_key.
  • All tasks optionally take environment variables in lieu of capistrano configuration variables.
ec2:create_keypair
Create a keypair aws_keypair_name and write out the generate private key to aws_private_key_path.
ec2:delete_keypair
Deletes keypair aws_keypair_name.
ec2:describe_keypairs
Describes keypairs.
ec2:describe_images
Describes AMIs you have privilege to execute.
ec2:run_instance
Runs an instance of aws_ami_id with access available via aws_keypair_name.
ec2:terminate_instance
Terminates aws_instance_id.
ec2:describe_instances
Describes running AMIs.
ec2:authorize_web_and_ssh_access
Opens tcp access on port 80 and 22 to the aws_security_group.

Meta

Rubyforge Project Page:rubyforge.org/projects/capazon
Author:Jesse Newland (soylentfoo.jnewland.com) (jnewland@gmail.com)
Copyright:Copyright (c) 2007 Jesse Newland
License:Distributes under the same terms as Ruby

[Validate]