cheftacular 2.0.0

data/lib/cheftacular/stateless_actions/client_list.rb

@@ -0,0 +1,89 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def client_list
+      @config['documentation']['stateless_action'] <<  [
+        "`cft client_list` Allows you check the basic information for all the servers setup via chef. " +
+        "Shows the server's short name, its public ip address and roles (run_list) by default.",
+
+        [
+          "    1. `-v` option will make this command display the server's domain name, " +
+          "whether its password is stored on the chef server and what that password is.",
+
+          "    2. `-W|--with-priv` option will make this command display the server's local (private) ip address. " + 
+          "This address is also the server's `local.<SERVER_DNS_NAME>`.",
+
+          "    3. This command is aliased to `client-list` with no arguments or cft prefix."
+        ]
+      ]
+
+      @config['documentation']['application'] << @config['documentation']['stateless_action'].last
+    end
+  end
+
+  class StatelessAction
+    def client_list
+      @config['helper'].cleanup_file_caches('current')
+
+      nodes = @config['getter'].get_true_node_objects(true)
+
+      @config['chef_environments'].each do |env|
+        @config['initializer'].initialize_data_bags_for_environment env, false, ['addresses', 'server_passwords']
+      end
+
+      environments = nodes.map { |n| n.chef_environment }
+
+      environments.uniq.each do |env|
+        next if env == '_default'
+
+        env_nodes = @config['parser'].exclude_nodes(nodes, [{ if: { not_env: env } }])
+        puts "\nFound #{ env_nodes.count } #{ env } nodes:"
+        out = "  #{ 'name'.ljust(22) } #{ 'ip_address'.ljust(21) }"
+        out << "#{ 'private_address'.ljust(21) }"                   if @options['with_private']
+        out << "#{ 'pass?'.ljust(5) } #{ 'domain'.ljust(41) }"      if @options['verbose']
+        out << "#{ 'deploy_password'.ljust(21) }"                   if @options['verbose']
+        out << "run_list"
+
+        puts out
+
+        auth_hash = @config[env]['server_passwords_bag_hash']
+
+        addr_data = @config['getter'].get_addresses_hash env
+
+        env_nodes.each do |node|
+          #client = @ridley.client.find(options['node_name'])
+          out = "  #{ node.chef_id.ljust(22,'_') }_#{ node.public_ipaddress.ljust(20,'_') }"
+
+          if @options['with_private']
+            if addr_data.has_key?(node.public_ipaddress)
+              out << addr_data[node.public_ipaddress]['priv'].ljust(20,'_')
+            else
+              out << ''.ljust(20,'_')
+            end
+          end
+
+          if @options['verbose']
+
+            out << "_" + auth_hash.has_key?("#{ node.public_ipaddress }-deploy-pass").to_s.ljust(5,'_') + "_"
+
+            if addr_data.has_key?(node.public_ipaddress)
+              out << addr_data[node.public_ipaddress]['dn'].ljust(40,'_')
+            else
+              out << ''.ljust(40,'_')
+            end
+
+            if auth_hash.has_key?("#{ node.public_ipaddress }-deploy-pass")
+              out << "_" + auth_hash["#{ node.public_ipaddress }-deploy-pass"]
+            else
+              out << "_" + ''.ljust(@config['cheftacular']['server_password_length'],'_')
+            end
+          end
+
+          out << "_#{ node.run_list.join(', ') }"
+          
+          puts out
+        end
+      end
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/cloud.rb

