cheftacular 2.5.0 → 2.6.0

data/lib/cheftacular/stateless_actions/cloud.rb

@@ -83,7 +83,35 @@ class Cheftacular
           "        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."
+          "a space in their size. If you are about to create a server and are unsure, query flavors first.",
+
+          "    5. `image` first level argument for listing the images available on the cloud service",
+
+          "        1. `list` default behavior",
+
+          "        2. `read:NAME` behaves the same as list unless a specific image name is supplied",
+
+          "    6. `region` first level argument for listing the regions available on the cloud service (only supported by DigitalOcean)",
+
+          "        1. `list` default behavior",
+
+          "        2. `read:REGION` behaves the same as list unless a specific region name is supplied",
+
+          "    7. `sshkey` first level argument for listing the sshkeys added to the cloud service (only supported by DigitalOcean)",
+
+          "        1. `list` default behavior",
+
+          "        2. `read:KEY_NAME` behaves the same as list unless a specific sshkey name is supplied",
+
+          "        3. `\"create:KEY_NAME:KEY_STRING\"` creates an sshkey object. KEY_STRING must contain the entire value of the ssh public key file. " +
+          "The command must be enclosed in quotes.",
+
+          "        4. `destroy:KEY_NAME` destroys the sshkey object",
+
+          "        5. `bootstrap` captures the current computer's hostname and checks to see if a key matching this hostname exists on the cloud service. " +
+          "If the key does not exist, the command attempts to read the contents of the ~/.ssh/id_rsa.pub file and create a new key with that data and the " +
+          "hostname of the current computer. Run automatically when creating DigitalOcean servers. It's worth noting that if the computer's key already " +
+          "exists on DigitalOcean under a different name, this specific command will fail with a generic error. Please check your keys."
         ]
       ]
     end
@@ -95,7 +123,7 @@ class Cheftacular
 
       args = ARGV[1..ARGV.length] if args.empty?
 
-      @config['cloud_interactor'] ||= CloudInteractor.new(@config['default']['authentication_bag_hash'], @options)
+      @config['cloud_interactor'] ||= CloudInteractor.new(@config['cheftacular'], @options)
 
       @config['cloud_interactor'].run args
     end

data/lib/cheftacular/stateless_actions/cloud_bootstrap.rb

@@ -36,26 +36,20 @@ class Cheftacular
         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
 
+      real_node_name = @config['getter'].get_current_real_node_name
+
       #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'] }"
+      @config['stateless_action'].cloud "server", "create:#{ real_node_name }:#{ @options['flavor_name'] }"
 
-      status_hash = @config['stateless_action'].cloud "server", "poll:#{ @options['env'] }_#{ @options['node_name'] }"
+      status_hash = @config['stateless_action'].cloud "server", "poll:#{ real_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']
+        next unless server_hash['name'] == "#{ real_node_name }"
 
-        @options['private_address'] = server_hash['addresses']['private'][0]['addr']
+        @options['address'], @options['private_address'] = @config['cloud_provider'].parse_addresses_from_server_create_hash server_hash
       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
+      @options['client_pass'] = @config['cloud_provider'].parse_server_root_password_from_server_create_hash status_hash, real_node_name
 
       tld = @config[@options['env']]['config_bag_hash'][@options['sub_env']]['tld']
 

data/lib/cheftacular/stateless_actions/compile_audit_log.rb

@@ -32,7 +32,7 @@ class Cheftacular
 
         entry_count, int_times = 1, []
 
-        compiled_audit_hash[day].keys.each do |time|
+        compiled_audit_hash[day].keys.sort.each do |time|
           out << "#{ entry_count }. #{ time }"
 
           log_array_entry_count = 1

data/lib/cheftacular/stateless_actions/create_git_key.rb

@@ -9,7 +9,9 @@ class Cheftacular
           "    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"
+          "    2. `OAUTH_TOKEN` *must* be generated by logging into github and generating an access token in the account settings -> applications -> personal access tokens",
+
+          "    3. NOTE! The ID_RSA_FILE should be in your .chef folder in the root of your home directory!"
         ]
       ]
     end

data/lib/cheftacular/stateless_actions/environment.rb

