egads 0.0.1 → 0.0.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    YTY5Zjg1MjIxZjgxYmMxN2QwZTBmYjdkYjUwMjBlMjAwNzRlN2EzMg==
+    NDFlMTY3OGRkMWMxNzAyYjI3ZWRmYWVlYzA1NTk5NDNhZjFmMWIzYQ==
   data.tar.gz: !binary |-
-    MDYyMmIzODJjMzNjY2FiMWRjNzA2OTk0MjA2ZWVmYmJlY2Q5ZjQxMw==
+    YmZmNTIyNDkxYzBkYWQ1YjBmNzIyNmYxZGNhMjcxYTJlOGIxMjllYg==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    NjZjYWJlN2I2M2QyYzIyYzc5MjI4OTY2MWNjZjBkOTJlMDJmODAxYmQ5NTAw
-    YmYxYmE0OTFjZDcwZDgxYTY2YmM3ZjRkZDk4ZWJjZjBhNTM2ODY1MDhkOTcx
-    MTNmNTdhYmE3ZDExNGQ3MDdhYTk1MGYxODZkMWE3OTcwYTliZjk=
+    YzNhOTAxMTNlOTVjODlmZjkxMGUxZjNiMDViYTIwZTU1ZTBmM2MzMDI4OTZm
+    YmI0OTJkMTRmNWQxMTE0YjU5NWE0M2MzNDNlYjRkYWMzYjcyODg1OWU2ZDlk
+    ZTYxNTExMjhiMjE4MTRiYjYzN2YxOGMwOThjZTk4ODgyZmQxMTE=
   data.tar.gz: !binary |-
-    Mzg5ZDM3MjUxMzk5ZGZhYzc5ZGVjOWM1OWIxNWFkZGUzZTdkZmYxZDZjYmQz
-    NDU2YjhlMDkwYmEyODdhN2EzMTNmYmVhZTRmMjI5YWYxOGU3OWFiM2VkZjEz
-    Mjg5ZTlmZjVhZDdkZjU1MjlhODFjMzI3ODE0YzI5Mjc0YzE1ZWI=
+    MTdlNjhjYzBlOWI3Mzc5MTJiZGVmYmNhYzdjZGJiNzBmZDY4N2ZkY2EwMDVh
+    ZWM4ODM4YmQwOGIwOWNkNjUwMDQ5NGQ2NWZlY2UyOTgzNmUyMDIzNDI4ZDA1
+    MTAwYzFiNjk4YTM0ZmQ2MmRmNDdlNWZhMjU4YmVhYjBjOGFjYzM=

data/README.md

@@ -5,9 +5,44 @@
 For local work (building and uploading tarballs), put `egads` in your Gemfile:
 
     # In Gemfile
-    gem 'egads'
+    gem 'egads', require: nil
 
 On remote machines (to which you deploy), `egads` must be in your PATH.
 So install `egads` as a system gem:
 
     sudo gem install egads
+
+## Commands
+
+See `egads -h` for the most robust & up-to-date info. Here's a whirlwind tour.
+
+Egads has two types of commands. *Local* commands run on your development machine or continuous integration environment. *Remote* commands run on deployed servers.
+
+Commands are either *porcelain* commands that you should call directly as part of a typical workflow; or *plumbing* commands that are invoked by porcelain commands, and rarely invoked directly.
+
+### Local commands
+
+* `egads build [SHA]` - makes a deployable tarball of the current commit and upload it to S3 (if missing).
+* `egads upload SHA` - (plumbing, called by `build`) Uploads a pre-built tarball
+
+### Remote commands
+
+* `egads stage SHA` - Prepares an extracted tarball for release: runs bundler, copies config files, etc.
+* `egads release SHA` - Symlinks a staged release to current, restarts services
+* `egads extract SHA` - (plumbing, called by `stage`) Downloads and untars a tarball from S3.
+* `egads clean` - (plumbing, called by `release`) Deletes old releases to free space.
+
+## Configuration
+
+There are two config files:
+
+* `egads.yml` ([example](example/egads.yml)) is in your git repo and tarballs. It has instructions for building, staging, and releasing tarballs.
+* `/etc/egads.yml` ([example](example/egads_remote.yml)) on remote servers has some configuration for downloading and extracting tarballs from S3; and some environment variables that could vary across environments. This file is presumably provisioned by a tool like Chef or Puppet.
+
+## Deploy process
+
+The deploy process is:
+
+* Run `egads build` from a server with a full git checkout (e.g. your local machine). This ensures there's a tarball for the remote servers to download.
+* Run `egads stage SHA` on all the remote servers to download, extract, and configure the SHA for release.
+* Run `egads release SHA` on all the remote servers to symlink the staged SHA to 'current', and restart services.

data/lib/egads/cli.rb

@@ -59,6 +59,7 @@ module Egads
       tarball = S3Tarball.new(sha)
       if !options[:force] && tarball.exists?
         say "Tarball for #{sha} already exists. Pass --force to upload again."
+        return
       end
 
       path = tarball.local_gzipped_path
@@ -79,7 +80,7 @@ module Egads
     desc "extract SHA", "[remote, plumbing] Downloads tarball for SHA from S3 and extracts it to the filesystem"
     method_option :force, type: :boolean, default: false, banner: "Overwrite existing files"
     def extract(sha)
-      dir = RemoteConfig.release_dir
+      dir = RemoteConfig.release_dir(sha)
       path = File.join(dir, "#{sha}.tar.gz")
       tarball = S3Tarball.new(sha, true)
 
@@ -111,7 +112,7 @@ module Egads
     method_option :force, type: :boolean, default: false, banner: "Overwrite existing files"
     def stage(sha)
       invoke(:extract, [sha], options)
-      dir = RemoteConfig.release_dir
+      dir = RemoteConfig.release_dir(sha)
       stage_flag_path = File.join(dir, '.egads-stage-success')
       if options[:force] || !File.exists?(stage_flag_path)
         inside dir do
@@ -139,7 +140,7 @@ module Egads
     method_option :force, type: :boolean, default: false, banner: "Overwrite existing files while staging"
     def release(sha)
       invoke(:stage, [sha], options)
-      dir = RemoteConfig.release_dir
+      dir = RemoteConfig.release_dir(sha)
       inside dir do
         run_hooks_for(:release, :before)
       end

data/lib/egads/version.rb

@@ -1,3 +1,3 @@
 module Egads
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: egads
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Aaron Suggs
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-11 00:00:00.000000000 Z
+date: 2013-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog