cheftacular 2.4.1 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d1824b19ce37e0733ceb249e6bbac87eecbb81d5
-  data.tar.gz: b448ce029765480b636de8ec62f4b0bd74a214a0
+  metadata.gz: 7233d8cadcae175bcd92d273a3605839a2d53ad9
+  data.tar.gz: fdb827fd1402bdd10a00a6825562a73141bb6061
 SHA512:
-  metadata.gz: 513496fe5d458cc5131dfad0bf573888b6a05a762b1bce7070bf2dd639eabe03bf1ccfba52a2e8a3919048cfd22ff3a2eac0217f09417c207a005d48cadbe599
-  data.tar.gz: 941ccd83c2d7eaf0fcdaa40512a4f7b87c96d9b8f89caa5d6df5b9c608639ed86838c70c6eee2a83056a500f2c8a20161506a3b2ff44c0c2b14e44b4dda8149b
+  metadata.gz: cb98181f78e93dffaed9569a924a5bd405e350af1379cffb0ccb44f1230c59ec54d34651b77d1b40b747c6a02e4e56a4e2a085a2613edd639bd285ece64bf17d
+  data.tar.gz: 775787e78bc7d997d94eabaa5011e72bc78aeb9b6295ae73d91f14d00c8acb5f5b634e917cb660880c5d2787aa23a49a18a91696216d5870a09e53062155003b

data/lib/cheftacular/README.md

@@ -94,23 +94,53 @@
 
     3. This command will prompt when attempting to destroy servers in staging or production
 
