befog 0.5.2 → 0.5.3

data/AUTHORS

@@ -0,0 +1,3 @@
+Lance Lakey lancelakey@gmail.com
+Carlo Flores lo@js.la
+Dan Yoder danielyoder@gmail.com

data/Readme.md

@@ -0,0 +1,100 @@
+Befog is a command line utility for cloud management. Or, put another way, it's a CLI wrapper for the `fog` gem.
+
+Befog allows you to manage groups or clusters of servers as "banks."  A bank can have one or many servers.  
+Features include the ability to start, stop, add to, remove, or run a command on all servers in a bank.
+
+For example, the following command would add 3 servers to the server bank named `web-prod`:
+
+    befog add web-prod --count 3
+
+Befog tries to be helpful whenever a command is invoked with no arguments. You can start with this:
+
+    befog
+  
+and go from there. For example, you can do:
+
+    befog add
+    
+And you'll get this:
+
+befog add <bank> [<options>]
+	-c, --count COUNT       	The number of machines to provision (required) 
+	-h, --help HELP         	Show this message                       
+	-n, --name NAME         	The name of this configuration (default: default) 
+	-p, --path PATH         	Path to the configuration file (default: ~/.befog) 
+	-s, --spot SPOT         	Provision a spot instance               
+	-t, --type TYPE         	The type of machines to provision       
+	-u, --rehearse REHEARSE 	Dry-run, verbose logging, but don't actually run anything
+
+## Configuring Befog
+
+In order to do anything interesting, you first need to tell Befog about your cloud accounts. You do this using the `configure` subcommand.
+
+    befog configure --provider aws --key <your-aws-key> --secret <your-aws-secret>
+        
+You also need to set up bank-specific configurations.
+
+For example, the following command sets up the provider, region, image, and keypair to be used with the server bank named `web-prod` (you can also just say `config` for short):
+
+    befog config web-prod --provider aws \
+      --region us-east-1 --image <your-aws-image> \
+      --keypair <your-keypair> --group <your-aws-group-name> \ 
+      --type <your-aws-server-type>
+    
+To see the full list of configuration options, just type:
+
+    befog config
+    
+You generally don't need to set these up very often - just when setting up a new bank, typically using a different region, provider, or image. Once a bank is configured, all servers deployed using that bank will use the bank's configuration automatically.
+        
+## Provisioning Servers
+
+Once you have a configuration set up, you can easily provision new servers:
+
+    befog add web-prod --count 3
+
+You can also de-provision them just as easily:
+
+    befog remove web-prod --count 3
+    
+## Multiple Configurations
+
+Sometimes you want one set of servers for a test environment and another for production or a beta environment. You can use the `--name` option to specify a named configuration different environments. For example, let's start up the `web-prod` bank of our `test` environment:
+
+    befog start web-prod --name test
+    
+Each environment must be configured separately. If you don't specify a name, the name `default` is applied. Again, once configured, you can typically use that configuration over and over.
+
+Another option is to simply use different configuration files. You can do this with the --path command.
+
+Finally, you can simply edit configurations directly if you want, since they are just YAML files and are fairly easy to read. Be careful, though, since this can confuse `befog` if the format get mangled somehow.
+
+## Other Features
+
+You can suspend a bank:
+
+    befog stop web-prod
+    
+Or start them back up:
+
+    befog start web-prod
+    
+You can even run a command on every server in a bank:
+
+    befog run web-prod --command 'apt-get install redis'
+    
+You can get a list of all the servers associated with a bank:
+
+    befog ls web-prod
+    
+or with a specific-provider:
+
+    befog ls --provider aws
+    
+or for all servers currently deployed:
+
+    befog ls
+    
+## Limitations
+
+Befog is currently still under development and only supports basic provisioning options for Amazon EC2.

data/VERSION

@@ -0,0 +1 @@
+0.5.3

data/bin/befog

@@ -1,13 +1,4 @@
 #!/usr/bin/env ruby
-require "rubygems"
-
-# resolve bin path, ignoring symlinks
-require "pathname"
-bin_file = Pathname.new(__FILE__).realpath
-
-# add self to libpath
-$:.unshift File.expand_path("../../lib", bin_file)
-
-require "befog"
 
+require_relative "../lib/befog"
 Befog::CLI.run(ARGV)

data/lib/befog.rb

@@ -1,5 +1,6 @@
 module Befog
   VERSION = begin
+    require "pathname"
     path = File.expand_path("../../VERSION", Pathname.new(__FILE__).realpath)
     File.read(path).chomp
   end

metadata

@@ -1,81 +1,86 @@
 --- !ruby/object:Gem::Specification
 name: befog
 version: !ruby/object:Gem::Version
-  version: 0.5.2
-  prerelease: 
+  prerelease:
+  version: 0.5.3
 platform: ruby
 authors:
 - Lance Lakey lancelakey@gmail.com
 - Carlo Flores lo@js.la
 - Dan Yoder danielyoder@gmail.com
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2012-11-12 00:00:00.000000000 Z
+date: 2012-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog
-  requirement: !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
+    none: false
+  prerelease: false
+  type: :runtime
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '2.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '2.7'
+    none: false
+  prerelease: false
+  type: :development
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
-description: ! "\t\tThe befog gem allows you to manage your cloud servers\n\t\tdirectly
-  from the command-line. \n"
+    none: false
+  prerelease: false
+  type: :development
+description: ! "\t\tThe befog gem allows you to manage your cloud servers\n\t\tdirectly\
+  \ from the command-line. \n"
 email:
-- 
-- 
-- 
+-
+-
+-
 executables:
 - befog
 extensions: []
 extra_rdoc_files: []
 files:
 - lib/befog/cli.rb
+- lib/befog/commands.rb
 - lib/befog/commands/add.rb
 - lib/befog/commands/configure.rb
 - lib/befog/commands/list.rb
+- lib/befog/commands/remove.rb
+- lib/befog/commands/run.rb
+- lib/befog/commands/start.rb
+- lib/befog/commands/stop.rb
 - lib/befog/commands/mixins/command.rb
 - lib/befog/commands/mixins/configurable.rb
 - lib/befog/commands/mixins/help.rb
@@ -83,36 +88,35 @@ files:
 - lib/befog/commands/mixins/scope.rb
 - lib/befog/commands/mixins/selectable.rb
 - lib/befog/commands/mixins/traceable.rb
-- lib/befog/commands/remove.rb
-- lib/befog/commands/run.rb
-- lib/befog/commands/start.rb
-- lib/befog/commands/stop.rb
-- lib/befog/commands.rb
 - lib/befog.rb
 - bin/befog
+- VERSION
+- AUTHORS
+- Readme.md
 homepage: https://github.com/dyoder/befog
 licenses: []
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+  none: false
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.23
-signing_key: 
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
 specification_version: 3
 summary: Cloud provisioning CLI
 test_files: []
-has_rdoc: 
+has_rdoc:
+...