@@ -73,6 +73,8 @@ class Cheftacular
 
         #TODO INTEGRATE backups TO LOAD DATA INTO THE NEWLY BOOTED ENV
       when 'destroy'
+        raise "This action can only be performed if the mode is set to devops" if !@config['helper'].running_in_mode?('devops')
+        
         if ask_on_destroy
           puts "Preparing to delete nodes in #{ @options['env'] }.\nEnter Y/y to confirm."
 

data/lib/cheftacular/stateless_actions/file.rb

@@ -126,9 +126,11 @@ class Cheftacular
         target_loc = "#{ location }/#{ file_name }"
         puts("Beginning #{ command } run on #{ target_loc } for #{ n.name } (#{ n.public_ipaddress })") unless @options['quiet']
 
-        download_location = @options['save_to_file'] ? @options['save_to_file'] : "#{ @config['locs']['chef-log'] }/#{ file_name }"
+        download_location = @options['save_to_file'] ? @options['save_to_file'] : "#{ @config['locs']['chef-log'] }/#{ file_name.split('/').last }"
 
         `scp -oStrictHostKeyChecking=no #{ @config['cheftacular']['deploy_user'] }@#{ n.public_ipaddress }:#{ location }/#{ file_name } #{ download_location } > /dev/tty`
+
+        puts "Finished downloading #{ file_name } to #{ download_location }!"
       end
     end
   end
@@ -181,4 +183,4 @@ module SSHKit
       end
     end
   end
-end
+end

data/lib/cheftacular/stateless_actions/fix_known_hosts.rb

@@ -42,11 +42,12 @@ class Cheftacular
       end
 
       targets.each do |target|
+        puts "clearing #{ target }"
         case CONFIG['host_os']
         when /mswin|windows/i
           raise "#{ __method__ } does not support this operating system at this time"
         when /linux|arch/i
-          cleanup_known_hosts_for_BSD_linux_architecture target
+          puts "#{ __method__ } does not support this operating system at this time"
         when /sunos|solaris/i
           raise "#{ __method__ } does not support this operating system at this time"
         when /darwin/i

data/lib/cheftacular/stateless_actions/full_bootstrap.rb

@@ -24,6 +24,8 @@ class Cheftacular
 
       @config['initializer'].initialize_passwords @options['env'] #reset the passwords var to contain the new deploy pass set in ubuntu_bootstrap
 
+      @config['helper'].install_rvm_sh_file if @config['cheftacular']['install_rvm_on_boot']
+
       @config['stateless_action'].chef_bootstrap
     end
   end

data/lib/cheftacular/stateless_actions/get_active_ssh_connections.rb

@@ -2,7 +2,7 @@ class Cheftacular
   class StatelessActionDocumentation
     def get_active_ssh_connections
       @config['documentation']['stateless_action'] <<  [
-        "`cft get_active_ssh_connections` will fetch the active ssh connections from every server and output it into your log directory."
+        "[NYI]`cft get_active_ssh_connections` will fetch the active ssh connections from every server and output it into your log directory."
       ]
 
       @config['documentation']['application'] << @config['documentation']['stateless_action'].last

data/lib/cheftacular/stateless_actions/help.rb

@@ -11,6 +11,12 @@ class Cheftacular
     end
   end
 
+  class InitializationAction
+    def help
+      
+    end
+  end
+
   class StatelessAction
     def help inference_modes=[]
       target_command   = @options['command'] == 'help' ? ARGV[1] : ARGV[0]
@@ -45,15 +51,11 @@ class Cheftacular
 
       end if inference_modes.include?('stateless_action') || inference_modes.include?('both')
 
-      puts @config['helper'].compile_documentation_lines('action').flatten.join("\n\n") if target_command == 'action'
-
       puts @config['documentation']['arguments'].flatten.join("\n\n") if target_command == 'arguments'
 
-      puts @config['helper'].compile_documentation_lines('stateless_action').flatten.join("\n\n") if target_command == 'stateless_action'
-
-      puts @config['helper'].compile_documentation_lines('application').flatten.join("\n\n") if target_command == 'application' || target_command.empty?
+      puts @config['helper'].compile_documentation_lines('application').flatten.join("\n\n") if target_command.empty?
 