-9. `cft fix_known_hosts [HOSTNAME]` this command will delete entries in your known_hosts file for all the servers that are in our system (ip addresses AND dns names)
+9. `cft file NODE_NAME LOCATION_ALIAS MODE FILE_NAME` interacts with a file on the remote server
+
+    1. `LOCATION_ALIAS` will be parsed as a path if it has backslash characters. Otherwise it will be parsed from your location_aliases hash in your cheftacular.yml
+
+    2. `FILE_NAME` is the actual name (can also be additional path to the file) of the file to be interacted with. If no value is passed or the file does not exist in the LOCATION_ALIAS, the command will return the entries in LOCATION_ALIAS
+
+        1. *NOTE! If you plan to use FILE_NAME as a path, do prepend the path with a / character!*
+
+    3. `MODE` can be `cat|display|edit|fetch|list|scp|tail|tail-f`.
+
+        1. The default mode is display, this is what will be run at LOCATION_ALIAS for FILE_NAME if no MODE is passed.
+
+        2. `cat|display` will attempt to display the FILE_NAME listed to your terminal.
+
+        3. `edit:TEXT_EDITOR` will attempt to edit the file with the TEXT_EDITOR listed. NOTE! This editor must be installed on the node you're accessing. If the editor is not present via a `which` command, the cft file command will say so.
+
+        4. `fetch|scp` will attempt to fetch the FILE_NAME listed via SCP. This file is saved to /Users/mrlocus/Code/chef-repo/tmp (based on your directory structure) under the same FILE_NAME as the remote file.
+
+            1. The deploy must have access to said file without sudo!
+
+        5. `list` the default behavior if the file does not exist. Otherwise must be manually called.
+
+        6. `tail:NUMBER_OF_LINES` tails the file for the last `NUMBER_OF_LINES` lines, defaults to 500.
+
+        7. `tail-f` enables continuous output of the file.
+
+    4. `--save-to-file FILE_NAME option will save the output of `cat|display|tail` to a file on your local system instead of displaying the file to your terminal window.
+
+        1. `--save-to-file FILE_PATH` can also be used in the `fetch` context to specify where exactly to save the file and what to name it as.
+
+10. `cft fix_known_hosts [HOSTNAME]` this command will delete entries in your known_hosts file for all the servers that are in our system (ip addresses AND dns names)
 
     1. Passing in a hostname will make the command only remove entries with that hostname / ip specifically
 
-10. `cft get_active_ssh_connections` will fetch the active ssh connections from every server and output it into your log directory.
+11. `cft get_active_ssh_connections` will fetch the active ssh connections from every server and output it into your log directory.
 
-11. `cft get_haproxy_log` this command will generate a haproxy html file for the load balancer(s) associated with a repository in the log directory. Opening this log file in the browser will show the status of that haproxy at the time of the log. 
+12. `cft get_haproxy_log` this command will generate a haproxy html file for the load balancer(s) associated with a repository in the log directory. Opening this log file in the browser will show the status of that haproxy at the time of the log. 
 
     1. In devops mode, this command will not do anything without the -R repository passed.
 
-12. `cft get_log_from_bag <NODE_NAME-COMMAND_TYPE>` this command grabs the latest command run log from the data bags and saves it to your log directory. There are different types of logs saved per server depending on command.
+13. `cft get_log_from_bag <NODE_NAME-COMMAND_TYPE>` this command grabs the latest command run log from the data bags and saves it to your log directory. There are different types of logs saved per server depending on command.
 
-13. `cft get_pg_pass ['clip']` command will output the current environment's pg_password to your terminal. Optionally you can pass in clip like `cft get_pg_pass clip` to have it also copy the pass to your clipboard.
+14. `cft get_pg_pass ['clip']` command will output the current environment's pg_password to your terminal. Optionally you can pass in clip like `cft get_pg_pass clip` to have it also copy the pass to your clipboard.
 
-14. `cft help COMMAND|MODE` this command returns the documentation for a specific command if COMMAND matches the name of a command. Alternatively, it can be passed `action|arguments|application|current|devops|stateless_action` to fetch the commands for a specific mode.Misspellings of commands will display near hits.
+15. `cft help COMMAND|MODE` this command returns the documentation for a specific command if COMMAND matches the name of a command. Alternatively, it can be passed `action|arguments|application|current|devops|stateless_action` to fetch the commands for a specific mode.Misspellings of commands will display near hits.
 
-15. `cft log` this command will output the last 500 lines of logs from every server set for CODEBASE (can be given additional args to specify) to the log directory
+16. `cft log` this command will output the last 500 lines of logs from every server set for CODEBASE (can be given additional args to specify) to the log directory
 
     1.  `--nginx` will fetch the nginx logs as well as the application logs
 
@@ -122,13 +152,13 @@
 
     4. `--fetch-backup` If doing a pg_data log, this will fetch the latest logs from the pg_data log directory for each database.
 
-16. `cft migrate` this command will grab the first alphabetical node for a repository and run a migration that will hit the database primary server.
+17. `cft migrate` this command will grab the first alphabetical node for a repository and run a migration that will hit the database primary server.
 
-17. `cft pass NODE_NAME` will drop the server's sudo password into your clipboard. Useful for when you need to ssh into the server itself and try advanced linux commands
+18. `cft pass NODE_NAME` will drop the server's sudo password into your clipboard. Useful for when you need to ssh into the server itself and try advanced linux commands
 
-18. `cft reinitialize IP_ADDRESS NODE_NAME` will reconnect a server previously managed by chef to a new chef server. The node name MUST MATCH THE NODE'S ORIGINAL NODE NAME for the roles to be setup correctly.
+19. `cft reinitialize IP_ADDRESS NODE_NAME` will reconnect a server previously managed by chef to a new chef server. The node name MUST MATCH THE NODE'S ORIGINAL NODE NAME for the roles to be setup correctly.
 
-19. `cft run COMMAND [--all]` will trigger the command on the first server in the role. Can be used to run rake commands or anything else.
+20. `cft run COMMAND [--all]` will trigger the command on the first server in the role. Can be used to run rake commands or anything else.
 
     1. `--all` will make the command run against all servers in a role rather than the first server it comes across. Don't do this if you're modifying the database with the command.
 
@@ -138,11 +168,11 @@
 
     4. IMPORTANT NOTE: You cannot run `cft run rake -T` as is, you have to enclose any command that uses command line dash arguments in quotes like `cft run "rake -T"`
 
-20. `cft scale up|down [NUM_TO_SCALE]` will add (or remove) NUM_TO_SCALE servers from the server array. This command will not let you scale down below 1 server.
+21. `cft scale up|down [NUM_TO_SCALE]` will add (or remove) NUM_TO_SCALE servers from the server array. This command will not let you scale down below 1 server.
 
     1. In the case of server creation, this command takes a great deal of time to execute. It will output what stage it is currently on to the terminal but <b>you must not kill this command while it is executing</b>.A failed build may require the server to be destroyed / examined by a DevOps engineer.
 
-21. `cft tail` will tail the logs (return continuous output) of the first node if finds that has an application matching the repository running on it. Currently only supports rails stacks
+22. `cft tail` will tail the logs (return continuous output) of the first node if finds that has an application matching the repository running on it. Currently only supports rails stacks
 
     1. pass `-n NODE_NAME` to grab the output of a node other than the first.
 
@@ -151,35 +181,23 @@
 
 ## Commands that can ONLY be run in the devops context
 
-1. [NYI]`cft chef_environment ENVIRONMENT_NAME [create|destroy]` will allow you to interact with chef environments on the chef server.
-
-    1.  `create` will create an environment if it does not exist.
-
-    2.  `destroy` will destroy a chef environment *IF IT HAS NO NODES*
+1. [NYI]`cft clean_sensu_plugins` will checkout / update the sensu community plugins github repo on your local machine and sync any sensu plugin files in your wrapper cookbook directory with what is in the repo.
 
-2. [NYI]`cft clean_sensu_plugins` will checkout / update the sensu community plugins github repo on your local machine and sync any sensu plugin files in your wrapper cookbook directory with what is in the repo.
-
-3. [NYI]`cft fetch_file NODE_NAME LOCATION_ALIAS FILE_NAME` fetches a file from the remote node. 
-
-    1. `LOCATION_ALIAS` will be parsed as a path if it has backslash characters. Otherwise it will be parsed from your location_aliases hash in your cheftacular.yml
-
-    2. `FILE_NAME` is the actual name of the file to be fetched. If no value is passed or the file does not exist in the LOCATION_ALIAS, the command will return the entries in LOCATION_ALIAS
-
-4. `cft add_ssh_key_to_bag "<NEW SSH PUB KEY>" [SPECIFIC_REPOSITORY]` this command will add the given ssh key to the default authentication data bag. After this your server recipes should read the contents of the 'default' 'authentication' bag for the authorized_keys array.
+2. `cft add_ssh_key_to_bag "<NEW SSH PUB KEY>" [SPECIFIC_REPOSITORY]` this command will add the given ssh key to the default authentication data bag. After this your server recipes should read the contents of the 'default' 'authentication' bag for the authorized_keys array.
 
     1. `SPECIFIC_REPOSITORY` is a special argument, if left blank the key will be placed in the authorized_keys array in the bag, otherwise it will be placed in the specific_authorized_keys hash under a key named for the repository that is passed. The script will error if SPECIFIC_REPOSITORY does not exist in the cheftacular.yml respositories hash. You can then use this data to give users selective ssh access to certain servers.
 
-5. `cft backup [activate|deactivate]` this command sets the fetch_backups and restore_backups flags in your config data bag for an environment. These can be used to give application developers a way to trigger / untrigger restores in an environment
+3. `cft backup [activate|deactivate]` this command sets the fetch_backups and restore_backups flags in your config data bag for an environment. These can be used to give application developers a way to trigger / untrigger restores in an environment
 
-6. `cft chef_bootstrap ADDRESS NODE_NAME` allows you to register a node in the chef system, remove any lingering data that may be associated with it and update the node's runlist if it has an entry in nodes_dir for its NODE_NAME.
+4. `cft chef_bootstrap ADDRESS NODE_NAME` allows you to register a node in the chef system, remove any lingering data that may be associated with it and update the node's runlist if it has an entry in nodes_dir for its NODE_NAME.
 
-7. `cft clean_cookbooks [force] [remove_cookbooks]` allows you to update the internal chef-repo's cookbooks easily. By default this script will force you to decide what to do with each cookbook individually (shows version numbers and whether to overwrite it to cookbooks or not).
+5. `cft clean_cookbooks [force] [remove_cookbooks]` allows you to update the internal chef-repo's cookbooks easily. By default this script will force you to decide what to do with each cookbook individually (shows version numbers and whether to overwrite it to cookbooks or not).
 
     1. `force` argument will cause the downloaded cookbooks to *always* overwrite the chef-repo's cookbooks as long as the downloaded cookbook has a higher version number.
 
     2. If you would like to remove all the cookbooks on the chef server, run `knife cookbook bulk delete '.*' -p -c ~/.chef/knife.rb`
 
-8. `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.
+6. `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.
 
@@ -187,7 +205,7 @@
 
     3. This command is aliased to `client-list` with no arguments or cft prefix.
 
-9. `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.
+7. `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` first level argument for interacting with cloud domains
 
@@ -259,7 +277,7 @@
 
             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.
 
-10. `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)
+8. `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)
 
@@ -269,19 +287,19 @@
 
     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]"
 
-11. `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.
+9. `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.
 
-12. `cft compile_readme` compiles all documentation methods and creates a README.md file in the log folder of the application.
+10. `cft compile_readme` compiles all documentation methods and creates a README.md file in the log folder of the application.
 
-13. `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.
+11. `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
 
-14. `cft disk_report` will fetch useful statistics from every server for every environment and output it into your log directory.
+12. `cft disk_report` will fetch useful statistics from every server for every environment and output it into your log directory.
 
