iSharkFly-Docs
/
packer-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #3459 from mitchellh/docs-windows-restart-timeout 

Docs for windows restart timeout
This commit is contained in:
Chris Bednarski 2016-04-20 12:36:08 -07:00
parent b92efe1262 90a12f7043
commit 66c3dabf2f
1 changed files with 14 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
website/source/docs/provisioners/windows-restart.html.md
View File

@ -1,7 +1,7 @@
---
description: |
The Windows restart provisioner restarts a Windows machine and waits for it to
come back up.
The Windows restart provisioner restarts a Windows machine and waits for it
to come back up.
layout: docs
page_title: Windows Restart Provisioner
...
@ -16,6 +16,10 @@ waits for the machine to come back online.
The Windows provisioning process often requires multiple reboots, and this
provisioner helps to ease that process.
Packer expects the machine to be ready to continue provisioning after it
reboots. Packer detects that the reboot has completed by making an RPC call
through the Windows Remote Management (WinRM) service, not by ACPI functions, so Windows must be completely booted in order to continue.
## Basic Example
The example below is fully functional.
@ -32,13 +36,15 @@ The reference of available configuration options is listed below.
Optional parameters:
- `restart_command` (string) - The command to execute to initiate the restart.
By default this is `shutdown /r /c "packer restart" /t 5 && net stop winrm`.
A key action of this is to stop WinRM so that Packer can detect it
is rebooting.
- `restart_command` (string) - The command to execute to initiate the
restart. By default this is `shutdown /r /c "packer restart" /t 5 && net
stop winrm`. A key action of this is to stop WinRM so that Packer can
detect it is rebooting.
- `restart_check_command` (string) - A command to execute to check if the
restart succeeded. This will be done in a loop.
- `restart_timeout` (string) - The timeout to wait for the restart. By default
this is 5 minutes. Example value: "5m"
- `restart_timeout` (string) - The timeout to wait for the restart. By
default this is 5 minutes. Example value: `5m`. If you are installing
updates or have a lot of startup services, you will probably need to
increase this duration.