rhc 1.6.8 → 1.7.8

data/lib/rhc/commands/cartridge.rb

@@ -5,35 +5,57 @@ module RHC::Commands
   class Cartridge < Base
     summary "Manage your application cartridges"
     syntax "<action>"
+    description <<-DESC
+      Cartridges add functionality to OpenShift applications.  Each application
+      has one web cartridge to listen for HTTP requests, and any number
+      of addon cartridges.  Addons may include databases like MySQL and Mongo,
+      administrative tools like phpMyAdmin, or build clients like Jenkins.
+
+      Most cartridges that listen for incoming network traffic are placed on
+      one or more gears (a small server instance).  Other cartridges may be
+      available across all of the gears of an application to listen for changes
+      (like Jenkins) or provide environment variables.
+
+      Use the 'cartridges' command to see a list of all available cartridges.
+      Add a new cartridge to your application with 'add-cartridge'.
+
+      For scalable applications, use the 'cartridge-scale' command on the web
+      cartridge to set the minimum and maximum scale.
+
+      Commands that affect a cartridge within an application will affect all
+      gears the cartridge is installed to.
+      DESC
     alias_action :"app cartridge", :root_command => true, :deprecated => true
     default_action :list
 
     summary "List available cartridges"
     option ["-v", "--verbose"], "Display more details about each cartridge"
     alias_action :"app cartridge list", :root_command => true, :deprecated => true
+    alias_action :"cartridges", :root_command => true
     def list
       carts = rest_client.cartridges.sort_by{ |c| "#{c.type == 'standalone' && 1}_#{c.tags.include?('experimental') ? 1 : 0}_#{(c.display_name || c.name).downcase}" }
 
-      list = if options.verbose
-        carts.map do |c|
-          name = c.display_name != c.name && "#{color(c.display_name, :cyan)} [#{c.name}]" || c.name
-          tags = c.tags - RHC::Rest::Cartridge::HIDDEN_TAGS
-          [
-            underline("#{name} (#{c.only_in_new? ? 'web' : 'addon'})"),
-            c.description,
-            tags.present? ? "\nTagged with: #{tags.sort.join(', ')}" : nil,
-            c.usage_rate? ? "\n#{format_usage_message(c)}" : nil,
-          ].compact << "\n"
-        end.flatten
+      pager
+
+      if options.verbose
+        carts.each do |c|
+          paragraph do
+            name = c.display_name != c.name && "#{color(c.display_name, :cyan)} [#{c.name}]" || c.name
+            tags = c.tags - RHC::Rest::Cartridge::HIDDEN_TAGS
+            say header([name, "(#{c.only_in_new? ? 'web' : 'addon'})"])
+            say c.description
+            paragraph{ say "Tagged with: #{tags.sort.join(', ')}" } if tags.present?
+            paragraph{ say format_usage_message(c) } if c.usage_rate?
+          end
+        end
       else