-15. `cft environment boot|destroy` will boot / destroy the current environment
+13. `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.
 
@@ -289,23 +307,53 @@
 
     3. This command will prompt when attempting to destroy servers in staging or production
 
-16. `cft fix_known_hosts [HOSTNAME]` this command will delete entries in your known_hosts file for all the servers that are in our system (ip addresses AND dns names)
+14. `cft file NODE_NAME LOCATION_ALIAS MODE FILE_NAME` interacts with a file on the remote server
+
+    1. `LOCATION_ALIAS` will be parsed as a path if it has backslash characters. Otherwise it will be parsed from your location_aliases hash in your cheftacular.yml
+
+    2. `FILE_NAME` is the actual name (can also be additional path to the file) of the file to be interacted with. If no value is passed or the file does not exist in the LOCATION_ALIAS, the command will return the entries in LOCATION_ALIAS
+
+        1. *NOTE! If you plan to use FILE_NAME as a path, do prepend the path with a / character!*
+
+    3. `MODE` can be `cat|display|edit|fetch|list|scp|tail|tail-f`.
+
+        1. The default mode is display, this is what will be run at LOCATION_ALIAS for FILE_NAME if no MODE is passed.
+
+        2. `cat|display` will attempt to display the FILE_NAME listed to your terminal.
+
+        3. `edit:TEXT_EDITOR` will attempt to edit the file with the TEXT_EDITOR listed. NOTE! This editor must be installed on the node you're accessing. If the editor is not present via a `which` command, the cft file command will say so.
+
+        4. `fetch|scp` will attempt to fetch the FILE_NAME listed via SCP. This file is saved to /Users/mrlocus/Code/chef-repo/tmp (based on your directory structure) under the same FILE_NAME as the remote file.
+
+            1. The deploy must have access to said file without sudo!
+
+        5. `list` the default behavior if the file does not exist. Otherwise must be manually called.
+
+        6. `tail:NUMBER_OF_LINES` tails the file for the last `NUMBER_OF_LINES` lines, defaults to 500.
+
+        7. `tail-f` enables continuous output of the file.
+
+    4. `--save-to-file FILE_NAME option will save the output of `cat|display|tail` to a file on your local system instead of displaying the file to your terminal window.
+
+        1. `--save-to-file FILE_PATH` can also be used in the `fetch` context to specify where exactly to save the file and what to name it as.
+
+15. `cft fix_known_hosts [HOSTNAME]` this command will delete entries in your known_hosts file for all the servers that are in our system (ip addresses AND dns names)
 
     1. Passing in a hostname will make the command only remove entries with that hostname / ip specifically
 
-17. `cft full_bootstrap ADDRESS ROOT_PASS NODE_NAME` This command performs both ubuntu_bootstrap and chef_bootstrap.
+16. `cft full_bootstrap ADDRESS ROOT_PASS NODE_NAME` This command performs both ubuntu_bootstrap and chef_bootstrap.
 
-18. `cft get_active_ssh_connections` will fetch the active ssh connections from every server and output it into your log directory.
+17. `cft get_active_ssh_connections` will fetch the active ssh connections from every server and output it into your log directory.
 
-19. `cft get_haproxy_log` this command will generate a haproxy html file for the load balancer(s) associated with a repository in the log directory. Opening this log file in the browser will show the status of that haproxy at the time of the log. 
+18. `cft get_haproxy_log` this command will generate a haproxy html file for the load balancer(s) associated with a repository in the log directory. Opening this log file in the browser will show the status of that haproxy at the time of the log. 
 
     1. In devops mode, this command will not do anything without the -R repository passed.
 
-20. `cft get_log_from_bag <NODE_NAME-COMMAND_TYPE>` this command grabs the latest command run log from the data bags and saves it to your log directory. There are different types of logs saved per server depending on command.
+19. `cft get_log_from_bag <NODE_NAME-COMMAND_TYPE>` this command grabs the latest command run log from the data bags and saves it to your log directory. There are different types of logs saved per server depending on command.
 
-21. `cft get_pg_pass ['clip']` command will output the current environment's pg_password to your terminal. Optionally you can pass in clip like `cft get_pg_pass clip` to have it also copy the pass to your clipboard.
+20. `cft get_pg_pass ['clip']` command will output the current environment's pg_password to your terminal. Optionally you can pass in clip like `cft get_pg_pass clip` to have it also copy the pass to your clipboard.
 
-22. `cft get_shorewall_allowed_connections [PATH_TO_LOCAL_FILE] -n NODE_NAME` command will query a single server and return all of its ACCEPT connections from shorewall in it's syslog and return the results in a CSV format. Useful for tracking IP activity.
+21. `cft get_shorewall_allowed_connections [PATH_TO_LOCAL_FILE] -n NODE_NAME` command will query a single server and return all of its ACCEPT connections from shorewall in it's syslog and return the results in a CSV format. Useful for tracking IP activity.
 
     1. You must pass in a node name to query with `-n NODE_NAME`
 
@@ -313,23 +361,23 @@
 
     3. If `PATH_TO_LOCAL_FILE` is not blank, the command will use that file instead of building a file on the remote server
 
-23. `cft help COMMAND|MODE` this command returns the documentation for a specific command if COMMAND matches the name of a command. Alternatively, it can be passed `action|arguments|application|current|devops|stateless_action` to fetch the commands for a specific mode.Misspellings of commands will display near hits.
+22. `cft help COMMAND|MODE` this command returns the documentation for a specific command if COMMAND matches the name of a command. Alternatively, it can be passed `action|arguments|application|current|devops|stateless_action` to fetch the commands for a specific mode.Misspellings of commands will display near hits.
 
-24. `cft initialize_data_bag_contents ENVIRONMENT_NAME` will ensure the data bags always have the correct structure before each run. This command is run every time the gem is started and if called directly, will exit after completion.
+23. `cft initialize_data_bag_contents ENVIRONMENT_NAME` will ensure the data bags always have the correct structure before each run. This command is run every time the gem is started and if called directly, will exit after completion.
 
-25. `cft knife_upload` will resync the chef-server with the local chef-repo code. This command is analog for `knife upload /`
+24. `cft knife_upload` will resync the chef-server with the local chef-repo code. This command is analog for `knife upload /`
 
-26. `cft pass NODE_NAME` will drop the server's sudo password into your clipboard. Useful for when you need to ssh into the server itself and try advanced linux commands
+25. `cft pass NODE_NAME` will drop the server's sudo password into your clipboard. Useful for when you need to ssh into the server itself and try advanced linux commands
 
-27. `cft remove_client -n NODE_NAME` 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
+26. `cft remove_client -n NODE_NAME` 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
 
-28. `cft replication_status` will check the status of the database master and slaves in every environment. Also lists how far behind the slaves are from the master in milliseconds.
+27. `cft replication_status` will check the status of the database master and slaves in every environment. Also lists how far behind the slaves are from the master in milliseconds.
 
-29. `cft restart_swap` will restart the swap on every server that doesn't have swap currently on. Useful if you notice servers with no swap activated from `cft disk_report`
+28. `cft restart_swap` will restart the swap on every server that doesn't have swap currently on. Useful if you notice servers with no swap activated from `cft disk_report`
 
     1. There is no risk in running this command. Sometimes swap doesnt reactivate if the server was rebooted and this command fixes that.
 