-      puts @config['helper'].compile_documentation_lines('devops').flatten.join("\n\n") if target_command == 'devops'
+      puts @config['helper'].compile_documentation_lines(target_command).flatten.join("\n\n") if target_command =~ /action|stateless_action|application|devops/
 
       if inference_modes.empty? && @config['helper'].is_not_command_or_stateless_command?(target_command)
         methods = @config['action_documentation'].public_methods(false) + @config['stateless_action_documentation'].public_methods(false)
@@ -64,7 +66,7 @@ class Cheftacular
         puts "    #{ sorted_methods.at(0) }"
         puts "    #{ sorted_methods.at(1) }"
         puts "    #{ sorted_methods.at(2) }\n"
-        puts "If so, please run 'cft help COMMAND' with one of the above commands or run 'hip help application' to see a list of commands"
+        puts "If so, please run 'cft help COMMAND' with one of the above commands or run 'cft help #{ @config['cheftacular']['mode'] }' to see a list of commands"
       end
     end
   end

data/lib/cheftacular/stateless_actions/initialize_cheftacular_yml.rb

@@ -0,0 +1,29 @@
+class Cheftacular
+  class StatelessActionDocumentation
+    def initialize_cheftacular_yml
+      @config['documentation']['stateless_action'] <<  [
+        "`cft initialize_cheftacular_yml` will create a cheftacular.yml file in your config folder (and create the" +
+        "config folder if it does not exist). If you already have a cheftacular.yml file in the config folder, it will " +
+        "create a cheftacular.example.yml file that will contain the new changes / keys in the latest cheftacular version."
+      ]
+    end
+  end
+
+  class InitializationAction
+    def initialize_cheftacular_yml
+      
+    end
+  end
+
+  class StatelessAction
+    def initialize_cheftacular_yml
+      FileUtils.mkdir_p(File.join(@config['locs']['chef-repo'], "config"))
+
+      if File.exist?(File.join(@config['locs']['chef-repo'], "config", "cheftacular.yml"))
+        @config['helper'].write_config_cheftacular_yml_file('cheftacular.example.yml')
+      else
+        @config['helper'].write_config_cheftacular_yml_file
+      end
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/initialize_data_bag_contents.rb

@@ -10,7 +10,7 @@ class Cheftacular
 
   class StatelessAction
     def initialize_data_bag_contents env=""
-      raise "Environment does not exist on chef server!" unless @config['chef_environments'].include?(env)
+      raise "Environment #{ env } does not exist on chef server!" if !env.blank? && !@config['chef_environments'].include?(env)
 
       env = ARGV[1] if env.blank?
 
@@ -29,6 +29,8 @@ class Cheftacular
       #@config['initializer'].initialize_logs_bag_contents env
 
       #@config['ChefDataBag'].initialize_node_roles_bag_contents env
+
+      exit if @options['command'] == __method__
     end
   end
 
@@ -58,48 +60,15 @@ class Cheftacular
         end 
       end
 