@@ -0,0 +1,107 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def cloud
+      @config['documentation']['stateless_action'] <<  [
+        "`cft cloud <FIRST_LEVEL_ARG> [<SECOND_LEVEL_ARG>[:<SECOND_LEVEL_ARG_QUERY>]*] ` this command handles talking to various cloud apis. " +
+        "If no args are passed nothing will happen.",
+
+        [
+          "    1. `domain` 1st level argument for interacting with cloud domains",
+
+          "        1. `list` default behavior",
+
+          "        2. `read:TOP_LEVEL_DOMAIN` returns detailed information about all subdomains attached to the TOP_LEVEL_DOMAIN",
+
+          "        3. `read_record:TOP_LEVEL_DOMAIN:QUERY_STRING` queries the top level domain for all subdomains that have the QUERY_STRING in them.",
+
+          "        4. `create:TOP_LEVEL_DOMAIN` creates the top level domain on rackspace",
+
+          "        5. `create_record:TOP_LEVEL_DOMAIN:SUBDOMAIN_NAME:IP_ADDRESS[:RECORD_TYPE[:TTL]]` " + 
+          "IE: `cft cloud domain create:mydomain.com:myfirstserver:1.2.3.4` will create the subdomain 'myfirstserver' on the mydomain.com domain.",
+
+          "        6. `destroy:TOP_LEVEL_DOMAIN` destroys the top level domain and all of its subdomains",
+
+          "        7. `destroy_record:TOP_LEVEL_DOMAIN:SUBDOMAIN_NAME` deletes the subdomain record for TOP_LEVEL_DOMAIN if it exists.",
+
+          "        8. `update:TOP_LEVEL_DOMAIN` takes the value of the email in the authentication data bag for your specified cloud and updates the TLD.",
+
+          "        9. `update_record:TOP_LEVEL_DOMAIN:SUBDOMAIN_NAME:IP_ADDRESS[:RECORD_TYPE[:TTL]]` similar to `create_record`.",
+
+          "    2. `server` 1st level argument for interacting with cloud servers, " +
+          "if no additional args are passed the command will return a list of all servers on the preferred cloud.",
+
+          "        1.  `list` default behavior",
+
+          "        2. `read:SERVER_NAME` returns all servers that have SERVER_NAME in them (you want to be as specific as possible for single matches)",
+
+          "        3. `create:SERVER_NAME:FLAVOR_ALIAS` IE: `cft cloud server \"create:myserver:1 GB Performance\"` " +
+          "will create a server with the name myserver and the flavor \"1 GB Performance\". Please see flavors section.",
+
+          "            1. NOTE! If you forget to pass in a flavor alias the script will not error! It will attempt to create a 512MB Standard Instance!",
+
+          "            2. NOTE! Most flavors have spaces in them, you must use quotes at the command line to utilize them!",
+
+          "        4. `destroy:SERVER_NAME` destroys the server on the cloud. This must be an exact match of the server's actual name or the script will error.",
+
+          "        5. `poll:SERVER_NAME` polls the cloud's server for the status of the SERVER_NAME. " +
+          "This command will stop polling if / when the status of the server is ACTIVE and its build progress is 100%.",
+
+          "        6. `attach_volume:SERVER_NAME:VOLUME_NAME[:VOLUME_SIZE[:DEVICE_LOCATION]]` " +
+          "If VOLUME_NAME exists it will attach it if it is unattached otherwise it will create it",
+
+          "            1. NOTE! If the system creates a volume the default size is 100 GB!",
+
+          "            2. DEVICE_LOCATION refers to the place the volume will be mounted on, a place like `/dev/xvdb`, " +
+          "from here it must be added to the filesystem to be used.",
+
+          "            3. If you want to specify a location, you must specify a size, if the volume already exists it wont be resized but will be attached at that location!",
+
+          "            4. If DEVICE_LOCATION is blank the volume will be attached to the first available slot.",
+
+          "        7. `detach_volume:SERVER_NAME:VOLUME_NAME` Removes the volume from the server if it is attached. " +
+          "If this operation is performed while the volume is mounted it could corrupt the volume! Do not do this unless you know exactly what you're doing!",
+
+          "        8. `list_volumes:SERVER_NAME` lists all volumes attached to a server",
+
+          "        9. `read_volume:SERVER_NAME:VOLUME_NAME` returns the data of VOLUME_NAME if it is attached to the server.",
+
+          "    3. `volume` 1st level argument for interacting with cloud storage volumes, if no additional args are passed the command will return a list of all cloud storage containers.",
+            
+          "        1. `list` default behavior",
+
+          "        2. `read:VOLUME_NAME` returns the details for a specific volume.",
+
+          "        3. `create:VOLUME_NAME:VOLUME_SIZE` IE `cft rax volume create:staging_db:256`",
+
+          "        4. `destroy:VOLUME_NAME` destroys the volume. This operation will not work if the volume is attached to a server.",
+
+          "    4. `flavor` 1st level argument for listing the flavors available on the cloud service",
+
+          "        1. `list` default behavior",
+
+          "        2. `read:FLAVOR SIZE` behaves the same as list unless a flavor size is supplied.",
+
+          "            1. Standard servers are listed as XGB with no spaces in their size, performance servers are listed as X GB with " +
+          "a space in their size. If you are about to create a server and are unsure, query flavors first."
+        ]
+      ]
+    end
+  end
+
+  class StatelessAction
+    def cloud *args
+      raise "This action can only be performed if the mode is set to devops" if !@config['helper'].running_in_mode?('devops') && !@options['in_scaling']
+
+      args = ARGV[1..ARGV.length] if args.empty?
+
+      @config['cloud_interactor'] ||= CloudInteractor.new(@config['default']['authentication_bag_hash'], @options)
+
+      @config['cloud_interactor'].run args
+    end
+
+    alias_method :aws, :cloud
+
+    alias_method :rax, :cloud
+  end
+end