-30. `cft rvm [COMMAND] [ADDITIONAL_COMMANDS]*` will run rvm commands on the remote servers. Output from this command for each server will go into your rvm directory under the log directory. Please refer to [the rvm help page](https://rvm.io/rvm) for more information on rvm commands.
+29. `cft rvm [COMMAND] [ADDITIONAL_COMMANDS]*` will run rvm commands on the remote servers. Output from this command for each server will go into your rvm directory under the log directory. Please refer to [the rvm help page](https://rvm.io/rvm) for more information on rvm commands.
 
     1. When no commands are passed, rvm will just run `rvm list` on each server on all servers in the current environment.
 
@@ -345,11 +393,11 @@
 
     7. `upgrade_rvm` will run `rvm get stable --auth-dotfiles` on all servers for the current environment. It will also check and attempt to upgrade pre 1.25 installations of RVM to 1.26+ (which requires a GPG key).
 
-31. `cft server_update [restart]` allows you to force update all nodes' packages for a specific environment. This should be done with caution as this *might* break something.
+30. `cft server_update [restart]` allows you to force update all nodes' packages for a specific environment. 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. This should be done with extreme caution and only in a worst-case scenario.
 
-32. `cft service [COMMAND] [SERVICE]` will run service commands on remote servers. This command only runs on the first server it comes across. Specify others with -n NODE_NAME.
+31. `cft service [COMMAND] [SERVICE]` will run service commands on remote servers. This command only runs on the first server it comes across. Specify others with -n NODE_NAME.
 
     1. When no commands are passed, the command will list all the services in the /etc/init directory
 
@@ -357,13 +405,13 @@
 
     3. When `restart|stop|start SERVICE` is passed, the command will attempt to restart|stop|start the service if it has a .conf file on the remote server in the /etc/init directory.
 
-33. `cft slack "MESSAGE" [CHANNEL]` will attempt to post the message to the webhook set in your cheftacular.yml. Slack posts to your default channel by default but if the CHANNEL argument is supplied the message will post there.
+32. `cft slack "MESSAGE" [CHANNEL]` will attempt to post the message to the webhook set in your cheftacular.yml. Slack posts to your default channel by default but if the CHANNEL argument is supplied the message will post there.
 
     1. NOTE: To prevent confusing spam from many possible sources, the username posted to slack will always be *Cheftacular*. This can be overloaded in the StatelessAction method "slack" but this is not recommended.
 
     2. Remember, if you have auditing turned on in your cheftacular.yml, you can track who sends what to slack.
 
-34. `cft test_env [TARGET_ENV] boot|destroy` will create (or destroy) the test nodes for a particular environment (defaults to staging, prod split-envs can be set with `-p`). Please read below for how TARGET_ENV works
+33. `cft test_env [TARGET_ENV] boot|destroy` will create (or destroy) the test nodes for a particular environment (defaults to staging, prod split-envs can be set with `-p`). Please read below for how TARGET_ENV works
 
     1. TARGET_ENV changes functionality depending on the overall (like staging / production) environment
 
@@ -373,9 +421,9 @@
 
         3. The default tld used should change depending on which environment you are booting / destroying. This is set in the environment's config data bag under the tld key
 
-35. `cft ubuntu_bootstrap ADDRESS ROOT_PASS` This command will bring a fresh server to a state where chef-client can be run on it via `cft chef-bootstrap`. It should be noted that it is in this step where a server's randomized deploy_user sudo password is generated.
+34. `cft ubuntu_bootstrap ADDRESS ROOT_PASS` This command will bring a fresh server to a state where chef-client can be run on it via `cft chef-bootstrap`. It should be noted that it is in this step where a server's randomized deploy_user sudo password is generated.
 
-36. `cft update_cloudflare_dns_from_cloud [skip_update_tld]` command will force a full dns update for cloudflare. 
+35. `cft update_cloudflare_dns_from_cloud [skip_update_tld]` command will force a full dns update for cloudflare. 
 
     1. It will ensure all the subdomain entries are correct (based on the contents of the addresses data bag) and update them if they are not. It will also create the local subdomain for the entry as well if it does exist and point it to the correct private address for an environment.
 
@@ -383,7 +431,7 @@
 
     3. The argument `skip_update_tld` will stop the long process of checking and updating all the server domains _before_ cloudflare is updated. Only skip if you believe your domain info on your cloud is accurate.
 
-37. `cft update_split_branches` will perform a series of git commands that will merge all the split branches for your split_branch enabled repositories with what is currently on master and push them.
+36. `cft update_split_branches` will perform a series of git commands that will merge all the split branches for your split_branch enabled repositories with what is currently on master and push them.
 
     1. Repository must be set with `-R REPOSITORY_NAME` for this command to work.
 
@@ -393,9 +441,9 @@
 
     4. This command will return a helpful error statement if you attempt to run the command with changes to your current working directory. You must commit these changes before running this command.
 
-38. `cft update_tld TLD` command will force a full dns update for a tld in the preferred cloud. It will ensure all the subdomain entries are correct (based on the contents of the addresses data bag) and update them if they are not. It will also create the local subdomain for the entry as well if it does exist and point it to the correct private address.
+37. `cft update_tld TLD` command will force a full dns update for a tld in the preferred cloud. It will ensure all the subdomain entries are correct (based on the contents of the addresses data bag) and update them if they are not. It will also create the local subdomain for the entry as well if it does exist and point it to the correct private address.
 
-39. `cft upload_nodes` This command will resync the chef server's nodes with the data in our chef-repo/node_roles. 
+38. `cft upload_nodes` This command will resync the chef server's nodes with the data in our chef-repo/node_roles. 
 
     1. This command changes behavior depending on several factors about both your mode and the state of your environment
 
@@ -407,4 +455,4 @@
 
         1. Due to this, only users running this against their chef-repo need to worry about having a nodes_dir, the way it should be.
 
-40. `cft upload_roles` This command will resync the chef server's roles with the data in the chef-repo/roles.
+39. `cft upload_roles` This command will resync the chef server's roles with the data in the chef-repo/roles.

data/lib/cheftacular/actions/check.rb

@@ -15,7 +15,7 @@ class Cheftacular
       #this must always precede on () calls so they have the instance variables they need
       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: :parallel do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ), in: :parallel do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts("Beginning commit check run for #{ n.name } (#{ n.public_ipaddress }) on role #{ options['role'] }") unless options['quiet']

data/lib/cheftacular/actions/console.rb

@@ -44,7 +44,7 @@ class Cheftacular
       true_env = @config['dummy_sshkit'].get_true_environment run_list, @config['cheftacular']['run_list_environments'][@options['env']], @options['env']
 
       #the >/dev/tty after the ssh block redirects the full output to stdout, not /dev/null where it normally goes  
-      `ssh -oStrictHostKeyChecking=no -tt deploy@#{ ip_address } "cd #{ app_loc } && RAILS_ENV=#{ true_env } #{ @config['bundle_command'] } exec rails c" > /dev/tty`
+      `ssh -oStrictHostKeyChecking=no -tt #{ @config['cheftacular']['deploy_user'] }@#{ ip_address } "cd #{ app_loc } && RAILS_ENV=#{ true_env } #{ @config['bundle_command'] } exec rails c" > /dev/tty`
     end
 
     def start_console_nodejs

data/lib/cheftacular/actions/db_console.rb

@@ -63,7 +63,7 @@ class Cheftacular
                   end
 
       #the >/dev/tty after the ssh block redirects the full output to stdout, not /dev/null where it normally goes  
-      `ssh -oStrictHostKeyChecking=no -tt deploy@#{ ip_address } "PGPASSWORD=#{ pg_pass } psql -U #{ db_user } -h #{ database_host }" -d #{ db_name } > /dev/tty`
+      `ssh -oStrictHostKeyChecking=no -tt #{ @config['cheftacular']['deploy_user'] }@#{ ip_address } "PGPASSWORD=#{ pg_pass } psql -U #{ db_user } -h #{ database_host }" -d #{ db_name } > /dev/tty`
     end
 
     def start_console_mysql

data/lib/cheftacular/actions/deploy.rb

@@ -26,7 +26,7 @@ class Cheftacular
       options, locs, ridley, logs_bag_hash, pass_bag_hash, bundle_command, cheftacular, passwords = @config['helper'].set_local_instance_vars
 
       #on is namespaced to SSHKit::Backend::Netssh.on 
-      on ( nodes.map { |n| "deploy@" + n.public_ipaddress } ), in: :groups, limit: 10, wait: 5 do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ), in: :groups, limit: 10, wait: 5 do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts("Beginning chef client run for #{ n.name } (#{ n.public_ipaddress }) on role #{ options['role'] }") unless options['quiet']
@@ -96,7 +96,7 @@ module SSHKit
 
         lines = e.message.split("\n").last(100).join("\n")
 