-      hash['cloud_auth'] = {} unless hash.has_key?('cloud_auth')
-
-      unless hash['cloud_auth'].has_key?(@options['preferred_cloud'])
-        hash['cloud_auth'][@options['preferred_cloud']] = {}
-
-        puts "Critical! No Cloud credentials detected for cloud #{ @options['preferred_cloud'] }, " +
-        "Someone will need to edit the authentication data bag with the command " +
-        auth_fix_message +
-        "And add the correct cloud credentials to the hash for your preferred cloud!"
-
-        save_on_finish, exit_on_finish = true,true
-      end
-
-      if hash['cloud_auth'].has_key?('rackspace')
-        if !( hash['cloud_auth']['rackspace'].has_key?('username') || hash['cloud_auth']['rackspace'].has_key?('api_key') || hash['cloud_auth']['rackspace'].has_key?('email')) 
-
-          hash['cloud_auth']['rackspace']['username'] = "" unless hash['cloud_auth']['rackspace'].has_key?('username')
-          hash['cloud_auth']['rackspace']['api_key']  = "" unless hash['cloud_auth']['rackspace'].has_key?('api_key')
-          hash['cloud_auth']['rackspace']['email']    = "" unless hash['cloud_auth']['rackspace'].has_key?('email')
-
-
-          puts "Critical! No cloud credentials detected for the rackspace cloud_auth hash! There must be both a valid username and an api_key in this hash!"
-          puts "Please run #{ auth_fix_message }Fill in the blank strings with your rackspace credentials."
-
-          save_on_finish, exit_on_finish = true,true
-        elsif hash['cloud_auth']['rackspace']['username'].empty? || hash['cloud_auth']['rackspace']['api_key'].empty? || hash['cloud_auth']['rackspace']['api_key'].empty?
-          puts "Critical! Cloud credentials detected for the rackspace cloud_auth hash are blank!"
-          puts "Please run #{ auth_fix_message }Fill in the blank strings with your rackspace credentials."
-
-          exit_on_finish = true
-        end
-      end
-
       if @config['cheftacular']['git_based_deploys']
         if !hash.has_key?('git_private_key') || !hash.has_key?('git_public_key') || !hash.has_key?('git_OAuth')
-          puts "Warning! github user credentials in default authentication bag were not found! Please run `cft help create_git_key` and then run that command itself!" unless @command == 'help'
+          puts "Warning! github user credentials in default authentication bag were not found! Please run `cft help create_git_key` and then run that command itself!" unless @options['command'] == 'help'
         end
       end
 
       @config['ChefDataBag'].save_authentication_bag if save_on_finish
 
-      exit if exit_on_finish
+      exit if exit_on_finish && @options['command'] != 'create_git_key'
     end
 
     #User Action Generated: {"1.2.3.4-deploy-pass": "S325DSAGBCVfg5", "1.2.3.4-root-pass": "7dfDSFgb5%231", "1.2.3.4-name": "test"}

data/lib/cheftacular/stateless_actions/list_toggleable_roles.rb

@@ -0,0 +1,45 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def list_toggleable_roles
+      @config['documentation']['stateless_action'] <<  [
+        "`cft list_toggleable_roles NODE_NAME` This command will allow you to see all toggleable roles for a node"
+      ]
+
+      @config['documentation']['application'] << @config['documentation']['stateless_action'].last
+    end
+  end
+
+  class StatelessAction
+    def list_toggleable_roles possible_toggles=[]
+      @options['node_name'] = ARGV[1] unless @options['node_name']
+
+      raise "You have yet to fully configure your role toggling settings! Exiting..." if @config['cheftacular']['role_toggling'].has_key?('do_not_allow_toggling')
+
+      nodes = @config['error'].is_valid_node_name_option?
+
+      suffix = @config['cheftacular']['role_toggling']['deactivated_role_suffix']
+
+      nodes.first.run_list.each do |role|
+        role = role.gsub('role[','').gsub(']','')
+
+        if !role.include?(suffix) && @config['parser'].parse_role("#{ role }#{ suffix }", 'boolean')
+          possible_toggles << role
+          possible_toggles << "#{ role }#{ suffix }"
+
+        elsif role.include?(suffix) && @config['parser'].parse_role("#{ role.gsub(suffix,'') }", 'boolean')
+          possible_toggles << role
+          possible_toggles << role.gsub(suffix,'')
+        end
+      end
+
+      puts "The current run_list for #{ @options['node_name'] } is:"
+
+      ap nodes.first.run_list
+
+      puts "\nThe possible toggles for #{ @options['node_name'] } are:"
+
+      ap possible_toggles
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/location_aliases.rb

@@ -0,0 +1,24 @@
+class Cheftacular
+  class StatelessActionDocumentation
+    def location_aliases
+      @config['documentation']['stateless_action'] <<  [
+        "`cft location_aliases` will list all location aliases listed in your cheftacular.yml. These aliases can be used " +
+        "in the `cft file` command."
+      ]
+
+      @config['documentation']['application'] << @config['documentation']['stateless_action'].last
+    end
+  end
+
+  class InitializationAction
+    def location_aliases
+      
+    end
+  end
+
+  class StatelessAction
+    def location_aliases
+      ap @config['cheftacular']['location_aliases']
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/pass.rb

