summaryrefslogtreecommitdiff
path: root/DOC_CHANGES.md
diff options
context:
space:
mode:
authorChris Doherty <cdoherty@ooyala.com>2014-09-16 15:55:38 -0700
committerChris Doherty <cdoherty@ooyala.com>2014-09-16 15:55:38 -0700
commiteed1067f66c876db938f696eef867d145e5a2dc0 (patch)
tree7c35f382343cf625b9a749a894fc056ee2c0cb6f /DOC_CHANGES.md
parentcb61daebfb0d255cae928ca1a92db29b055755cf (diff)
downloadchef-eed1067f66c876db938f696eef867d145e5a2dc0.tar.gz
Doc changes for the core reboot resource.
Diffstat (limited to 'DOC_CHANGES.md')
-rw-r--r--DOC_CHANGES.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/DOC_CHANGES.md b/DOC_CHANGES.md
index 8b70f40c5a..ad45e4c383 100644
--- a/DOC_CHANGES.md
+++ b/DOC_CHANGES.md
@@ -145,3 +145,30 @@ $ knife search node "platform:ubuntu" --filter-result "c_version:languages.c.gcc
$
```
+
+### Reboot resource in core
+The `reboot` resource will reboot the server, a necessary step in some installations, especially on Windows. If this resource is used with notifications, it must receive explicit `:immediate` notifications only: results of delayed notifications are undefined. Currently supported on Windows, Linux, and OS X; will work incidentally on some other Unixes.
+
+There are three actions:
+
+```ruby
+reboot "app_requires_reboot" do
+ action :request_reboot
+ reason "Need to reboot when the run completes successfully."
+ delay_mins 5
+end
+
+reboot "cancel_reboot_request" do
+ action :cancel
+ reason "Cancel a previous end-of-run reboot request."
+end
+
+reboot "now" do
+ action :reboot_now
+ reason "Cannot continue Chef run without a reboot."
+ delay_mins 2
+end
+
+# the `:immediate` is required for results to be defined.
+notifies :reboot_now, "reboot[now]", :immediate
+```