-        table(carts.collect do |c|
+        say table(carts.collect do |c|
           [c.usage_rate? ? "#{c.name} (*)" : c.name,
            c.display_name,
            c.only_in_new? ? 'web' : 'addon']
         end)
       end
 
-      say list.join("\n")
       paragraph{ say "Note: Web cartridges can only be added to new applications." }
       paragraph{ say "(*) denotes a cartridge with additional usage costs." } if carts.any? { |c| c.usage_rate? }
 
@@ -41,9 +63,9 @@ module RHC::Commands
     end
 
     summary "Add a cartridge to your application"
-    syntax "<cartridge_type> [--namespace namespace] [--app app]"
-    option ["-n", "--namespace namespace"], "Namespace of the application you are adding the cartridge to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application you are adding the cartridge to", :context => :app_context, :required => true
+    syntax "<cartridge_type> [--namespace NAME] [--app NAME]"
+    option ["-n", "--namespace NAME"], "Namespace of the application you are adding the cartridge to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application you are adding the cartridge to", :context => :app_context, :required => true
     argument :cart_type, "The type of the cartridge you are adding (run 'rhc cartridge list' to obtain a list of available cartridges)", ["-c", "--cartridge cart_type"]
     alias_action :"app cartridge add", :root_command => true, :deprecated => true
     def add(cart_type)
@@ -66,9 +88,9 @@ module RHC::Commands
     end
 
     summary "Show useful information about a cartridge"
-    syntax "<cartridge> [--namespace namespace] [--app app]"
-    option ["-n", "--namespace namespace"], "Namespace of the application you are adding the cartridge to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application you are adding the cartridge to", :context => :app_context, :required => true
+    syntax "<cartridge> [--namespace NAME] [--app NAME]"
+    option ["-n", "--namespace NAME"], "Namespace of the application you are adding the cartridge to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application you are adding the cartridge to", :context => :app_context, :required => true
     argument :cartridge, "The name of the cartridge", ["-c", "--cartridge cart_type"]
     def show(cartridge)
       rest_app = rest_client.find_application(options.namespace, options.app, :include => :cartridges)
@@ -80,10 +102,10 @@ module RHC::Commands
     end
 
     summary "Remove a cartridge from your application"
-    syntax "<cartridge> [--namespace namespace] [--app app]"
+    syntax "<cartridge> [--namespace NAME] [--app NAME]"
     argument :cartridge, "The name of the cartridge you are removing", ["-c", "--cartridge cartridge"]
-    option ["-n", "--namespace namespace"], "Namespace of the application you are removing the cartridge from", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application you are removing the cartridge from", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application you are removing the cartridge from", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application you are removing the cartridge from", :context => :app_context, :required => true
     option ["--confirm"], "Pass to confirm removing the cartridge"
     alias_action :"app cartridge remove", :root_command => true, :deprecated => true
     def remove(cartridge)
@@ -100,10 +122,10 @@ module RHC::Commands
     end
 
     summary "Start a cartridge"
-    syntax "<cartridge> [--namespace namespace] [--app app]"
+    syntax "<cartridge> [--namespace NAME] [--app NAME]"
     argument :cart_type, "The name of the cartridge you are stopping", ["-c", "--cartridge cartridge"]
-    option ["-n", "--namespace namespace"], "Namespace of the application the cartrdige belongs to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application the cartridge", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application the cartrdige belongs to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application the cartridge", :context => :app_context, :required => true
     alias_action :"app cartridge start", :root_command => true, :deprecated => true
     def start(cartridge)
       cartridge_action(cartridge, :start){ |_, c| results{ say "#{c.name} started" } }
@@ -111,10 +133,10 @@ module RHC::Commands
     end
 
     summary "Stop a cartridge"
-    syntax "<cartridge> [--namespace namespace] [--app app]"
+    syntax "<cartridge> [--namespace NAME] [--app NAME]"
     argument :cart_type, "The name of the cartridge you are stopping", ["-c", "--cartridge cartridge"]
-    option ["-n", "--namespace namespace"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application you the cartridge belongs to", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application you the cartridge belongs to", :context => :app_context, :required => true
     alias_action :"app cartridge stop", :root_command => true, :deprecated => true
     def stop(cartridge)
       cartridge_action(cartridge, :stop){ |_, c| results{ say "#{c.name} stopped" } }
@@ -122,10 +144,10 @@ module RHC::Commands
     end
 
     summary "Restart a cartridge"
-    syntax "<cartridge_type> [--namespace namespace] [--app app]"
+    syntax "<cartridge_type> [--namespace NAME] [--app NAME]"
     argument :cart_type, "The name of the cartridge you are restarting", ["-c", "--cartridge cartridge"]
-    option ["-n", "--namespace namespace"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application the cartridge belongs to", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application the cartridge belongs to", :context => :app_context, :required => true
     alias_action :"app cartridge restart", :root_command => true, :deprecated => true
     def restart(cartridge)
       cartridge_action(cartridge, :restart){ |_, c| results{ say "#{c.name} restarted" } }
@@ -133,10 +155,10 @@ module RHC::Commands
     end
 
     summary "Get current the status of a cartridge"
-    syntax "<cartridge> [--namespace namespace] [--app app]"
+    syntax "<cartridge> [--namespace NAME] [--app NAME]"
     argument :cart_type, "The name of the cartridge you are getting the status of", ["-c", "--cartridge cartridge"]
-    option ["-n", "--namespace namespace"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application the cartridge belongs to", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application the cartridge belongs to", :context => :app_context, :required => true
     alias_action :"app cartridge status", :root_command => true, :deprecated => true
     def status(cartridge)
       rest_app = rest_client.find_application(options.namespace, options.app, :include => :cartridges)
@@ -146,10 +168,10 @@ module RHC::Commands
     end
 
     summary "Reload the cartridge's configuration"
-    syntax "<cartridge> [--namespace namespace] [--app app]"
+    syntax "<cartridge> [--namespace NAME] [--app NAME]"
     argument :cart_type, "The name of the cartridge you are reloading", ["-c", "--cartridge cartridge"]
-    option ["-n", "--namespace namespace"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application the cartridge belongs to", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application the cartridge belongs to", :context => :app_context, :required => true
     alias_action :"app cartridge reload", :root_command => true, :deprecated => true
     def reload(cartridge)
       cartridge_action(cartridge, :reload){ |_, c| results{ say "#{c.name} reloaded" } }
@@ -157,10 +179,10 @@ module RHC::Commands
     end
 
     summary "Set the scaling range of a cartridge"
-    syntax "<cartridge> [--namespace namespace] [--app app] [--min min] [--max max]"
+    syntax "<cartridge> [--namespace NAME] [--app NAME] [--min min] [--max max]"
     argument :cart_type, "The name of the cartridge you are reloading", ["-c", "--cartridge cartridge"]
-    option ["-n", "--namespace namespace"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application the cartridge belongs to", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application the cartridge belongs to", :context => :app_context, :required => true
     option ["--min min", Integer], "Minimum scaling value"
     option ["--max max", Integer], "Maximum scaling value"
     def scale(cartridge)
@@ -185,10 +207,10 @@ module RHC::Commands
     end
 
     summary 'View/manipulate storage on a cartridge'
-    syntax '<cartridge> -a app [--show] [--add|--remove|--set amount] [--namespace namespace]'
+    syntax '<cartridge> -a app [--show] [--add|--remove|--set amount] [--namespace NAME]'
     argument :cart_type, "The name of the cartridge", ["-c", "--cartridge cart_type"], :arg_type => :list
-    option ["-n", "--namespace namespace"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
-    option ["-a", "--app app"], "Application the cartridge belongs to", :context => :app_context, :required => true
+    option ["-n", "--namespace NAME"], "Namespace of the application the cartridge belongs to", :context => :namespace_context, :required => true
+    option ["-a", "--app NAME"], "Application the cartridge belongs to", :context => :app_context, :required => true
     option ["--show"], "Show the current base and additional storage capacity"
     option ["--add amount"], "Add the indicated amount to the additional storage capacity"
     option ["--remove amount"], "Remove the indicated amount from the additional storage capacity"
@@ -196,7 +218,7 @@ module RHC::Commands
     option ["-f", "--force"], "Force the action"
     def storage(cartridge)
       cartridges = Array(cartridge)
-      rest_app = rest_client.find_application(options.namespace, options.app, :include => :cartridges)
+      rest_app = rest_client(:min_api => 1.3).find_application(options.namespace, options.app, :include => :cartridges)
 
       # Pull the desired action
       #

data/lib/rhc/commands/domain.rb

@@ -2,13 +2,24 @@ require 'rhc/commands/base'
 
 module RHC::Commands
   class Domain < Base
-    summary "Manage the domain and namespace for your applications."
+    summary "Add or rename the container for your apps"
     syntax "<action>"
+    description <<-DESC
+      OpenShift groups applications within a domain.  Each domain has a namespace value
+      that will be used as part of the public URL for an application.
+
+      For example, when creating a domain with the namespace "test", any applications 
+      created in that domain will have the public URL:
+
+        http://<appname>-test.rhcloud.com
+
+      Today, each account may have a single domain.
+      DESC
     default_action :show
 
     summary "Define a namespace for your applications to share."
     syntax "<namespace>"
-    argument :namespace, "Namespace for your application(s) (alphanumeric)", ["-n", "--namespace namespace"]
+    argument :namespace, "Namespace for your application(s) (alphanumeric)", ["-n", "--namespace NAME"]
     def create(namespace)
       paragraph { say "Creating domain with namespace '#{namespace}'" }
       rest_client.add_domain(namespace)
@@ -24,8 +35,8 @@ module RHC::Commands
     summary "Change current namespace (will change application urls)"
     syntax "<old namespace> <new namespace>"
     argument :old_namespace, "Old namespace to change", []
-    argument :new_namespace, "New namespace to change", ["-n", "--namespace namespace"]
-    alias_action :alter
+    argument :new_namespace, "New namespace to change", ["-n", "--namespace NAME"]
+    alias_action :alter, :deprecated => true
     def update(old_namespace, new_namespace)
       domain = rest_client.find_domain(old_namespace)
 
@@ -73,12 +84,12 @@ module RHC::Commands
 
     summary "Deletes your domain."
     syntax "<namespace>"
-    argument :namespace, "Namespace you wish to destroy", ["-n", "--namespace namespace"]
-    alias_action :destroy
+    argument :namespace, "Namespace you wish to destroy", ["-n", "--namespace NAME"]
+    alias_action :destroy, :deprecated => true
     def delete(namespace)
       domain = rest_client.find_domain namespace
 
-      say "Deleting domain '#{namespace}'"
+      say "Deleting domain '#{namespace}' ... "
 
       begin
         domain.destroy
@@ -86,7 +97,8 @@ module RHC::Commands
         raise RHC::Exception.new("Domain contains applications. Delete applications first.", 128)
       end
 
-      results { say "Success!" }
+      success "deleted"
+      
       0
     end
   end

data/lib/rhc/commands/git_clone.rb

@@ -7,10 +7,10 @@ module RHC::Commands
     description "This is a convenience wrapper for 'git clone' with the added",
                 "benefit of adding configuration data such as the application's",
                 "UUID to the local repository.  It also automatically",
-                "figures out the git url from the application name so you don't",
+                "figures out the Git url from the application name so you don't",
                 "have to look it up."
-    syntax "<app> [--namespace namespace]"
-    option ["-n", "--namespace namespace"], "Namespace of the application", :context => :namespace_context, :required => true
+    syntax "<app> [--namespace NAME]"
+    option ["-n", "--namespace NAME"], "Namespace of the application", :context => :namespace_context, :required => true
     option ["-r", "--repo dir"], "Path to the Git repository (defaults to ./$app_name)"
     argument :app, "The application you wish to clone", ["-a", "--app name"]
     alias_action 'app git-clone', :deprecated => true, :root_command => true

data/lib/rhc/commands/logout.rb

@@ -0,0 +1,51 @@
+module RHC::Commands
+  class Logout < Base
+    suppress_wizard
+
+    summary "End the current session"
+    description <<-DESC
+      Logout ends your current session on the server and then removes
+      all of the local session files.  If you are using multiple 
+      servers and configurations this will remove all of your local
+      session files.
+
+      The --all option will terminate all authorizations on your
+      account. Any previously generated authorizations will be
+      deleted and external tools that integrate with your account
+      will no longer be able to log in.
+      DESC
+    option '--all', "Remove all authorizations on your account."
+    alias_action 'account logout', :root_command => true
+    def run
+      if options.all
+        rest_client.user # force authentication
+        say "Deleting all authorizations associated with your account ... "
+        begin
+          rest_client.delete_authorizations
+          success "done"
+        rescue RHC::Rest::AuthorizationsNotSupported
+          info "not supported"
+        end
+      elsif token_for_user
+        options.noprompt = true
+        say "Ending session on server ... "
+        begin
+          rest_client.delete_authorization(token_for_user)
+          success "deleted"
+        rescue RHC::Rest::AuthorizationsNotSupported
+          info "not supported"
+        rescue RHC::Rest::TokenExpiredOrInvalid
+          info "already closed"
+        rescue => e
+          debug_error(e)
+          warn e.message
+        end
+      end
+
+      0
+    ensure
+      token_store.clear
+      success "All local sessions removed."
+    end
+  end
+end

data/lib/rhc/commands/port_forward.rb

@@ -70,8 +70,8 @@ module RHC::Commands
 
     summary "Forward remote ports to the workstation"
     syntax "<application>"
-    option ["-n", "--namespace namespace"], "Namespace of the application you are port forwarding to", :context => :namespace_context, :required => true
-    argument :app, "Application you are port forwarding to (required)", ["-a", "--app app"]
+    option ["-n", "--namespace NAME"], "Namespace of the application you are port forwarding to", :context => :namespace_context, :required => true
+    argument :app, "Application you are port forwarding to (required)", ["-a", "--app NAME"]
     def run(app)
       rest_app = rest_client.find_application(options.namespace, app)
 
@@ -81,7 +81,7 @@ module RHC::Commands
       forwarding_specs = []
 
       begin
-        say "Checking available ports..."
+        say "Checking available ports ... "
 
         Net::SSH.start(ssh_uri.host, ssh_uri.user) do |ssh|
           ssh.exec! "rhc-list-ports" do |channel, stream, data|
@@ -119,9 +119,11 @@ module RHC::Commands
             end
           end
 
+          success "done"
+
           begin
             Net::SSH.start(ssh_uri.host, ssh_uri.user) do |ssh|
-              say "Forwarding ports"
+              say "Forwarding ports ..."
               forwarding_specs.each do |fs|
                 given_up = nil
                 while !fs.bound? && !given_up
@@ -141,13 +143,15 @@ module RHC::Commands
 
               bound_ports = forwarding_specs.select(&:bound?)
               if bound_ports.length > 0
-                paragraph {
-                  say "To connect to a service running on OpenShift, use the Local address"
-                }
-                items = bound_ports.map do |fs|
-                  [fs.service, "#{fs.host_from}:#{fs.port_from}", " => ", "#{fs.remote_host}:#{fs.port_to.to_s}"]
+                paragraph{ say "To connect to a service running on OpenShift, use the Local address" }
+                paragraph do
+                  say table(
+                        bound_ports.map do |fs|
+                          [fs.service, "#{fs.host_from}:#{fs.port_from}", " => ", "#{fs.remote_host}:#{fs.port_to.to_s}"]
+                        end, 
+                        :header => ["Service", "Local", "    ", "OpenShift"]
+                      )
                 end
-                table(items, :header => ["Service", "Local", "    ", "OpenShift"]).each { |s| success "  #{s}" }
               end
 
               # for failed port forwarding attempts
@@ -167,7 +171,7 @@ module RHC::Commands
               ssh.loop { true }
             end
           rescue Interrupt
-            results { say "Ending port forward" }
+            say " Ending port forward"
             return 0
           end
 

data/lib/rhc/commands/setup.rb

@@ -23,11 +23,36 @@ module RHC::Commands
 
       If the server supports authorization tokens, you may pass the 
       --create-token option to instruct the wizard to generate a key for you.
+
+      If you would like to enable tab-completion in Bash shells, pass 
+      --autocomplete for more information.
       DESC
     option ["--server NAME"], "Hostname of an OpenShift server", :context => :server_context, :required => true
     option ['--clean'], "Ignore any saved configuration options"
     option ['--[no-]create-token'], "Create an authorization token for this server"
+    option ['--autocomplete'], "Instructions for enabling tab-completion"
     def run
+      if options.autocomplete
+        src = File.join(File.join(Gem.loaded_specs['rhc'].full_gem_path, "autocomplete"), "rhc_bash")
+        dest = File.join(RHC::Config.home_conf_dir, "bash_autocomplete")
+        
+        FileUtils.mkdir_p(RHC::Config.home_conf_dir)
+        FileUtils.cp(src, dest)
+
+        say <<-LINE.strip_heredoc
+          To enable tab-completion for RHC under Bash shells, add the following command to
+          your .bashrc or .bash_profile file:
+
+            . #{dest}
+
+          Save your shell and then restart. Type "rhc" and then hit the TAB key twice to 
+          trigger completion of your command.
+
+          Tab-completion is not available in the Windows terminal.
+          LINE
+        return 0
+      end
+
       raise OptionParser::InvalidOption, "Setup can not be run with the --noprompt option" if options.noprompt
       RHC::RerunWizard.new(config, options).run ?  0 : 1
     end

data/lib/rhc/commands/snapshot.rb

@@ -4,14 +4,24 @@ module RHC::Commands
   class Snapshot < Base
     summary "Save the current state of your application locally"
     syntax "<action>"
+    description <<-DESC
+      Snapshots allow you to export the current state of your OpenShift application
+      into an archive on your local system, and then to restore it later.
+
+      The snapshot archive contains the Git repository, dumps of any attached databases,
+      and any other information that the cartridges decide to export.
+
+      WARNING: Both 'save' and 'restore' will stop the application and then restart
+      after the operation completes.
+      DESC
     alias_action :"app snapshot", :root_command => true
     default_action :help
 
-    summary "Pull down application snapshot for the specified application."
-    syntax "<application>"
-    option ["-n", "--namespace namespace"], "Namespace of the application you are saving a snapshot", :context => :namespace_context, :required => true
-    option ["-f", "--filepath filepath"], "Local path to save tarball (default: ./$APPNAME.tar.gz)"
-    argument :app, "Application you are saving a snapshot (required)", ["-a", "--app app"]
+    summary "Save a snapshot of your app to disk"
+    syntax "<application> [--filepath FILE]"
+    option ["-n", "--namespace NAME"], "Namespace of the application you are saving a snapshot", :context => :namespace_context, :required => true
+    option ["-f", "--filepath FILE"], "Local path to save tarball (default: ./$APPNAME.tar.gz)"
+    argument :app, "Application you are saving a snapshot", ["-a", "--app NAME"]
     alias_action :"app snapshot save", :root_command => true, :deprecated => true
     def save(app)
       rest_app = rest_client.find_application(options.namespace, app)
@@ -52,11 +62,11 @@ module RHC::Commands
       0
     end
 
-    summary "Restores a previously saved snapshot."
-    syntax "<application>"
-    option ["-n", "--namespace namespace"], "Namespace of the application you are restoring a snapshot", :context => :namespace_context, :required => true
-    option ["-f", "--filepath filepath"], "Local path to restore tarball"
-    argument :app, "Application of which you are restoring a snapshot (required)", ["-a", "--app app"]
+    summary "Restores a previously saved snapshot"
+    syntax "<application> [--filepath FILE]"
+    option ["-n", "--namespace NAME"], "Namespace of the application you are restoring a snapshot", :context => :namespace_context, :required => true
+    option ["-f", "--filepath FILE"], "Local path to restore tarball"
+    argument :app, "Application of which you are restoring a snapshot", ["-a", "--app NAME"]
     alias_action :"app snapshot restore", :root_command => true, :deprecated => true
     def restore(app)