summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn Keiser <john@johnkeiser.com>2015-05-28 13:10:43 -0700
committerJohn Keiser <john@johnkeiser.com>2015-05-28 13:27:44 -0700
commitcfb7b3e79a4092b705648e00bf5997fbd7014e93 (patch)
tree193375a0afeb1c4edca157138d5b19585628fa71
parent81eaaa29cc175420e0ed6013cd2772b8941b65e7 (diff)
downloadchef-cfb7b3e79a4092b705648e00bf5997fbd7014e93.tar.gz
Make audit comments nicer!
-rw-r--r--lib/chef/client.rb32
1 files changed, 23 insertions, 9 deletions
diff --git a/lib/chef/client.rb b/lib/chef/client.rb
index b63671bd59..51e78e60a9 100644
--- a/lib/chef/client.rb
+++ b/lib/chef/client.rb
@@ -187,6 +187,12 @@ class Chef
# 3. Retrieve the node (or create a new one).
# 4. Merge in json_attribs, Chef::Config.environment, and override_run_list.
#
+ # @see #run_ohai
+ # @see #load_node
+ # @see #build_node
+ # @see Chef::Config#lockfile
+ # @see Chef::RunLock#acquire
+ #
# Phase 2: Compile
# ----------------
# Decides *what* we plan to converge by compiling recipes.
@@ -199,6 +205,9 @@ class Chef
# 6. Load recipes in the run list.
# 7. Load recipes from the command line.
#
+ # @see #setup_run_context Syncs and compiles cookbooks.
+ # @see Chef::CookbookCompiler#compile
+ #
# Phase 3: Converge
# -----------------
# Brings the system up to date.
@@ -207,21 +216,26 @@ class Chef
# 2. Save the node.
# 3. Reboot if we were asked to.
#
+ # @see #converge_and_save
+ # @see Chef::Runner
+ #
+ # Phase 4: Audit
+ # --------------
+ # Runs 'control_group' audits in recipes. This entire section can be enabled or disabled with config.
+ #
+ # 1. 'control_group' DSL collects audits during Phase 2
+ # 2. Audits are run using RSpec
+ # 3. Errors are collected and reported using the formatters
+ #
+ # @see #run_audits
+ # @see Chef::Audit::Runner#run
+ #
# @raise [Chef::Exceptions::RunFailedWrappingError] If converge or audit failed.
#
- # @see Chef::Config#lockfile
# @see Chef::Config#enforce_path_sanity
# @see Chef::Config#solo
# @see Chef::Config#audit_mode
#
- # @see Chef::RunLock#acquire
- # @see #run_ohai
- # @see #load_node
- # @see #build_node
- # @see Chef::CookbookCompiler#compile
- #
- # @see #setup_run_context Syncs and compiles cookbooks.
- #
# @return Always returns true.
#
def run