data/lib/cheftacular/stateless_actions/cloud_bootstrap.rb

@@ -0,0 +1,109 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def cloud_bootstrap
+      @config['documentation']['stateless_action'] <<  [
+        "`cft cloud_bootstrap NODE_NAME FLAVOR_NAME [DESCRIPTOR] [--with-dn DOMAIN]` uses a cloud api to " +
+        "create a server and attaches its DOMAIN_NAME to the TLD specified for that environment (IE: example-staging.com for staging)",
+
+        [
+          "    1. If no DOMAIN_NAME is supplied it will use the node's NODE_NAME (IE: api01.example-staging.com)",
+
+          "    2. If the `--with-dn DOMAIN` argument is supplied the rax api will attempt to attach the node to the " +
+          "top level domain instead of the default environment one. This tld must be attached to the cloud service. "+
+          "This also allows you to attach to custom subdomains instead of NODE_NAME.ENV_TLD",
+
+          "    3. `cft cloud_bootstrap myserver \"1 GB Performance\" --with-dn myserver.example-staging.com` " +
+          'The "1 GB Perfomance" does not have to be exact, "1 GB" will match "1 GB Performance" and "1GB" ' +
+          "will match \"1GB Standard\" (for rackspace flavors)",
+
+          "    4. DESCRIPTOR is used as an internal tag for the node, if left blank it will become the name of the node. " +
+          "It is recommended to enter a custom repository-dependent tag here to make nodes easier to load-balance like \"lb:[CODEBASE_NAME]\""
+        ]
+      ]
+    end
+  end
+
+  class StatelessAction
+    def cloud_bootstrap
+      raise "This action can only be performed if the mode is set to devops" if !@config['helper'].running_in_mode?('devops') && !@options['in_scaling']
+      
+      @options['node_name']   = ARGV[1] unless @options['node_name']
+      @options['flavor_name'] = ARGV[2] unless @options['flavor_name']
+      @options['descriptor']  = ARGV[3] if ARGV[3] && !@options['descriptor']
+      full_domain             = ""
+
+      if `which sshpass`.empty?
+        raise "sshpass not installed! Please run brew install https://raw.github.com/eugeneoden/homebrew/eca9de1/Library/Formula/sshpass.rb (or get it from your repo for linux)"
+      end
+
+      #the output of the cloud command is a hash, this hash is UPDATED every time a rax command is run so you only need to grab it when you need it
+      @config['stateless_action'].cloud "server", "create:#{ @options['env'] }_#{ @options['node_name'] }:#{ @options['flavor_name'] }"
+
+      status_hash = @config['stateless_action'].cloud "server", "poll:#{ @options['env'] }_#{ @options['node_name'] }"
+
+      status_hash['created_servers'].each do |server_hash|
+        next unless server_hash['name'] == "#{ @options['env'] }_#{ @options['node_name'] }"
+
+        @options['address'] = server_hash['ipv4_address']
+
+        @options['private_address'] = server_hash['addresses']['private'][0]['addr']
+      end
+
+      begin
+        @options['client_pass'] = status_hash['admin_passwords']["#{ @options['env'] }_#{ @options['node_name'] }"]
+      rescue NoMethodError => e
+        puts "Unable to locate an admin pass for server #{ @options['node_name'] }, does the server already exist? Exiting #{ __method__ }..."
+
+        return false
+      end
+
+      if @options['with_dn']
+        domain_obj = PublicSuffix.parse @options['with_dn']
+
+        @config['stateless_action'].cloud "domain", "create_record:#{ domain_obj.domain }:#{ domain_obj.trd }:#{ @options['address'] }"
+
+        sleep 5
+
+        @config['stateless_action'].cloud "domain", "create_record:#{ domain_obj.domain }:local.#{ domain_obj.trd }:#{ @options['private_address'] }"
+
+        full_domain = @options['with_dn']
+
+        #set the wildcard domain for frontend load balancers
+        @config['stateless_action'].cloud "domain", "create_record:#{ domain_obj.domain }:*:#{ @options['address'] }" if ( @options['node_name'] =~ /mysc.*lb/ ) == 0
+      end
+      
+      tld = @config[@options['env']]['config_bag_hash'][@options['sub_env']]['tld']
+
+      @config['stateless_action'].cloud "domain", "create_record:#{ tld }:#{ @options['node_name'] }:#{ @options['address'] }"
+
+      sleep 5
+
+      @config['stateless_action'].cloud "domain", "create_record:#{ tld }:local.#{ @options['node_name'] }:#{ @options['private_address'] }"
+
+      full_domain = "#{ @options['node_name'] }.#{ tld }" if full_domain.blank?
+
+      @config[@options['env']]['addresses_bag_hash'] = @config[@options['env']]['addresses_bag'].reload.to_hash
+
+      target_serv_index = @config[@options['env']]['addresses_bag_hash']['addresses'].count
+
+      @config[@options['env']]['addresses_bag_hash']['addresses'].each do |serv_hash|
+        target_serv_index = @config[@options['env']]['addresses_bag_hash']['addresses'].index(serv_hash) if serv_hash['name'] == @options['node_name']
+      end
+
+      #EX: "name": "api1", "public": "1.2.3.4", "address": "10.208.1.2", "dn":"api1.example.com", "descriptor": "lb:my-backend-codebase"
+      @config[@options['env']]['addresses_bag_hash']['addresses'][target_serv_index] ||= {}
+      @config[@options['env']]['addresses_bag_hash']['addresses'][target_serv_index]['name']       = @options['node_name']
+      @config[@options['env']]['addresses_bag_hash']['addresses'][target_serv_index]['public']     = @options['address']
+      @config[@options['env']]['addresses_bag_hash']['addresses'][target_serv_index]['address']    = @options['private_address']
+      @config[@options['env']]['addresses_bag_hash']['addresses'][target_serv_index]['dn']         = full_domain
+      @config[@options['env']]['addresses_bag_hash']['addresses'][target_serv_index]['descriptor'] = @options['descriptor'].nil? ? @options['node_name'] : @options['descriptor']
+
+      @config['ChefDataBag'].save_addresses_bag
+
+      @options['dont_remove_address_or_server'] = true #flag to make sure our entry isnt removed in addresses bag
+
+      full_bootstrap #bootstrap server with ruby and attach it to the chef server
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/compile_audit_log.rb