-        ::File.open("#{ log_loc }/failed-deploy/#{ name }-deploy-#{ timestamp }.txt", "w") { |f| f.write(lines.scrub_pretty_text) }
+        ::File.open("#{ log_loc }/failed-deploy/#{ name }-deploy-#{ timestamp }.txt", "w") { |f| f.write(e.message.scrub_pretty_text) }
 
         [lines, timestamp, 1]
       end

data/lib/cheftacular/actions/log.rb

@@ -31,7 +31,7 @@ class Cheftacular
 
       getter = @config['getter']
 
-      on ( nodes.map { |n| "deploy@" + n.public_ipaddress } ), in: :parallel do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ), in: :parallel do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts("Beginning log fetch run for #{ n.name } (#{ n.public_ipaddress }) on role #{ options['role'] }") unless options['quiet']
@@ -109,6 +109,7 @@ module SSHKit
 
       def start_log_fetch_nginx name, log_loc, log_cmnd, timestamp, options, out=""
         out = "" unless options['no_logs']
+        log_cmnd, log_lines = get_log_command_and_lines(options)
 
         nginx_log_loc = "/var/log/nginx/#{ options['repository'] }_access.log"
 

data/lib/cheftacular/actions/migrate.rb

@@ -24,7 +24,7 @@ class Cheftacular
       #this must always precede on () calls so they have the instance variables they need
       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 } ) do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts("Beginning migration run for #{ n.name } (#{ n.public_ipaddress }) on role #{ options['role'] }") unless options['quiet']

data/lib/cheftacular/actions/run.rb

@@ -36,7 +36,7 @@ class Cheftacular
       #this must always precede on () calls so they have the instance variables they need
       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 } ) do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts("Beginning task run for #{ n.name } (#{ n.public_ipaddress }) on role #{ options['role'] }") unless options['quiet']

data/lib/cheftacular/actions/tail.rb

@@ -39,7 +39,7 @@ class Cheftacular
     def start_tail_role_map ip_address, run_list
       log_loc = @config['getter'].get_current_role_map(run_list)['log_location'].split(',').first.gsub('|current_repo_location|', "#{ @config['cheftacular']['base_file_path'] }/#{ @options['repository'] }/current")
 
-      `ssh -oStrictHostKeyChecking=no -tt deploy@#{ ip_address } "#{ @config['helper'].sudo(ip_address) } tail -f #{ log_loc }" > /dev/tty`
+      `ssh -oStrictHostKeyChecking=no -tt #{ @config['cheftacular']['deploy_user'] }@#{ ip_address } "#{ @config['helper'].sudo(ip_address) } tail -f #{ log_loc }" > /dev/tty`
     end
 
     def start_tail_ruby_on_rails ip_address, run_list
@@ -48,7 +48,7 @@ class Cheftacular
       #special servers should be listed first as most of them will have web role
       log_loc = "#{ @config['cheftacular']['base_file_path'] }/#{ @options['repository'] }/current/log/#{ true_env }.log"
       
-      `ssh -oStrictHostKeyChecking=no -tt deploy@#{ ip_address } "#{ @config['helper'].sudo(ip_address) } tail -f #{ log_loc }" > /dev/tty`
+      `ssh -oStrictHostKeyChecking=no -tt #{ @config['cheftacular']['deploy_user'] }@#{ ip_address } "#{ @config['helper'].sudo(ip_address) } tail -f #{ log_loc }" > /dev/tty`
     end
   end
 end

data/lib/cheftacular/decryptor.rb

@@ -20,6 +20,8 @@ class Cheftacular
       return_hash
     end
 
+    private
+
     def openssl_decryptor
       openssl_decryptor = begin
         decryptor = OpenSSL::Cipher::Cipher.new(ALGORITHM)

data/lib/cheftacular/encryptor.rb

@@ -15,6 +15,8 @@ class Cheftacular
       hash
     end
 
+    private
+
     #https://github.com/opscode/chef/blob/master/lib/chef/encrypted_data_bag_item/encryptor.rb
     def encrypt_data_for_databag string
       encryptor = openssl_encryptor

data/lib/cheftacular/error.rb

@@ -0,0 +1,20 @@
+
+class Cheftacular
+  class Error
+    def initialize options, config
+      @options, @config  = options, config
+    end
+
+    def is_valid_node_name_option?
+      raise "Too few arguments, please supply a node name" if @options['node_name'].nil?
+
+      nodes = @config['getter'].get_true_node_objects(true)
+
+      nodes = @config['parser'].exclude_nodes( nodes, [{ if: { not_node: @options["node_name"] } }], true )
+
+      raise "Node not found for #{ @options['node_name'] }" if nodes.empty?
+
+      nodes
+    end
+  end
+end

data/lib/cheftacular/initializer.rb