@@ -26,17 +26,17 @@ class Cheftacular
 
       case CONFIG['host_os']
       when /mswin|windows/i
-        raise "#{ __method__ } does not support this operating system at this time"
+        #raise "#{ __method__ } does not support this operating system at this time"
       when /linux|arch/i
-        raise "#{ __method__ } does not support this operating system at this time"
+        #raise "#{ __method__ } does not support this operating system at this time"
       when /sunos|solaris/i
-        raise "#{ __method__ } does not support this operating system at this time"
+        #raise "#{ __method__ } does not support this operating system at this time"
       when /darwin/i
         puts "Copying #{ nodes.first.name } (#{ nodes.first.public_ipaddress }) sudo password into your clipboard"
         
         `echo '#{ @config[nodes.first.chef_environment]['server_passwords_bag_hash']["#{ nodes.first.public_ipaddress }-deploy-pass"] }' | pbcopy`
       else
-        raise "#{ __method__ } does not support this operating system at this time"
+        #raise "#{ __method__ } does not support this operating system at this time"
       end
     end
   end

data/lib/cheftacular/stateless_actions/reinitialize.rb

@@ -30,17 +30,11 @@ class Cheftacular
 
       out << `ssh -t -oStrictHostKeyChecking=no #{ chef_user }@#{ @options['address'] } "#{ sudo(@options['address']) } rm /etc/chef/client.pem"`
 
-      #remove_client #just in case
-
       puts("Starting reinitialization...") unless @options['quiet']
 
       out << `#{ @config['helper'].knife_bootstrap_command }`
 
       puts(out.last) unless @options['quiet']
-
-      #@options['multi-step'] = true # have the upload_nodes grab the new nodes
-
-      #upload_nodes
     end
   end
 end

data/lib/cheftacular/stateless_actions/remove_client.rb

@@ -3,9 +3,14 @@ class Cheftacular
   class StatelessActionDocumentation
     def remove_client
       @config['documentation']['stateless_action'] <<  [
-        "`cft remove_client -n NODE_NAME` removes a client (and its node data) from the chef-server. " +
+        "`cft remove_client NODE_NAME [destroy]` removes a client (and its node data) from the chef-server. " +
         "It also removes its dns records from the cloud service (if possible). " +
-        "This should not be done lightly as you will have to wipe the server and trigger another chef-client run to get it to register again"
+        "This should not be done lightly as you will have to wipe the server and trigger another chef-client " +
+        "run to get it to register again. Alternatively, you can run `cft reinitialize IP_ADDRESS NODE_NAME as well.",
+
+        [
+          "    1. `destroy` deletes the server as well as removing it from the chef environment."
+        ]
       ]
     end
   end
@@ -47,15 +52,15 @@ class Cheftacular
           @config['ridley'].client.delete(client)
 
           if @options['delete_server_on_remove'] == 'destroy'
-            @config['stateless_action'].cloud "server", "destroy:#{ @options['env'] }_#{ n.name }"
+            @config['stateless_action'].cloud "server", "destroy:#{ @config['getter'].get_current_real_node_name(n.name) }"
           end
-        end
 
-        @config[@options['env']]['addresses_bag_hash'] = @config[@options['env']]['addresses_bag'].reload.to_hash
+          @config[@options['env']]['addresses_bag_hash'] = @config[@options['env']]['addresses_bag'].reload.to_hash
 
-        @config['DNS'].compile_address_hash_for_server_from_options('set_hash_to_nil')
+          @config['DNS'].compile_address_hash_for_server_from_options('set_hash_to_nil')
 
-        @config['ChefDataBag'].save_addresses_bag
+          @config['ChefDataBag'].save_addresses_bag
+        end
       end
 
       puts("Done. Please verify that the output of the next line(s) match your expectations (running client-list)") if @options['verbose']

data/lib/cheftacular/stateless_actions/role_toggle.rb