@@ -0,0 +1,60 @@
+class Cheftacular
+  class StatelessActionDocumentation
+    def compile_audit_log
+      @config['documentation']['stateless_action'] <<  [
+        "`cft compile_audit_log [clean]` compiles the audit logs in each environment's " +
+        "audit data bag a audit-log-CURRENTDAY.md file in the log folder of the application. Bear in mind that the bag " +
+        "can only hold 100K bytes and will need to have that data removed to store more than that."
+      ]
+    end
+  end
+
+  class StatelessAction
+    def compile_audit_log out=[]
+      compiled_audit_hash = {}
+
+      @config['chef_environments'].each do |env|
+        @config['initializer'].initialize_data_bags_for_environment env, false, ['audit']
+
+        @config['initializer'].initialize_audit_bag_contents env
+
+        @config[env]['audit_bag_hash']['audit_log'].each_pair do |day, time_log_hash|
+          compiled_audit_hash[day] ||= {}
+          time_log_hash.each_pair do |time, log_array|
+            compiled_audit_hash[day][time] ||= []
+            compiled_audit_hash[day][time] <<  log_array
+          end
+        end
+      end
+
+      compiled_audit_hash.each_pair do |day, time_log_hash|
+        out << "# Audit Log Entries for #{ Date.parse(day) }"
+
+        entry_count, int_times = 1, []
+
+        time_log_hash.keys.each do |time|
+          out << "#{ entry_count }. #{ time }"
+
+          log_array_entry_count = 1
+
+          time_log_hash[time].each do |log_arr|
+            log_arr.each do |log_hash|
+              out << "    #{ log_array_entry_count }. #{ log_hash['command'] }"
+              out << "        1. Hostname:  #{ log_hash['hostname'] }"
+              out << "        2. IPAddress: #{ log_hash['true_ip'] }"
+              out << "        3. Arguments: #{ log_hash['arguments'] }"
+              out << "        4. Options:   #{ log_hash['options'].to_hash }"
+              out << ""
+
+              log_array_entry_count += 1
+            end
+          end if time_log_hash.has_key?(time)
+
+          entry_count += 1
+        end
+      end
+
+      File.open("#{ @config['locs']['chef-log'] }/audit-log-#{ Time.now.strftime("%Y%m%d%H%M%S") }.md", "w") { |f| f.write(out.join("\n")) }
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/compile_readme.rb

