update docs

This commit is contained in:
Megan Marsh 2018-07-18 09:42:15 -07:00
parent e146973d08
commit e8a7d948db
1 changed files with 25 additions and 11 deletions

View File

@ -61,6 +61,15 @@ Optional Parameters:
"ansible_env_vars": [ "ANSIBLE_HOST_KEY_CHECKING=False", "ANSIBLE_SSH_ARGS='-o ForwardAgent=yes -o ControlMaster=auto -o ControlPersist=60s'", "ANSIBLE_NOCOLOR=True" ] "ansible_env_vars": [ "ANSIBLE_HOST_KEY_CHECKING=False", "ANSIBLE_SSH_ARGS='-o ForwardAgent=yes -o ControlMaster=auto -o ControlPersist=60s'", "ANSIBLE_NOCOLOR=True" ]
} }
``` ```
If you are running a Windows build on AWS, Azure or Google Compute and would
like to access the auto-generated password that Packer uses to connect to a
Windows instance via WinRM, you can use the template variable
{{.WinRMPassword}} in this option.
For example:
```json
"ansible_env_vars": [ "WINRM_PASSWORD={{.WinRMPassword}}" ],
```
- `command` (string) - The command to invoke ansible. - `command` (string) - The command to invoke ansible.
Defaults to `ansible-playbook`. Defaults to `ansible-playbook`.
@ -72,12 +81,24 @@ Optional Parameters:
These arguments *will not* be passed through a shell and arguments should These arguments *will not* be passed through a shell and arguments should
not be quoted. Usage example: not be quoted. Usage example:
``` json ```json
{ {
"extra_arguments": [ "--extra-vars", "Region={{user `Region`}} Stage={{user `Stage`}}" ] "extra_arguments": [ "--extra-vars", "Region={{user `Region`}} Stage={{user `Stage`}}" ]
} }
``` ```
If you are running a Windows build on AWS, Azure or Google Compute and would
like to access the auto-generated password that Packer uses to connect to a
Windows instance via WinRM, you can use the template variable
{{.WinRMPassword}} in this option.
For example:
```json
"extra_arguments": [
"--extra-vars", "winrm_password={{ .WinRMPassword }}"
]
```
- `groups` (array of strings) - The groups into which the Ansible host - `groups` (array of strings) - The groups into which the Ansible host
should be placed. When unspecified, the host is not associated with any should be placed. When unspecified, the host is not associated with any
groups. groups.
@ -128,13 +149,6 @@ Optional Parameters:
- `user` (string) - The `ansible_user` to use. Defaults to the user running - `user` (string) - The `ansible_user` to use. Defaults to the user running
packer. packer.
- `set_winrm_passwd` (boolean) - Set to `true` if you are running on AWS, Azure or
Google Compute and would like to access the generated password that Packer uses to
connect to the instance via WinRM. The password will be avaliable to the Ansible
provisioner through the environment variable `GENERATED_WINRM_PASSWORD`. You will
also need to set `ansible_password` in your ansible playbook, for example,
`ansible_password: "{{ lookup('env','GENERATED_WINRM_PASSWORD') }}"`
## Default Extra Variables ## Default Extra Variables
In addition to being able to specify extra arguments using the In addition to being able to specify extra arguments using the
@ -153,7 +167,7 @@ commonly useful Ansible variables:
To debug underlying issues with Ansible, add `"-vvvv"` to `"extra_arguments"` to enable verbose logging. To debug underlying issues with Ansible, add `"-vvvv"` to `"extra_arguments"` to enable verbose logging.
``` json ```json
{ {
"extra_arguments": [ "-vvvv" ] "extra_arguments": [ "-vvvv" ]
} }
@ -174,7 +188,7 @@ Redhat / CentOS builds have been known to fail with the following error due to `
Building within a chroot (e.g. `amazon-chroot`) requires changing the Ansible connection to chroot. Building within a chroot (e.g. `amazon-chroot`) requires changing the Ansible connection to chroot.
``` json ```json
{ {
"builders": [ "builders": [
{ {