@@ -210,6 +210,11 @@ class Cheftacular
           @options['virtualization_mode'] = v_mode
         end
 
+        #file
+        opts.on('--save-to-file FILE_NAME', 'On cft file, this option can be used to save the output of the file display methods to your system. Also works in the fetch context') do |path|
+          @options['save_to_file'] = path
+        end
+
       end.parse!
     end
 
@@ -272,6 +277,7 @@ class Cheftacular
       locs['wrapper-cookbooks'] = @config['cheftacular']['wrapper-cookbooks']
       locs['ssh']               = File.expand_path('~/.ssh')
       locs['chef-log']          = File.expand_path("#{ locs['root']}/log")             unless locs['chef-log']
+      locs['app-tmp']           = File.expand_path("#{ locs['app-root']}/tmp")
 
       @config['locs'] = locs
     end
@@ -412,6 +418,7 @@ class Cheftacular
       @config['decryptor']                      = Cheftacular::Decryptor.new(@config['data_bag_secret'])
       @config['action_documentation']           = Cheftacular::ActionDocumentation.new(@options, @config)
       @config['stateless_action_documentation'] = Cheftacular::StatelessActionDocumentation.new(@options, @config)
+      @config['error']                          = Cheftacular::Error.new(@options, @config)
       @config['dummy_sshkit']                   = SSHKit::Backend::Netssh.new(SSHKit::Host.new('127.0.0.1'))
       @config['DNS']                            = Cheftacular::DNS.new(@options, @config)
     end
@@ -421,7 +428,7 @@ class Cheftacular
         FileUtils.mkdir_p File.join( @config['locs']['chef-log'], sub_log_directory )
       end
 
-      FileUtils.mkdir_p File.join( @config['locs']['app-root'], 'tmp', @config['helper'].declassify)
+      FileUtils.mkdir_p File.join( @config['locs']['app-tmp'], @config['helper'].declassify)
 
       FileUtils.mkdir_p @config['helper'].current_nodes_file_cache_path
 

data/lib/cheftacular/parser.rb

@@ -201,5 +201,30 @@ class Cheftacular
         return repository_hash if string.include?(repository)
       end
     end
+
+    def parse_location_alias string
+      if @config['cheftacular']['location_aliases'].keys.include?(string)
+        puts("Matched location_alias #{ string } to #{ @config['cheftacular']['location_aliases'][string] }") unless @options['quiet']
+
+        string = @config['cheftacular']['location_aliases'][string]
+      end
+
+      string
+    end
+
+    def parse_mode_into_command mode
+      case mode.split(':').first
+      when /display/ then 'cat'
+      when 'edit'    then mode.split(':').last
+      when 'tail'
+        if mode.split(':').last == 'tail'
+          'tail -500'
+        else
+          "tail -#{ mode.split(':').last }"
+        end
+      when 'tail-f'  then 'tail -f'
+      else                mode
+      end
+    end
   end
 end

data/lib/cheftacular/stateless_actions/backups.rb

@@ -46,7 +46,7 @@ class Cheftacular
 
         options, locs, ridley, logs_bag_hash, pass_bag_hash, bundle_command, cheftacular, passwords = set_local_instance_vars
 
-        on ( db_primary_nodes.map { |n| "deploy@" + n.public_ipaddress } ) do |host|
+        on ( db_primary_nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
           n = get_node_from_address(nodes, host.hostname)
 
           puts("Beginning db fetch_and_restore for #{ n.name } (#{ n.public_ipaddress }) for env #{ options['env'] }") unless options['quiet']

data/lib/cheftacular/stateless_actions/disk_report.rb

@@ -24,7 +24,7 @@ class Cheftacular
 
       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|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + 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 })"

data/lib/cheftacular/stateless_actions/file.rb