@@ -0,0 +1,41 @@
+class Cheftacular
+  class StatelessActionDocumentation
+    def compile_readme
+      @config['documentation']['stateless_action'] <<  [
+        "`cft compile_readme` compiles all documentation methods and creates a README.md file in the log folder of the application."
+      ]
+    end
+  end
+
+  class StatelessAction
+    def compile_readme out=[]
+       @config['action_documentation'].public_methods(false).each do |method|
+         @config['action_documentation'].send(method)
+      end
+
+      @config['stateless_action_documentation'].public_methods(false).each do |method|
+         @config['stateless_action_documentation'].send(method)
+      end
+
+      out << '# Table of Contents for Cheftacular Commands'
+
+      out << '1. [Cheftacular Arguments and Flags](https://github.com/SocialCentivPublic/cheftacular/blob/master/lib/cheftacular/README.md#arguments-and-flags-for-cheftacular))'
+
+      out << '2. [Application Commands](https://github.com/SocialCentivPublic/cheftacular/blob/master/lib/cheftacular/README.md#commands-that-can-be-run-in-the-application-context)'
+
+      out << '3. [DevOps Commands](https://github.com/SocialCentivPublic/cheftacular/blob/master/lib/cheftacular/README.md#commands-that-can-only-be-run-in-the-devops-context))' + "\n"
+      
+      out << @config['documentation']['arguments']
+
+      out << "\n## Commands that can be run in the application context"
+
+      out << @config['helper'].compile_documentation_lines('application')
+
+      out << "\n## Commands that can ONLY be run in the devops context"
+
+      out << @config['helper'].compile_documentation_lines('stateless_action')
+
+      File.open("#{ @config['locs']['chef-log'] }/README.md", "w") { |f| f.write(out.flatten.join("\n\n")) }
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/create_git_key.rb