@@ -0,0 +1,141 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def role_toggle
+      @config['documentation']['stateless_action'] <<  [
+        "`cft role_toggle NODE_NAME ROLE_NAME activate|deactivate` This command will allow you to **toggle** roles on nodes without using `cft upload_nodes`",
+
+        [
+          "    1. This command uses your *role_toggling:deactivated_role_suffix* attribute set in your cheftacular.yml to toggle the role, " +
+          "it checks to see if the toggled name exists then sets the node's run_list to include the toggled role",
+
+          "    2. EX: `cft role_toggle apisc01 worker activate` will find the node apisc01 and attempt to toggle the worker role to on. " +
+          "If the node does NOT have the worker#{ @config['cheftacular']['role_toggling']['deactivated_role_suffix'] } role, then it will " +
+          "add it if *role_toggling:strict_roles* is set to **false**",
+
+          "        1. If *role_toggling:strict_roles* is set to true, then cheftacular would raise an error saying this role is unsettable " +
+          "on the node. On the other hand, if the node already has the worker#{ @config['cheftacular']['role_toggling']['deactivated_role_suffix'] }" +
+          "role, then this command will succeed even if *strict_roles* is set.",
+
+          "    3. In case it isn't obvious, this command ONLY supports deactivation suffix roles like worker_deactivate or worker_off, with their" +
+          "on counterpart just being the role itself, like \"worker\".",
+
+          "        1. Please run `cft list_toggleable_roles NODE_NAME` to get a list of your org's toggleable roles for a node."
+        ]
+      ]
+
+      @config['documentation']['application'] << @config['documentation']['stateless_action'].last
+    end
+  end
+
+  class StatelessAction
+    def role_toggle state_toggle='', target_run_list=[], skip_confirm=false
+      @options['node_name'] = ARGV[1] unless @options['node_name']
+      @config['parser'].parse_role(ARGV[2])
+      state_toggle          = ARGV[3] if state_toggle.blank?
+
+      raise "You have yet to fully configure your role toggling settings! Exiting..." if @config['cheftacular']['role_toggling'].has_key?('do_not_allow_toggling')
+      raise "You may only enter activate or deactivate for the state toggle argument for the #{ __method__ } command." unless (state_toggle =~ /activate|deactivate/) == 0
+
+      @config['initializer'].initialize_data_bags_for_environment @options['env'], false, ['node_roles']
+
+      @config['initializer'].initialize_node_roles_bag_contents @options['env']
+
+      @config['filesystem'].cleanup_file_caches('current')
+
+      nodes = @config['error'].is_valid_node_name_option?
+
+      suffix = @config['cheftacular']['role_toggling']['deactivated_role_suffix']
+
+      if @options['role'].include?(suffix)
+        unless @config['parser'].parse_role("#{ @options['role'].gsub(suffix,'') }", 'boolean')
+          puts "Role #{ @options['role'] } does not have an activated role! There is no #{ @options['role'].gsub(suffix,'') } role!"
+
+          return false
+        end
+      else
+        unless @config['parser'].parse_role("#{ @options['role'] }#{ suffix }", 'boolean')
+          puts "Role #{ @options['role'] } does not have a deactivated role! There is no #{ @options['role'] }#{ suffix } role!"
+
+          return false
+        end
+      end
+
+      current_node_roles = nodes.first.run_list
+
+      if current_node_roles.include?("role[#{ @options['role'] }]") && !@options['role'].include?(suffix)
+        if state_toggle == 'activate'
+          puts "The role #{ @options['role'] } is already activated for #{ nodes.first.name }!"
+        else
+          puts "The role #{ @options['role'] } is currently activated, setting it to #{ @options['role'] }#{ suffix }"
+
+          target_run_list = current_node_roles.map {|r| r.gsub(@options['role'], "#{ @options['role'] }#{ suffix }") if current_node_roles.include?("role[#{ @options['role'] }]") }
+        end
+      elsif current_node_roles.include?("role[#{ @options['role'] }]") && @options['role'].include?(suffix)
+        if state_toggle == 'activate'
+          puts "The role #{ @options['role'] } is currently deactivated, setting it to #{ @options['role'].gsub(suffix, '') }"
+
+          target_run_list = current_node_roles.map {|r| r.gsub(@options['role'], "#{ @options['role'].gsub(suffix, '') }") if current_node_roles.include?("role[#{ @options['role'] }]") }
+        else
+          puts "The role #{ @options['role'] } is already deactivated for #{ nodes.first.name }!"
+        end
+      elsif current_node_roles.include?("role[#{ @options['role'] }#{ suffix }]") #they passed in the reverse of a role that was already deactivated
+        if state_toggle == 'activate'
+          puts "The role #{ @options['role'] } is currently deactivated, setting it to it's activated state"
+
+          target_run_list = current_node_roles.map {|r| r.gsub("#{ @options['role'] }#{ suffix }", "#{ @options['role'] }") if current_node_roles.include?("role[#{ @options['role'] }#{ suffix }]") }
+        else
+          puts "The role #{ @options['role'] } is already deactivated for #{ nodes.first.name }!"
+        end
+      elsif current_node_roles.include?("role[#{ @options['role'].gsub(suffix, '') }]") #they passed in the reverse of a role that was already activated
+        if state_toggle == 'activate'
+          puts "The role #{ @options['role'] } is already activated for #{ nodes.first.name }!"
+        else
+          puts "The role #{ @options['role'] } is currently activated, setting it to it's deactivated state"
+          
+          target_run_list = current_node_roles.map {|r| r.gsub("#{ @options['role'].gsub('suffix','') }", "#{ @options['role'] }") if current_node_roles.include?("role[#{ @options['role'].gsub('suffix','') }]") }
+        end
+      elsif !current_node_roles.include?("role[#{ @options['role'] }]") && @config['cheftacular']['role_toggling']['strict_roles']
+        puts "The node does not have #{ @options['role'] } and strict roles is set to true, exiting..."
+
+        return false
+      elsif !current_node_roles.include?("role[#{ @options['role'] }]") && !@config['cheftacular']['role_toggling']['strict_roles']
+        puts "The node does not have #{ @options['role'] } and strict roles is set to false, setting this new role..."
+
+        target_run_list = current_node_roles + "role[#{ @options['role'] }"
+      end
+
+      unless target_run_list.empty?
+        puts "Updating node run list for #{ nodes.first.name } from"
+
+        ap current_node_roles
+
+        puts "to:"
+
+        ap target_run_list
+
+        if skip_confirm || !@config['cheftacular']['role_toggling']['skip_confirm']
+          puts "Enter Y/y to confirm."
+
+          input = STDIN.gets.chomp
+
+          return false unless ( input =~ /y|Y|yes|Yes/ ) == 0
+        end
+
+        @config[@options['env']]['node_roles_bag_hash']['node_roles'][nodes.first.name.gsub(/\d/,'')]['run_list'] = target_run_list
+
+        nodes.first.send("run_list=", target_run_list)
+
+        nodes.first.save
+
+        @config['ChefDataBag'].save_node_roles_bag @options['env']
+
+        @config['filesystem'].cleanup_file_caches('current')
+
+        puts "Triggering deploy to set the new role..."
+
+        @config['action'].deploy
+      end
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/server_update.rb

@@ -7,7 +7,7 @@ class Cheftacular
         "This should be done with caution as this *might* break something.",
 
         [
-          "    1. `hip apt_update restart` will prompt to ask if you also want to restart all servers in a rolling restart. " +
+          "    1. `cft apt_update restart` will prompt to ask if you also want to restart all servers in a rolling restart. " +
           "This should be done with extreme caution and only in a worst-case scenario."
         ]
       ]
@@ -96,4 +96,4 @@ module SSHKit
       end
     end
   end
-end
+end

data/lib/cheftacular/stateless_actions/update_chef_client.rb

@@ -0,0 +1,18 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def update_chef_client
+      @config['documentation']['stateless_action'] <<  [
+        "[NYI]`cft update_chef_client` attempts to update the chef-client of all nodes to the latest version. " +
+        "Should be done with caution and with the chef_server's version in mind."
+      ]
+    end
+  end
+
+  class StatelessAction
+    def update_chef_client
+      raise "Not Yet Implemented"
+      raise "This action can only be performed if the mode is set to devops" unless @config['helper'].running_in_mode?('devops')
+    end
+  end
+end