@@ -0,0 +1,184 @@
+class Cheftacular
+  class StatelessActionDocumentation
+    def file
+      @config['documentation']['stateless_action'] <<  [
+        "`cft file NODE_NAME LOCATION_ALIAS MODE FILE_NAME` interacts with a file on the remote server",
+
+        [
+          "    1. `LOCATION_ALIAS` will be parsed as a path if it has backslash characters. Otherwise it will be parsed from your " +
+          "location_aliases hash in your cheftacular.yml",
+
+          "    2. `FILE_NAME` is the actual name (can also be additional path to the file) of the file to be interacted with. If no " +
+          "value is passed or the file does not exist in the LOCATION_ALIAS, the command will return the entries in LOCATION_ALIAS",
+
+          "        1. *NOTE! If you plan to use FILE_NAME as a path, do prepend the path with a / character!*",
+
+          "    3. `MODE` can be `cat|display|edit|fetch|list|scp|tail|tail-f`.",
+
+          "        1. The default mode is display, this is what will be run at LOCATION_ALIAS for FILE_NAME if no MODE is passed.",
+
+          "        2. `cat|display` will attempt to display the FILE_NAME listed to your terminal.",
+
+          "        3. `edit:TEXT_EDITOR` will attempt to edit the file with the TEXT_EDITOR listed. NOTE! This editor must be installed " +
+          "on the node you're accessing. If the editor is not present via a `which` command, the cft file command will say so.",
+
+          "        4. `fetch|scp` will attempt to fetch the FILE_NAME listed via SCP. This file is saved to #{ @config['locs']['app-tmp'] } " + 
+          "(based on your directory structure) under the same FILE_NAME as the remote file.",
+
+          "            1. The #{ @config['cheftacular']['deploy_user'] } must have access to said file without sudo!",
+
+          "        5. `list` the default behavior if the file does not exist. Otherwise must be manually called.",
+
+          "        6. `tail:NUMBER_OF_LINES` tails the file for the last `NUMBER_OF_LINES` lines, defaults to 500.",
+
+          "        7. `tail-f` enables continuous output of the file.",
+
+          "    4. `--save-to-file FILE_NAME option will save the output of `cat|display|tail` to a file on your local system instead of " +
+          "displaying the file to your terminal window.",
+
+          "        1. `--save-to-file FILE_PATH` can also be used in the `fetch` context to specify where exactly to save the file and " +
+          "what to name it as."
+        ]
+      ]
+
+      @config['documentation']['application'] << @config['documentation']['stateless_action'].last
+    end
+  end
+
+  class StatelessAction
+    def file location='', file_name='',mode=''
+      @options['node_name'] = ARGV[1] unless @options['node_name']
+      location              = ARGV[2] if location.blank?
+      mode                  = ARGV[3] if mode.blank?
+      file_name             = ARGV[4] if file_name.blank?
+
+      nodes = @config['error'].is_valid_node_name_option?
+
+      mode = 'display' if mode.nil?
+      mode = 'list'    if file_name.nil? || file_name.blank?
+
+      interaction_mode = case mode.split(':').first
+                         when 'cat'       then 'sshkit'
+                         when 'display'   then 'sshkit'
+                         when 'edit'      then 'ssh'
+                         when /fetch|scp/ then 'scp'
+                         when 'list'      then 'sshkit'
+                         when 'tail'      then 'sshkit'
+                         when 'tail-f'    then 'ssh'
+                         else                  raise "Unsupported Mode for cft file: #{ mode }, "
+                         end
+
+      
+      location = @config['parser'].parse_location_alias(location)
+      command  = @config['parser'].parse_mode_into_command(mode)
+
+      nodes = @config['parser'].exclude_nodes( nodes, [{ unless: { env: @options['env'] }}], true )
+
+      case interaction_mode
+      when 'sshkit' then file_sshkit_execute(nodes, command, location, file_name)
+      when 'ssh'    then file_ssh_execute(nodes, mode, command, location, file_name)
+      when 'scp'    then file_scp_execute(nodes, command, location, file_name)
+      end
+    end
+
+    private
+
+    def file_sshkit_execute nodes, command, location, file_name, exit_status=true
+      options, locs, ridley, logs_bag_hash, pass_bag_hash, bundle_command, cheftacular, passwords = @config['helper'].set_local_instance_vars
+
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
+        n = get_node_from_address(nodes, host.hostname)
+
+        puts("Beginning run of \"file #{ command }\" for #{ n.name } (#{ n.public_ipaddress })") if command != 'check_existence' || options['quiet']
+
+        exit_status = start_command_run( n.name, n.public_ipaddress, options, locs, passwords, cheftacular, command, location, file_name)
+      end
+
+      exit_status
+    end
+
+    def file_ssh_execute nodes, mode, command, location, file_name
+      unless file_sshkit_execute( nodes, 'check_existence', location, file_name)
+        puts "Not executing #{ command } due to failing exit status..."
+
+        return false
+      end
+
+      nodes.each do |n|
+        target_loc = "#{ location }/#{ file_name }"
+        puts("Beginning #{ command } run on #{ target_loc } for #{ n.name } (#{ n.public_ipaddress })") unless @options['quiet']
+
+        sudo_mode = "#{ @config['helper'].sudo(n.public_ipaddress) }"
+        sudo_mode = '' if mode.split(':').first == 'edit'
+
+        `ssh -oStrictHostKeyChecking=no -tt #{ @config['cheftacular']['deploy_user'] }@#{ n.public_ipaddress } "#{ sudo_mode } #{ command } #{ target_loc }" > /dev/tty`
+      end
+    end
+
+    def file_scp_execute nodes, command, location, file_name
+      unless file_sshkit_execute( nodes, 'check_existence', location, file_name)
+        puts "Not executing #{ command } due to failing exit status..."
+
+        return false
+      end
+
+      nodes.each do |n|
+        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 }"
+
+        `scp -oStrictHostKeyChecking=no #{ @config['cheftacular']['deploy_user'] }@#{ n.public_ipaddress }:#{ location }/#{ file_name } #{ download_location } > /dev/tty`
+      end
+    end
+  end
+end
+
+module SSHKit
+  module Backend
+    class Netssh
+      def start_command_run name, ip_address, options, locs, passwords, cheftacular, command, location, file_name, out="", exit_status=true
+        log_loc, timestamp = set_log_loc_and_timestamp(locs)
+        run_list_command   = command == 'list'
+        target_loc = "#{ location }/#{ file_name }"
+
+        if !sudo_test( passwords[ip_address], location ) #true if file exists
+          puts "#{ name } (#{ ip_address }) cannot run #{ command } as there is no directory at #{ location }!"
+
+          return false
+        end
+
+        if !run_list_command && !sudo_test( passwords[ip_address], target_loc ) #true if file exists
+          puts "#{ name } (#{ ip_address }) cannot run #{ command } as there is no file at #{ location }/#{ file_name }! Running list instead..."
+
+          exit_status = false
+
+          run_list_command = true
+        end
+
+        return exit_status if command == 'check_existence'
+
+        if run_list_command
+          out << sudo_capture( passwords[ip_address], :ls, '-al', location )
+        else
+          puts "Running #{ command } on #{ target_loc }"
+          out << sudo_capture( passwords[ip_address], command, target_loc)
+        end
+
+        if options['save_to_file']
+          out_location = "#{ log_loc }/#{ options['save_to_file'] }"
+
+          puts "Saving output of file at #{ out_location } }..."
+
+          ::File.open(out_location, "w") { |f| f.write(out) }
+        end
+
+        puts out.scrub_pretty_text unless options['save_to_file']
+
+        puts("Succeeded run of \"#{ command }\" for #{ name } (#{ ip_address })") unless run_list_command
+
+        exit_status
+      end
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/get_haproxy_log.rb

@@ -25,7 +25,7 @@ class Cheftacular
       options, locs, ridley, logs_bag_hash, pass_bag_hash, bundle_command, cheftacular, passwords = @config['helper'].set_local_instance_vars
 
       #on is namespaced to SSHKit::Backend::Netssh.on 
-      on ( nodes.map { |n| "deploy@" + n.public_ipaddress } ) do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts("Beginning haproxy log generation run for #{ n.name } (#{ n.public_ipaddress })") unless options['quiet']

data/lib/cheftacular/stateless_actions/get_shorewall_allowed_connections.rb

@@ -30,7 +30,7 @@ class Cheftacular
         options, locs, ridley, logs_bag_hash, pass_bag_hash, bundle_command, cheftacular, passwords = @config['helper'].set_local_instance_vars
 
         #on is namespaced to SSHKit::Backend::Netssh.on 
-        on ( nodes.map { |n| "deploy@" + n.public_ipaddress } ) do |host|
+        on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
           n = get_node_from_address(nodes, host.hostname)
 
           puts("Beginning shorewall log capture run for #{ n.name } (#{ n.public_ipaddress })") unless options['quiet']

data/lib/cheftacular/stateless_actions/pass.rb

@@ -15,13 +15,7 @@ class Cheftacular
     def pass
       @options['node_name'] = ARGV[1] unless @options['node_name']
 
-      raise "Too few arguments, please supply a node name" if ARGV.length < 2
-
-      nodes = @config['getter'].get_true_node_objects(true)
-
-      nodes = @config['parser'].exclude_nodes( nodes, [{ if: { not_node: @options["node_name"] } }], true )
-
-      raise "Node not found for #{ @options['node_name'] }" if nodes.empty?
+      nodes = @config['error'].is_valid_node_name_option?
 
       if nodes.first.chef_environment != @options['env']
         @config['initializer'].initialize_data_bags_for_environment nodes.first.chef_environment, false, ['server_passwords']

data/lib/cheftacular/stateless_actions/replication_status.rb

@@ -27,7 +27,7 @@ class Cheftacular
       #this must always precede on () calls so they have the instance variables they need
       options, locs, ridley, logs_bag_hash, pass_bag_hash, bundle_command, cheftacular, passwords = @config['helper'].set_local_instance_vars
 