@@ -0,0 +1,67 @@
+
+#Uploads a private key found in ~/.ssh/id_rsa to an encrypted bag to let the chef-server access private repos.
+class Cheftacular
+  class StatelessActionDocumentation
+    def create_git_key
+      @config['documentation']['stateless_action'] <<  [
+        "`cft create_git_key ID_RSA_FILE [OAUTH_TOKEN]` This command will update the default/authentication data bag with new credentials. " +
+        "The [ID_RSA_FILE](https://help.github.com/articles/generating-ssh-keys) needs to exist beforehand.",
+
+        [
+          "    1. This command will upload both the private and public key to the data bag. " +
+          "The public key should be the one that matches the github user for your deployment github user.",
+
+          "    2. `OAUTH_TOKEN` *must* be generated by logging into github and generating an access token in the account settings -> applications -> personal access tokens"
+        ]
+      ]
+    end
+  end
+
+  class StatelessAction
+    def create_git_key oauth_key=""
+
+      case ARGV[1]
+      when nil      then raise "Too few arguments, please enter the filename of the id_rsa file you want to use"
+      when 'id_rsa' then raise "Sorry, you can't use your default id_rsa"
+      else               key_file = ARGV[1]
+      end
+
+      case ARGV[2]
+      when nil then display_oauth_notice = true
+      else          oauth_key = ARGV[2]
+      end
+
+      data = File.read("#{ @config['locs']['chef'] }/#{ key_file }")
+      data_pub = File.read("#{ @config['locs']['chef'] }/#{ key_file }.pub")
+
+      hash = @config['default']['authentication_bag_hash']
+
+      if h.has_key?('private_key') 
+        puts "Overwrite current git key in default data bag? (Y/y/N/n)"
+        input = STDIN.gets.chomp
+
+        overwrite = (input =~ /Y|y|yes/) == 0
+      else overwrite = true
+      end
+
+      if overwrite
+
+        hash['private_key'] = data
+
+        hash['public_key'] = data_pub
+
+        hash['OAuth'] = oauth_key
+
+        @config['ChefDataBag'].save_authentication_bag
+
+        if oauth_key.blank?
+          puts "REMEMBER! You need to put a OAuth token into this data bag item!"
+          puts "You need to go to github and get the auth_token for the hiplogiq deploy user!"
+          puts "Copy the key and paste it inbetween the quotes.\n"
+          puts "\"Oauth\": \"<PASTE YOUR OAUTH KEY HERE>\"\n\n"
+          puts "Please run \nknife data bag edit default authentication --secret-file #{ @config['locs']['chef'] }/#{ @config['cheftacular']['data_bag_key_file'] }\n"
+        end
+      end
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/disk_report.rb

@@ -0,0 +1,75 @@
+class Cheftacular
+  class StatelessActionDocumentation
+    def disk_report
+      @config['documentation']['stateless_action'] <<  [
+        "`cft disk_report` will fetch useful statistics from every server for every environment and output it into your log directory."
+      ]
+
+      @config['documentation']['application'] << @config['documentation']['stateless_action'].last
+    end
+  end
+
+  class StatelessAction
+    def disk_report disk_hash={}, out=[]
+      
+      nodes = @config['getter'].get_true_node_objects(true)
+
+      nodes = @config['parser'].exclude_nodes( nodes, [{ if: { env: '_default' }}] )
+
+      @config['chef_environments'].each do |env|
+        @config['initializer'].initialize_data_bags_for_environment env, false, ['addresses', 'server_passwords']
+
+        @config['initializer'].initialize_passwords env
+      end
+
+      options, locs, ridley, logs_bag_hash, pass_bag_hash, bundle_command, cheftacular, passwords = @config['helper'].set_local_instance_vars
+
+      on ( nodes.map { |n| "deploy@" + n.public_ipaddress } ), in: :groups, limit: 5, wait: 2 do |host|
+        n = get_node_from_address(nodes, host.hostname)
+
+        puts "Beginning disk report run for #{ n.name } (#{ n.public_ipaddress })"
+
+        disk_hash[n.name] = start_disk_report( n.name, n.public_ipaddress, options, locs, passwords)
+      end
+
+      disk_hash.each_pair do |serv_name, output|
+        out << "#{ serv_name }:"
+
+        line_count = 1
+
+        output.join("\n").split("\n").each do |line|
+          out << line_count == 1 ? "               #{ line }" : "  #{ line }"
+
+          line_count += 1
+        end
+
+        out << "\n"
+      end
+
+      puts(out) if @options['no_logs'] || @options['verbose']
+
+      log_loc, timestamp = @config['helper'].set_log_loc_and_timestamp
+
+      puts("Generating log file for disk report at #{ log_loc }/disk-report-#{ timestamp }.txt") unless @options['quiet']
+
+      File.open("#{ log_loc }/disk-report-#{ timestamp }.txt", "w") { |f| f.write(out.join("\n").scrub_pretty_text) } unless @options['no_logs']
+    end
+  end
+end
+
+module SSHKit
+  module Backend
+    class Netssh
+      def start_disk_report name, ip_address, options, locs, passwords, out=[]
+
+        out << sudo_capture( passwords[ip_address], :free, '-m' )
+        out << "\n"
+        out << sudo_capture( passwords[ip_address], :df, '-aTh' )
+
+        puts(out.join("\n")) if options['output'] || options['verbose']
+
+        out
+      end
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/environment.rb

@@ -0,0 +1,100 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def environment
+      @config['documentation']['stateless_action'] <<  [
+        "`cft environment boot|destroy` will boot / destroy the current environment",
+
+        [
+          "    1. `boot` will spin up servers and bring them to a stable state. " +
+          "This includes setting up their subdomains for the target environment.",
+
+          "    2. `destroy` will destroy all servers needed for the target environment",
+
+          "    3. This command will prompt when attempting to destroy servers in staging or production"
+        ]
+      ]
+
+      @config['documentation']['application'] << @config['documentation']['stateless_action'].last
+    end
+  end
+
+  class StatelessAction
+    def environment type="boot", ask_on_destroy=false, remove=true
+      ask_on_destroy = case @options['env']
+                       when 'staging'    then true
+                       when 'production' then true
+                       else                   false
+                       end
+
+      type = ARGV[1] if ARGV[1]
+
+      raise "Unknown type: #{ type }, can only be 'boot' or 'destroy'" unless (type =~ /boot|destroy/) == 0
+
+      nodes = @config['getter'].get_true_node_objects(true)
+
+      nodes = @config['parser'].exclude_nodes( nodes, [{ unless: { env: @options['env'] }}])
+
+      @options['force_yes']  = true
+      @options['in_scaling'] = true
+
+      initial_servers = @config['cheftacular']['env_boot_nodes']["#{ @options['env'] }_node_names"]
+
+      if initial_servers.empty?
+        puts "There are no servers defined for #{ @options['env'] } in the env_boot_nodes hash in your cheftacular.yml... Exiting"
+
+        exit
+      end
+
+      case type
+      when 'boot'
+        initial_servers.each_pair do |name, config_hash|
+          @options['node_name']   = name
+          @options['flavor_name'] = config_hash.has_key?('flavor') ? config_hash['flavor'] : @config['cheftacular']['default_flavor_name']
+          @options['descriptor']  = config_hash.has_key?('descriptor') ? config_hash['descriptor'] : name
+          @options['with_dn']     = config_hash.has_key?('dns_config') ? @config['parser'].parse_to_dns(config_hash['dns_config']) : @config['parser'].parse_to_dns('NODE_NAME.ENV_TLD')
+                                    
+          next if nodes.map { |n| n.name }.include?(@options['node_name'])
+
+          puts("Preparing to boot server #{ @options['node_name'] } for #{ @options['env'] }!") unless @options['quiet']
+
+          @config['stateless_action'].cloud_bootstrap
+
+          sleep 15
+        end
+
+        @config['ChefDataBag'].save_server_passwords_bag
+
+        @options['node_name'] = nil
+
+        @options['role'] = 'all'
+
+        @config['action'].deploy
+
+        #TODO INTEGRATE backups TO LOAD DATA INTO THE NEWLY BOOTED ENV
+      when 'destroy'
+        if ask_on_destroy
+          puts "Preparing to delete nodes in #{ @options['env'] }.\nEnter Y/y to confirm."
+
+          input = STDIN.gets.chomp
+
+          remove = false unless ( input =~ /y|Y|yes|Yes/ ) == 0
+        end
+
+        return false unless remove
+
+        @options['delete_server_on_remove'] = true
+
+        nodes.each do |node|
+          @options['node_name'] = node.name
+
+          puts("Preparing to destroy server #{ @options['node_name'] } for #{ @options['env'] }!") unless @options['quiet']
+
+          @config['stateless_action'].remove_client
+
+          sleep 15
+        end
+      end
+    end
+  end
+end