-      on ( primary_nodes.map { |n| "deploy@" + n.public_ipaddress } ) do |host|
+      on ( primary_nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts "Beginning replication status report run for #{ n.name } (#{ n.public_ipaddress })"
@@ -37,7 +37,7 @@ class Cheftacular
         rep_status_hash[n.name] = start_replication_report( n.name, n.public_ipaddress,  options, locs, passwords)
       end
 
-      on ( slave_nodes.map { |n| "deploy@" + n.public_ipaddress } ) do |host|
+      on ( slave_nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts "Beginning slave replication status report run for #{ n.name } (#{ n.public_ipaddress })"

data/lib/cheftacular/stateless_actions/restart_swap.rb

@@ -23,7 +23,7 @@ class Cheftacular
       #this must always precede on () calls so they have the instance variables they need
       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|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ), in: :groups, limit: 5, wait: 2 do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts "Beginning swap restart run for #{ n.name } (#{ n.public_ipaddress })"

data/lib/cheftacular/stateless_actions/rvm.rb

@@ -65,7 +65,7 @@ class Cheftacular
 
       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|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ), in: :groups, limit: 5, wait: 2 do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts "Beginning run of \"rvm #{ command }\" for #{ n.name } (#{ n.public_ipaddress })"

data/lib/cheftacular/stateless_actions/server_update.rb

@@ -38,7 +38,7 @@ class Cheftacular
       #this must always precede on () calls so they have the instance variables they need
       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: 5 do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ), in: :groups, limit: 5, wait: 5 do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts "Beginning apt-get run for #{ n.name } (#{ n.public_ipaddress })"
@@ -48,7 +48,7 @@ class Cheftacular
         logs_bag_hash["#{ n.name }-upgrade"] = { text: log_data.scrub_pretty_text, timestamp: timestamp }
       end
 
-      on ( nodes.map { |n| "deploy@" + n.public_ipaddress } ), in: :groups, limit: 5, wait: 120 do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ), in: :groups, limit: 5, wait: 120 do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts "Beginning restart run for #{ n.name } (#{ n.public_ipaddress })"

data/lib/cheftacular/stateless_actions/service.rb

@@ -41,7 +41,7 @@ class Cheftacular
 
       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 } ) do |host|
+      on ( nodes.map { |n| @config['cheftacular']['deploy_user'] + "@" + n.public_ipaddress } ) do |host|
         n = get_node_from_address(nodes, host.hostname)
 
         puts "Beginning run of \"service #{ command }\" for #{ n.name } (#{ n.public_ipaddress })"

data/lib/cheftacular/version.rb

@@ -1,5 +1,5 @@
 class Cheftacular
   #major_version.minor_version.bugfixes
-  VERSION      = "2.4.1"
+  VERSION      = "2.5.0"
   RUBY_VERSION = "2.2.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cheftacular
 version: !ruby/object:Gem::Version
-  version: 2.4.1
+  version: 2.5.0
 platform: ruby
 authors:
 - Louis Alridge
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-17 00:00:00.000000000 Z
+date: 2015-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
@@ -241,6 +241,7 @@ files:
 - lib/cheftacular/decryptor.rb
 - lib/cheftacular/dns.rb
 - lib/cheftacular/encryptor.rb
+- lib/cheftacular/error.rb
 - lib/cheftacular/getter.rb
 - lib/cheftacular/helper.rb
 - lib/cheftacular/initializer.rb
@@ -255,9 +256,7 @@ files:
 - lib/cheftacular/stateless_actions/bootstrappers/redhat_bootstrap.rb
 - lib/cheftacular/stateless_actions/bootstrappers/ubuntu_bootstrap.rb
 - lib/cheftacular/stateless_actions/bootstrappers/vyatta_bootstrap.rb
-- lib/cheftacular/stateless_actions/check_cheftacular_settings.rb
 - lib/cheftacular/stateless_actions/chef_bootstrap.rb
-- lib/cheftacular/stateless_actions/chef_environment.rb
 - lib/cheftacular/stateless_actions/clean_cookbooks.rb
 - lib/cheftacular/stateless_actions/clean_sensu_plugins.rb
 - lib/cheftacular/stateless_actions/clean_server_passwords.rb
@@ -270,7 +269,7 @@ files:
 - lib/cheftacular/stateless_actions/create_git_key.rb
 - lib/cheftacular/stateless_actions/disk_report.rb
 - lib/cheftacular/stateless_actions/environment.rb
-- lib/cheftacular/stateless_actions/fetch_file.rb
+- lib/cheftacular/stateless_actions/file.rb
 - lib/cheftacular/stateless_actions/fix_known_hosts.rb
 - lib/cheftacular/stateless_actions/full_bootstrap.rb
 - lib/cheftacular/stateless_actions/get_active_ssh_connections.rb

data/lib/cheftacular/stateless_actions/check_cheftacular_settings.rb

@@ -1,14 +0,0 @@
-#interact with an rvm installation on servers
-class Cheftacular
-  class StatelessActionDocumentation
-    def check_cheftacular_settings
-      #TODO
-    end
-  end
-
-  class StatelessAction
-    def check_cheftacular_settings
-      raise "Not Yet Implemented"
-    end
-  end
-end

data/lib/cheftacular/stateless_actions/chef_environment.rb

@@ -1,21 +0,0 @@
-class Cheftacular
-  class StatelessActionDocumentation
-    def chef_environment
-      @config['documentation']['stateless_action'] <<  [
-        "[NYI]`cft chef_environment ENVIRONMENT_NAME [create|destroy]` will allow you to interact with chef environments on the chef server.",
-      
-        [
-          "    1.  `create` will create an environment if it does not exist.",
-
-          "    2.  `destroy` will destroy a chef environment *IF IT HAS NO NODES*"
-        ]
-      ]
-    end
-  end
-
-  class StatelessAction
-    def chef_environment
-      raise "Not yet Implemented"
-    end
-  end
-end

data/lib/cheftacular/stateless_actions/fetch_file.rb

@@ -1,24 +0,0 @@
-class Cheftacular
-  class StatelessActionDocumentation
-    def fetch_file
-      @config['documentation']['stateless_action'] <<  [
-        "[NYI]`cft fetch_file NODE_NAME LOCATION_ALIAS FILE_NAME` fetches a file from the remote node. ",
-
-        [
-          "    1. `LOCATION_ALIAS` will be parsed as a path if it has backslash characters. Otherwise it will be parsed from your " +
-          "location_aliases hash in your cheftacular.yml",
-
-          "    2. `FILE_NAME` is the actual name of the file to be fetched. If no value is passed or the file does not exist in the " +
-          "LOCATION_ALIAS, the command will return the entries in LOCATION_ALIAS"
-        ]
-      ]
-    end
-  end
-
-  class StatelessAction
-    def fetch_file out=[]
-      #TODO
-      raise "Not yet implemented"
-    end
-  end
-end